Skip to content

先研究再编码

用途

在动手写代码之前,先让 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 后再进入编码和规则转化阶段