开发流程五步法：如何让 best-skills 自动识别需求、设计、实现、审查与 Bug 修复

【免费下载链接】best-skills通用高质量 Skills 合集🔥项目地址: https://gitcode.com/gh_mirrors/be/best-skills

best-skills 是一个通用高质量 Agent Skills 合集，可安装到 Cursor、Claude Code、Codex 等 AI 编程工具中。其中的dev-workflow技能实现了开发流程五步法：AI 会根据你的一句自然语言，自动识别当前处于「需求理解 → 方案设计 → 代码实现 → 代码审查 → Bug 修复」的哪一步，并按该阶段的标准流程执行、输出交付物。你不需要手动切换模式，说人话即可。

一键安装：3 步把五步法装进你的 AI 工具

1. 克隆仓库（只读使用即可）：

git clone https://gitcode.com/gh_mirrors/be/best-skills

2. 把skills/dev-workflow/文件夹复制到对应工具的 skills 目录：

3. 重启工具，对 AI 说一句「帮我整理需求」，即可触发第一步。

技能的入口文件是 SKILL.md，它声明了触发关键词与五步路由规则；每一步的完整流程都写在 reference/ 目录下的对应文件中。

触发机制：AI 如何知道你现在该走哪一步

五步法的核心是关键词自动路由：Agent 读取SKILL.md中的description与触发词表，匹配你的表述后加载对应的 reference 文件执行。

每步完成后，AI 会主动提示你进入下一阶段；若上游步骤缺失，它会提醒你先补齐前置内容，而不是跳步乱写。

第一步 需求理解：把模糊想法变成结构化需求文档

说「我要做个登录功能」，AI 不会直接写代码，而是先执行 requirement.md 中的流程：

• 信息收集：核心目标、使用场景、输入输出、约束条件，缺什么主动追问
• 需求拆解：功能点按 P0（必须）/ P1（重要）/ P2（可选）标注优先级，并明确「不做什么」
• 验收标准：每个核心功能用「Given-When-Then」格式写出可测试的标准
• 自动落盘：最终文档写入docs/<feature>/01-需求理解.md

这一步只聚焦「做什么」而非「怎么做」，保证需求文档连非技术人员也能看懂。

第二步 方案设计：从需求到技术方案的快速路径

design.md 定义了从需求文档到技术方案的完整链路：

1. 技术选型：优先复用项目现有技术栈，每项选择都给出理由
2. 架构设计：按表现层 / 业务层 / 数据层分层，划分模块边界，权衡关键设计点（如同步 vs 异步）
3. 接口设计：用统一模板定义请求路径、参数、响应格式与错误码
4. 数据模型：输出表结构或核心类定义
5. 自动落盘：写入docs/<feature>/02-方案设计.md，与需求文档归入同一功能子目录

以「实现用户登录模块」为例，方案设计阶段的典型交付物就是一张接口时序图——客户端、网关、认证服务、数据库之间的调用契约一目了然：

架构复杂时，方案中还可附一张架构示意图（伪架构图即可），比如用手绘风格快速勾勒模块与数据流向：

第三步 代码实现：让 AI 按规范写码，自测后再交付

implementation.md 把编码过程拆成 7 步，避免 AI「一口气乱写」：

• 任务拆分：按模块拆成可独立完成的子任务，先核心后辅助、先底层后上层，并输出「实现清单」供你确认
• 逐模块实现：遵循项目已有代码风格，单一职责、适度注释、对外部输入做校验
• 分层落地：数据层（CRUD/事务）→ 业务层（核心逻辑）→ 接口层（路由/参数校验）
• 自测验证：语法检查、核心路径走通、边界输入处理，通过后才交付
• 交接提示：明确「代码已实现完成，可使用代码审查进行质量检查」

大改动分批输出，每批完成后等你确认，发现方案有问题会及时反馈而不是硬着头皮写完。

第四步 代码审查：五维检查 + 三级问题分级

review.md 内置了一套接近团队规范的审查流程：

• 预检门禁：先跑 lint / typecheck / test / build，预检失败直接记为阻断项
• 五维审查：正确性、安全性、性能与资源、可维护性、测试充分性
• 三级分级：🔴 严重（必须修复，结论强制Request Changes）、🟡 建议（本轮修复或说明延期理由）、🟢 优化（可后续迭代）
• 结构化报告：按「问题位置 → 风险 → 修复建议」逐条输出，最后给出结论与下一步行动

它不挑刺，目标是降低风险、提升可维护性，且区分「必须修改」与「偏好建议」。深度检查可按语言加载专项指南，如 typescript.md、python.md、go.md、java.md、rust.md；快速首筛可用 review-checklist.md。

第五步 Bug 修复：解决即停，失败自动回滚

bug-fix.md 是五步法中最「自动化」的一环，贴一段报错堆栈即可触发：

1. 复现与定位：确认完整报错、复现步骤、环境信息，信息不足先提问，不盲目猜测
2. 方案排序：一次性列出所有修复方案，按「无副作用小改动 → 局部逻辑 → 架构变更 → 大范围重构」降序排列
3. 依次尝试：每次只执行一个方案，验证（跑测试 / 复现步骤 / lint）成功即停止；失败则回滚，保持代码干净后再试下一个
4. 结果报告：输出根本原因、采用方案、修改文件、验证方式

关键纪律：每次只改一个方案、失败必须回滚、不顺手重构无关代码，全部失败时诚实告知并说明还缺哪些信息。

交付物管理：docs/ 自动落盘与版本归档

五步法的产出不是「聊完就丢」，而是有清晰的落盘规则（见 SKILL.md）：

同一功能的所有文档归入同一子目录（无法识别功能时写入docs/通用/）；再次写入时旧版自动归档到archive/，主文件永远是最新完整版并带修订记录——相当于给项目文档做版本管理。

总结：用五句话启动一个完整开发流程

开发流程五步法把「需求 → 方案 → 实现 → 审查 → 修复」整条链路固化成 AI 可自动路由的标准流程：说一句话即可进入正确阶段，交付物自动落盘可追溯。新手用它不会漏步骤，老手用它省去维护流程规范的成本，是 best-skills 中上手成本最低、收益最直接的技能之一。

【免费下载链接】best-skills通用高质量 Skills 合集🔥项目地址: https://gitcode.com/gh_mirrors/be/best-skills