/14 分钟
Skill 速查表:每个 Skill 干什么、产出什么
主线文档链、专项分支、协作沉淀三类技能速查
🧰 Skill 速查表:每个 Skill 干什么、产出什么
配合 主分享文档 使用。主线编号文档统一放
docs/requirements/{需求}/。
一句话总结:主线 Skill 负责产出编号文档,专项 Skill 负责解决具体问题,协作 Skill 负责让上下文不断线。
表内 20 个是与研发流水线直接相关的 Skill;会话清理、命令同步这类辅助技能没收录。
🛤️ 主线:编号文档链
| Skill | 作用 | 核心内容(概述) | 产出文档 | 这份文档干什么 |
|---|---|---|---|---|
grill-me |
需求质检员 | 按目标与范围、业务规则、数据与字段、接口与依赖、验收标准 5 个维度连续追问;只问不答,不替你做决定 | 01-requirements-analysis.md |
把边界、异常流程、待确认问题固化下来,作为方案输入 |
codebase-onboarding |
代码库透视眼 | 六步扫描:技术栈 → 模块架构 → 数据模型 → 业务域 → 外部依赖 → 风险点;每段交互确认后再往下 | 02-codebase-analysis.md |
让接手的人和 AI 用同一份事实,方案与评审都引用它 |
doc-tech-solution |
方案作者 | 依据需求和代码现状,输出范围、流程、数据模型、接口设计、任务拆分;标准型与多子需求聚合型两套模板 | 03-technical-solution.md |
编码前把“怎么做”定下来,任务拆分直接当实现清单 |
tech-solution-review |
方案审稿人(挑刺) | 六维度评审:需求覆盖、架构一致性、数据层设计、边界异常、过度设计、可回滚性;含“最小解拷问” | 04-solution-review.md |
编码前把坑挖出来;结论分通过 / 有条件通过 / 需重大修改,问题带 P0-P2 优先级 |
doc-implementation-log |
编码记录员 | 每个任务记改动文件、编译结果、未验证项、风险与下一步;编译完成、切任务、handoff 前更新 | 05-implementation-log.md |
交接和自测的事实来源,避免“改了但没编译”被当成已完成 |
code-review-skill-main |
工程质量审查 | 分层规范、性能、并发、SQL、安全、可维护性;顺带查 CLAUDE.md / AGENTS.md 合规 |
06-code-review.md |
上线前的工程质量清单:做好了没 |
code-review-skill-business |
业务逻辑审查 | 对照需求、方案、API 文档,验证实现逻辑、功能覆盖、接口契约 | 与上一项合并输出 | 上线前的业务正确性清单:做对了没 |
doc-self-test-checklist |
自测清单生成 | 按实际代码与真实数据,给出可复制入参、期望出参、业务断言,按业务顺序编排 | 07-self-test-checklist.md |
提测前的自测依据;生成清单 ≠ 已执行自测 |
doc-frontend-integration |
联调文档生成 | 字段、示例、错误码、前端调用顺序 | 08-frontend-integration.md |
给前端的对接依据,少一轮口头解释 |
doc-release-checklist |
发布清单生成 | SQL、配置、发布顺序、验证方法、回滚步骤 | 09-release-checklist.md |
给发布人员的操作清单,包含回滚 |
📌 编号 03 / 07 / 08 / 09 的文件名统一还在陆续调整:这四个 Skill 目前仍按
{文档名}-{需求简称}-{日期}.md输出。
🔀 专项分支:按问题类型加载
| Skill | 作用 | 核心内容(概述) | 产出物 | 产出物干什么 |
|---|---|---|---|---|
change-handler |
变更调度员 | 先问三个问题定级:L1 直接改、L2 按当前阶段做最小代价调整、L3 回退到 04 重新评审 | 变更日志(写进对话与交接) | 变更可追溯,既不推倒重来,也不硬扛不改 |
bug-hunter |
Bug 排查 | 日志分析 → 代码链路追踪 → 生成只读诊断 SQL → 你执行回传 → 循环收敛到根因 | 排查报告 + 诊断 SQL | 根因有证据链(日志 + 代码 + 数据),不靠猜 |
perf-sql-optimizer |
慢 SQL 诊断 | EXPLAIN 解读、索引失效检查、SQL 重写建议 | 优化方案 + 前后对比 | 加索引和改 SQL 都有依据 |
data-fix-gen |
数据修复方案 | 只读校验 SQL → 分批修复 → 回滚方案,三段缺一不可;确认影响范围后才给执行顺序 | 三件套 SQL | 刷数可校验、可回滚 |
api-integration |
三方对接分析 | 解析对方文档,做枚举 / 状态映射与字段对照,设计异常重试与幂等 | 映射表 + 联调清单 | 对接前把契约差异摊开,不靠“选个最接近的”蒙 |
unit-test-gen |
单测生成 | JUnit5 + Mockito,覆盖正常、边界、异常三分支 | 测试代码 | 关键逻辑有回归保护 |
markitdown |
资料入库 | PDF、Word、PPT、Excel、图片、录音、网页等转成结构清晰的 Markdown | Markdown 资料 | 让 AI 读得懂、检索得到你的原始资料 |
🤝 协作与沉淀
| Skill | 作用 | 核心内容(概述) | 产出物 | 产出物干什么 |
|---|---|---|---|---|
conv-handoff |
会话交接 | 整理目标、已完成、未完成、关键决策、踩过的坑、下一步,并生成 resume 提示词 | ~/.handoffs/{时间}-{任务}/HANDOFF.md |
换会话不丢上下文,接手方先核对再动手 |
cross-agent-sync |
跨 agent 同步 | 把当前上下文导出给另一个 agent 接续 | ~/.cross-agent/current.md |
Claude Code 与 Codex 接力干活 |
project-utils |
现有能力清单 | 项目工具类、注解、配置、Feign 清单 | 无(编码前查) | 先查现有能力,禁止重复造轮子 |