# Skills 模板包(3 个可直接复用的 SKILL.md)

> 一份开箱即用的 Agent Skills 模板集
> 来源:AI 进化知识库 · `/skills/` 章节
> 更新:2026-07

## 🎯 适用对象

- 想立刻动手做第一个 Skill 的 PM / 工程师
- 团队要建立 Skill 知识库的管理者
- 想给企业 AI Agent 沉淀专业流程的负责人

## 📦 模板 1:Code Review Skill(代码审查)

```markdown
---
name: code-review
description: 当用户提交 PR、要求代码审查、或问"这个改动能不能合"时使用。覆盖性能、安全、可读性 3 大维度,适合 Python / TypeScript / Go。
---

# Code Review

## 何时触发我
- 用户消息含"review"、"审查"、"看看这个 PR"、"能合吗"
- 用户粘贴了一段代码 + 问"有没有问题"
- 用户提供了 Git diff

## 我会做什么
按 P0 → P3 严重程度,逐项检查代码,并给出:
- 问题位置(file:line)
- 问题描述
- 修复建议 + 代码示例
- 严重度(P0 阻塞合入 / P1 强烈建议修复 / P2 建议优化 / P3 风格建议)

## 检查清单

### 1. 性能
- [ ] 没有 N+1 查询(数据库、API)
- [ ] 循环内没有 IO 操作
- [ ] 没有不必要的重复计算
- [ ] 大列表 / 大数据用了生成器
- [ ] 关键路径有 profiling 数据

### 2. 安全
- [ ] 没有 SQL 注入 / XSS / SSRF
- [ ] 用户输入有验证(zod / pydantic)
- [ ] 敏感字段没有日志
- [ ] 依赖没有已知 CVE
- [ ] 鉴权 / 授权逻辑正确

### 3. 可读性
- [ ] 函数 / 变量命名清晰
- [ ] 复杂逻辑有注释
- [ ] 错误处理不"吞"异常
- [ ] 测试覆盖关键路径

## 输出格式

```markdown
## Code Review 报告

### P0(必须修复,否则阻塞合入)
1. **[file.py:42]** SQL 注入风险
   ```python
   # 错误
   cursor.execute(f"SELECT * FROM users WHERE id = {user_id}")
   # 建议
   cursor.execute("SELECT * FROM users WHERE id = %s", (user_id,))
   ```

### P1(强烈建议)
- ...

### P2(建议)
- ...

### 总结
总评:⭐⭐⭐⭐ (4/5)
亮点:...
待改进:...
```

## 不要做的事
- 不要只说"这里不好"而不给修复方案
- 不要"过度工程化"建议(简单业务用不到微服务)
- 不要忽略"上下文"(团队规模、业务阶段、deadline)
```

## 📦 模板 2:Weekly Report Skill(周报生成)

```markdown
---
name: weekly-report
description: 当用户要求"写周报"、"整理本周工作"、"汇报给老板"时使用。适用于产品、运营、研发、市场等岗位。
---

# Weekly Report

## 何时触发我
- 用户消息含"周报"、"本周工作"、"汇报"
- 周末(周五下午)
- 用户粘贴了一周的工作记录 / 日程 / 邮件,要求"整理成周报"

## 输入
我会向用户询问:
1. 本周完成了什么?
2. 正在进行什么?
3. 遇到了什么卡点?
4. 下周计划做什么?
5. 需要老板支持什么?

## 输出结构

```markdown
# 周报 · [姓名] · [日期范围]

## 1. 本周完成(Results)
- ✅ [项目 X] 上线,带来 [数据] 提升
- ✅ [功能 Y] 完成开发,下周上线
- ✅ [问题 Z] 解决,影响 [范围] 客户

## 2. 进行中(In Progress)
- 🔄 [项目 A] 进度 60%,预计 [日期] 完成
- 🔄 [文档 B] 起草中

## 3. 卡点与风险(Blockers)
- ⛔ [卡点 1]:需要 [资源 / 决策],影响 [范围]
- ⚠️ [风险 1]:[描述] + [应对]

## 4. 下周计划(Next Week)
- [ ] 完成 [项目 A] 收尾
- [ ] 启动 [项目 C] 调研
- [ ] 跟 [团队] 对齐 [事项]

## 5. 数据指标(可选)
| 指标 | 本周 | 上周 | 变化 |
| --- | --- | --- | --- |
| 日活 | 10 万 | 9 万 | +11% |
```

## 写作原则
- **量化**:用数字代替形容词("提升 11%" 而不是 "显著提升")
- **聚焦结果**:少说"做了什么",多说"带来了什么"
- **诚实暴露问题**:不藏卡点,这是你争取资源的窗口
- **老板视角**:让老板读完知道 3 件事:进展、风险、需要他做什么
```

## 📦 模板 3:Customer Feedback Triage Skill(用户反馈分类)

```markdown
---
name: feedback-triage
description: 当用户提供用户反馈、NPS 调研、客服工单、App Store 评论时使用。自动分类 + 严重度评级 + 行动建议。
---

# Customer Feedback Triage

## 何时触发我
- 用户粘贴了一堆用户评论 / 反馈 / 调研结果
- 客服工单导出 CSV
- App Store / Google Play 评论截图

## 我会做什么
1. **去重合并**:把相同 / 相似的反馈归并
2. **分类**:Bug / 功能请求 / 使用咨询 / 投诉 / 表扬
3. **严重度评级**:
   - P0:影响核心功能,大量用户反馈
   - P1:影响部分功能,有明确复现
   - P2:小问题,影响体验但不阻塞
   - P3:建议 / 想法
4. **行动建议**:每条反馈给"该谁处理 + 优先级 + 是否公开回应"

## 输出格式

```markdown
# 反馈分析报告 · [日期]

## 概览
- 总反馈数:248
- 去重后:73 条独立问题
- 负面:42% / 中性:31% / 正面:27%

## 🔴 P0(本周必须处理)
### 1. 登录失败(占比 18%)
- **现象**:iOS 17 用户反馈"登录后白屏"
- **复现**:`[复现步骤]`
- **影响**:约 2 万用户
- **建议**:产品 + iOS 工程师 24h 内修复
- **公开回应**:是,App Store 置顶评论

## 🟡 P1(2 周内)
### 2. 导出 Excel 中文乱码(占比 5%)
...

## 🟢 P2(本月)
- ...

## 💡 高频功能请求 TOP 5
1. **暗黑模式**(38 次) — 投入产出比高
2. **批量操作**(24 次) — 需产品评估
...

## 总结
- 紧急修复:____ 项
- 体验优化:____ 项
- 战略机会:____ 项
```

## 不做的事
- 不直接发给客户(永远是内部参考)
- 不"自动回信"(涉及金钱 / 法律的反馈必须人工)
- 不忽略 1-2 次的反馈(有时候稀有声音最有价值)
```

## 🛠️ 怎么用这些模板?

1. **复制上面的代码块** → 保存为 `code-review/SKILL.md` / `weekly-report/SKILL.md` / `feedback-triage/SKILL.md`
2. **修改 frontmatter 的 `description`**:让它准确反映"什么时候用我"(这是触发关键)
3. **上传到支持 Skills 的平台**:Claude Desktop / Cursor / Windsurf / Cline / TRAE 都已支持
4. **测试触发**:用模板里写的触发词,看看 Skill 是否被自动加载

## 🎯 写好一个 Skill 的 3 个关键

1. **description 必须具体**:"当用户提交 PR 时" 比 "代码相关时" 好 10 倍。
2. **触发条件显式列出**:不要让模型猜。
3. **输出格式要固定**:Markdown 模板是稳定输出的关键。

## 🔗 相关资源

- Skills 完整解读:[`/skills/`](/skills/) - Agent Skills 专题
- 能力扩展选型:见本页《选型决策树 · Skills / MCP》
- Prompt 模板:[`/workflow/`](/workflow/) - AI 工作台