项目学习

项目学习的提示词

Now I have enough material. Let me synthesize the key findings.


Coding Agent 项目上手 & 快速学习 — 精选强提示词手册


一、快速理解项目(Explorer 模式)

场景 提示词
全局概览 请给我这个代码库的整体概览
架构模式 请解释主要的架构模式
核心数据模型 这个项目的关键数据模型有哪些?
技术栈 这个项目使用了哪些技术栈和框架?
入口流程 请从入口点追踪请求流程
术语表 请给我一份项目专用术语表

二、定位代码(Finder 模式)

场景 提示词
找功能文件 找到处理[用户认证 / 支付 / ...]的文件
理解交互 这些文件是如何协同工作的?
端到端追踪 追踪[登录]流程,从前端一直到数据库
找特定用法 找到[functionName]的所有用法

三、规划优先(Explorer → Planner → Coder)

这是 最关键的模式——先研究再写代码,效果远超直接让 agent 写:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
1. 先探索:
   先阅读这些文件:[file1, file2, file3]。先不要写代码。

2. 用 "think" 系列触发深度思考:
   深入思考实现[X]的最佳方案
   更深入地思考边界情况    ← 更深思考预算
   ultrathink                       ← 最大思考预算

3. 出方案:
   为实现[feature]制定一个计划,并写下来。

4. 再编码:
   现在按计划开始实现

四、TDD 工作流(写测试 → 写代码)

1
2
3
4
5
先为[feature]编写测试。先不要实现功能。
运行测试,并确认它们会失败。
提交这些测试。
现在实现代码以通过所有测试。不要修改测试。
持续迭代直到全部通过。

五、修 Bug

1
2
我在运行[command]时看到错误:[粘贴错误信息]
请找到根因并修复它
1
请给出几种修复[file]中[具体问题]的方法

六、重构

1
请找出我们代码库中已弃用 API 的使用位置
1
在保持行为一致的前提下,将[file]重构为使用[现代模式]

七、代码审查 & PR

1
2
3
总结我所做的改动
创建一个 PR
审查我最近的改动是否存在安全问题

八、“懒人一键"组合技

如果你想一步到位(牺牲一点质量换速度):

1
查看[file]中[现有功能]的实现方式。按相同模式实现[新功能]。
1
修复这个项目中的所有 lint 错误
1
为[module]补充测试。运行测试并修复失败项。

核心原则总结

  1. 先读后写 — 始终让 agent 先探索/理解,再动手。直接说 “don’t write code yet” 是关键魔法词
  2. think 触发器think / think harder / ultrathink 能按档位分配思考预算,复杂问题务必用
  3. 给参考 — 指定一个已有实现当范例(“follow the pattern in X”),agent 产出质量大幅提升
  4. 小步迭代 — 拆成 “探索 → 方案 → 实现 → 测试 → 提交”,每步验证,不要一次甩整个需求
  5. TDD 友好 — coding agent 在有明确目标(测试用例/视觉 mock)时表现最强
  6. CLAUDE.md / AGENTS.md — 项目级"记忆文件”,记录常用命令、代码风格、架构说明,agent 启动时自动加载

需要我帮你针对某个具体场景(比如你正在做的项目)定制一套提示词组合吗?