开发工作流

开发工作流程

0. 调研与复用 — （任何新实现前必须执行）

   • 进行搜索： 动手编写代码前，
     • 用 GitHub MCP 查找已有的实现、模板和模式，寻找能解决你 80% 以上需求的开源项目，考虑 fork、移植或直接包装使用。筛选时优先满足以下指标：GitHub Stars > 500 且最近 6 个月有提交；MIT / Apache-2.0 / BSD 优先
     • 去 npm、PyPI、crates.io 等注册表中搜索，优先选择经过实战检验的库，避免自己重复造轮子。筛选时优先满足以下质量指标：
       • npm 包周下载 > 10k 且有 TypeScript 类型
       • PyPI 包有 wheel 构建并兼容目标 Python 版本
       • crates.io 包总下载 > 100k 且近期无安全公告
     • 利用网络搜索进行更广泛的调研和探索。
   • 查阅库文档： 使用 Context7 或官方文档确认 API 行为、包的用法以及版本特定细节，然后再进行实现。

1. 先做计划

   • 在编码前生成规划文档：PRD、架构设计、系统设计、技术文档、任务列表
   • 识别依赖关系和风险

2. TDD 方式

   • 先写测试（红阶段）
   • 实现代码以通过测试（绿阶段）
   • 重构（改进阶段）
   • 验证测试覆盖率达到 80% 以上

3. 代码审查：这个应该有Human-in-the-loop

   • 处理严重（CRITICAL）和高优先级（HIGH）问题
   • 尽量修复中优先级（MEDIUM）问题

4. 提交与推送（到开发分支）

   • 提交信息要详细
   • 遵循约定式提交格式
   • 提交信息格式和 PR 流程参见 git-workflow.md

5. 推送PR（到主分支）

   • 验证所有自动化检查（CI/CD）均通过
   • 解决所有合并冲突
   • 确保分支与目标分支保持同步
   • 只有通过这些检查后，再请求审查