编程与工程
让 Agent 先读懂仓库再动手
接手陌生项目、或让 agent 第一次进入一个代码库时的开场提示词。
- Claude Code
- OpenAI Codex
- Cursor
完整模板
替换花括号中的占位符后使用
先不要改任何代码。请按下面顺序做一次仓库勘察，然后只输出结论：
1. 技术栈与运行方式：包管理器、框架版本、如何启动开发环境、如何跑测试。
2. 目录结构：列出主要目录及其职责，标出哪些是业务代码、哪些是生成物。
3. 关键约定：命名风格、状态管理方式、错误处理惯例、提交规范。
4. 风险点：明显的技术债、缺测试的模块、写死的配置。
输出用中文，控制在 300 字以内，每条给出对应的文件路径作为依据。
勘察完成后停下等我下一步指令。把模板用到一个具体问题上
填写示例与结果检查
以下为本站编写的示范，不是模型实测输出。
- 怎样填入真实材料
- 示例任务：接手一个订单管理项目。先找出启动命令、创建订单入口、数据库访问层和相关测试；只读，不修改文件。
- 怎样判断回答可用
- 解释应引用真实文件，并区分读到的配置与实际运行结果。项目没有测试时应明确说明，不能编造测试命令或架构。
- 不符合预期时怎么调整
- 如果输出只有通用架构图，缩小到“创建一笔订单经过哪些函数”，要求按调用顺序给出路径。
AI Codex · 更新 2026-10-02 · 内容方法
HOW TO USE
怎么使用这个提示词
- 01替换占位符把花括号里的示例换成你的真实目标、材料和约束。
- 02保留输出要求格式与验收条件能减少来回补充信息，不建议第一次就删掉。
- 03按结果微调一次只调整一个条件，便于判断哪项要求真正影响了结果。
相关标签
- 上手
- 代码理解
RELATED