日志分析与项目管理类 Skills

这一节提供三个覆盖日常工程效率场景的 Skill：错误日志快速分析、代码库新成员导览、以及贯穿全书的学习总结。

Skill 5：/analyze-logs — 错误日志智能摘要

场景：生产报警触发后，快速从大量日志中提取关键错误信息，生成可操作的摘要。

文件：.claude/skills/analysis/analyze-logs.md

---
description: 分析日志文件，提取错误模式并生成可操作的摘要报告
allowed-tools: Bash, Read, Grep
---
# 日志错误分析
## 目标
从指定的日志文件或最近的日志输出中，快速提取错误和异常，
按严重性和出现频率排序，生成可操作的摘要，帮助快速定位问题根源。
## 参数说明（来自 $ARGUMENTS）
| 参数 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `--file` | 否 | 自动查找 | 日志文件路径 |
| `--lines` | 否 | `500` | 分析最近 N 行 |
| `--level` | 否 | `error` | 最低日志级别：`error`/`warn`/`info` |
| `--since` | 否 | — | 只分析此时间之后的日志，格式：`2024-01-15 10:00` |
**调用示例**：

/analyze-logs /analyze-logs --file logs/app.log --lines 1000 /analyze-logs --level warn --since "2024-01-15 09:00"

## 执行步骤
### 步骤 1：确定日志来源
1. 如果提供了 `--file`，验证文件存在并可读
2. 如果未提供 `--file`，自动查找日志文件：
- 检查常见位置：`logs/app.log`、`logs/error.log`、`./app.log`、`/var/log/app/*.log`
- 用 Glob 查找 `**/*.log`（排除 `node_modules`）
- 如果找到多个，提示用户用 `--file` 指定，并列出找到的文件
- 如果只找到一个，使用该文件
### 步骤 2：提取日志内容
3. 使用 Bash 工具获取目标日志内容：
如果有 `--since`：
```bash
grep -A 0 "{since}" {file} | tail -{lines}
# 或针对结构化日志
awk '/"{since}"/{flag=1} flag' {file} | tail -{lines}
```
否则：
```bash
tail -{lines} {file}
```
### 步骤 3：提取错误模式
4. 使用 Grep 工具提取不同级别的日志行：
- `ERROR|FATAL|CRITICAL`（严重错误）
- `WARN|WARNING`（警告，如 --level 为 warn 时包括）
5. 识别重复出现的错误模式：
- 相同的错误消息出现多次，合并计数
- 提取错误中的关键词（异常类型、文件路径、HTTP 状态码）
6. 识别错误发生的时间分布：
- 是否在特定时间段集中出现（可能是定时任务或特定事件触发）
- 是否持续发生还是已经停止
### 步骤 4：生成分析报告
## 输出格式

日志分析报告

日志来源：{file} 分析范围：最近 {lines} 行 / {since} 之后 分析时间：[时间]

错误统计

🔴 需要立即关注

[最高频/最严重的错误]（N 次）

[典型的错误日志行]

可能原因：[分析] 建议排查：[具体操作]

🟡 需要跟进的警告

• [警告类型] (N 次)：[简要说明]

时间分布

[错误是否集中在某个时段？与特定时间/事件的关联？]

建议下一步

1. [最优先的排查行动]
2. [第二步]
3. [第三步]

Skill 6：/codebase-tour — 代码库导览（新成员入职）

场景：新成员加入团队或接手新项目时，快速生成代码库的结构导览和关键文件说明。

文件：.claude/skills/onboarding/codebase-tour.md

---
description: 为新成员生成当前代码库的结构导览和关键模块说明
allowed-tools: Glob, Read, Bash
---
# 代码库导览
## 目标
自动分析当前代码库的结构，生成一份适合新成员阅读的导览文档，
包括：目录结构、核心模块、技术栈、关键文件、本地运行方法。
## 参数说明（来自 $ARGUMENTS）
- `--focus`（可选）：关注特定层（`frontend` / `backend` / `infra` / `all`），默认 `all`
## 执行步骤
1. 获取项目基本信息：
- 读取 `package.json`（如果存在）获取项目名、依赖、脚本
- 读取 `README.md`（如果存在）提取已有文档
- 运行 `git log --oneline -5` 了解最近活跃情况
2. 分析目录结构：
- 使用 Glob 获取顶层目录列表（不超过两层深度）
- 读取关键目录（src/, app/, lib/, api/, components/ 等）的内容
3. 识别技术栈：
- 从 package.json 的依赖中识别主要框架（React、Express、Next.js 等）
- 检查是否有 Dockerfile、docker-compose.yml、.github/workflows/
- 检查数据库配置文件
4. 找到关键文件：
- 入口文件（index.ts、main.py、app.js 等）
- 配置文件（webpack.config.js、tsconfig.json 等）
- 测试配置
5. 生成导览文档
## 输出格式

代码库导览：{项目名}

生成时间：[时间] 最近活跃：[最近 commit 日期和作者]

技术栈

目录结构

{项目}/
├── src/
│   ├── api/          — REST API 路由和控制器
│   ├── services/     — 业务逻辑层
│   ├── models/       — 数据库模型
│   └── utils/        — 工具函数
├── tests/            — 单元测试和集成测试
├── db/
│   └── migrations/   — 数据库迁移脚本
└── docs/             — 文档

关键文件

本地运行

# 安装依赖
npm install
# 启动开发服务器
npm run dev
# 运行测试
npm test
# 数据库迁移
npm run db:migrate

推荐入手点

新成员建议按以下顺序熟悉代码库： 1. README.md → 了解项目背景 2. src/api/routes.ts → 理解 API 接口 3. src/models/ → 了解数据结构 4. tests/ → 通过测试理解业务逻辑

本书总结：构建你的 Skills 体系

至此，你已经完成了 Claude Skills 开发的完整学习路径：

第 01 章  理解 Skills 的定位和核心概念
↓
第 02 章  创建第一个能运行的 Skill
↓
第 03 章  参数化设计，让 Skill 适应不同场景
↓
第 04 章  多步工作流，串联工具调用
↓
第 05 章  权限配置，建立安全边界
↓
第 06 章  测试调试，保障 Skill 质量
↓
第 07 章  团队库管理，把 Skill 变成共享资产
↓
第 08 章  真实案例，直接可用的参考实现

你的下一步行动：

今天（30 分钟内）：
☐ 创建 .claude/skills/ 目录
☐ 复制一个本章的 Skill 文件
☐ 在 Claude Code 中运行并验证
本周：
☐ 识别你最高频重复的 3 个工作流
☐ 为其中 1 个创建自定义 Skill
☐ 获取团队成员反馈
本月：
☐ 建立团队 Skills 库，3–5 个稳定 Skill
☐ 建立 PR 审查流程（修改 Skill 需要同行评审）
☐ 设置每月回顾：哪些 Skill 最常用？哪些需要改进？

Skills 开发的核心原则回顾：

1. 从频率出发：只封装频繁重复的操作，不要为了封装而封装
2. 最小权限：allowed-tools 只声明必要的工具
3. 明确失败：每个错误场景都有清晰的提示
4. 格式稳定：输出格式要有足够的约束，保证结构一致性
5. 版本管理：Skills 和代码一样，需要 PR 审查和 CHANGELOG

本节记录清单

• [ ] 复制 /analyze-logs Skill 并根据你的日志格式调整提取模式
• [ ] 复制 /codebase-tour Skill，在新项目中运行验证准确性
• [ ] 回顾全书，制定你的个人 Skills 建设路线图（从哪个 Skill 开始？）

相关阅读推荐： - MCP 实战指南 — Skills 能调用的工具层：如何配置和使用 MCP 服务器 - AI Agent 实战指南 — 从单 Skill 升级到多节点 Agent 编排 - IaC 实战指南 — 用基础设施即代码管理 Skills 的分发和版本控制