开发工作流程
-
调研与复用 — （任何新实现前必须执行）
- 进行搜索： 动手编写代码前，
- 用 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 行为、包的用法以及版本特定细节，然后再进行实现。
- 进行搜索： 动手编写代码前，
-
先做计划
- 在编码前生成规划文档：PRD、架构设计、系统设计、技术文档、任务列表
- 识别依赖关系和风险
-
TDD 方式
- 先写测试（红阶段）
- 实现代码以通过测试（绿阶段）
- 重构（改进阶段）
- 验证测试覆盖率达到 80% 以上
-
代码审查：这个应该有Human-in-the-loop
- 处理严重（CRITICAL）和高优先级（HIGH）问题
- 尽量修复中优先级（MEDIUM）问题
-
提交与推送（到开发分支）
- 提交信息要详细
- 遵循约定式提交格式
- 提交信息格式和 PR 流程参见 git-workflow.md
-
推送PR（到主分支）
- 验证所有自动化检查（CI/CD）均通过
- 解决所有合并冲突
- 确保分支与目标分支保持同步
- 只有通过这些检查后，再请求审查