# 开发工作流程

> 本文档在 [common/git-workflow.md](git-workflow.md) 的基础上进行了扩展，涵盖了在 git 操作之前发生的完整功能开发过程。

功能实现工作流描述了开发流水线：研究、规划、TDD、代码审查，然后提交到 git。

## 功能实现工作流程

0. **研究与复用** *(任何新实现之前强制进行)*
   * **首先进行 GitHub 代码搜索：** 在编写任何新内容之前，运行 `gh search repos` 和 `gh search code` 以查找现有的实现、模板和模式。
   * **使用 Exa MCP 进行研究：** 在规划阶段使用 `exa-web-search` MCP 进行更广泛的研究、数据摄取和发现现有技术。
   * **检查包注册表：** 在编写工具代码之前，搜索 npm、PyPI、crates.io 和其他注册表。优先选择经过实战检验的库，而不是自己编写的解决方案。
   * **搜索可适配的实现：** 寻找能够解决 80% 以上问题并且可以分叉、移植或包装的开源项目。
   * 当满足要求时，优先采用或移植经过验证的方法，而不是编写全新的代码。

1. **先规划**
   * 使用 **planner** 代理创建实施计划
   * 在编码前生成规划文档：PRD、架构、系统设计、技术文档、任务列表
   * 识别依赖项和风险
   * 分解为多个阶段

2. **TDD 方法**
   * 使用 **tdd-guide** 代理
   * 先写测试 (RED)
   * 实现以通过测试 (GREEN)
   * 重构 (IMPROVE)
   * 验证 80%+ 的覆盖率

3. **代码审查**
   * 编写代码后立即使用 **code-reviewer** 代理
   * 处理 CRITICAL 和 HIGH 级别的问题
   * 尽可能修复 MEDIUM 级别的问题

4. **提交与推送**
   * 详细的提交信息
   * 遵循约定式提交格式
   * 关于提交信息格式和 PR 流程，请参阅 [git-workflow.md](git-workflow.md)