先研究再编码
用途
在动手写代码之前,先让 AI 进行系统性技术调研,输出结构化研究文档,再以此为依据指导后续的架构设计和编码实现。适用于启动新项目、引入新技术栈、或进入陌生领域时的前期准备。
提示词模板
第一步:技术调研
用于项目启动前的系统性研究,输出为可归档的调研文档。
markdown
我要做一个 {{项目描述}}。请帮我:
1. 梳理这类产品的行业标准协议
2. 列出主流开源项目的架构特点
3. 总结最佳实践 + 结论摘要 + 对我们项目的建议 + 参考链接
4. 输出为 docs/research.md第二步:基于调研编码
在编码阶段引用调研文档,确保决策有据可依。
markdown
参考 docs/research.md 中的调研结论,帮我设计 {{模块名称}} 的架构第三步:结论转化为规则
将调研结论固化为团队/项目可持续遵循的规范文档。
markdown
请根据 docs/research.md 的调研结论,将关键决策转化为以下文档:
- **API 设计规范** → 写入 `CLAUDE.md`(作为 AI 编码时必须遵循的规则)
- **技术选型决策** → 写成 ADR(Architecture Decision Record)
- **竞品功能对标** → 写成 references.md使用技巧
- 第一步的
越具体越好,包含业务场景、用户规模、技术偏好等约束条件 - 调研文档建议用 Git 管控,方便回溯当初的决策依据
- ADR 推荐遵循 Michael Nygard 的模板:标题、状态、上下文、决策、后果
- 这三步不必一次完成,可以先做调研,review 后再进入编码和规则转化阶段