跳转到内容
AI 编程入门手册

不会写任务说明怎么办：让 Codex / Claude Code 先做只读摸底

新手学 Codex 或 Claude Code，不是为了和模型聊天，而是为了完成项目里的一个任务：改页面、修 bug、接接口、写测试、做一个能上线的小功能。

不会描述需求时，不要写“帮我做个产品”。先让 coding agent 做只读摸底。

第一句直接复制

Section titled “第一句直接复制”
你现在是我的 coding agent。请先只读当前项目，不要修改文件，不要运行会写入文件的命令。


我的目标：{一句话写你想完成的工作，例如：把首页按钮文案改清楚 / 给登录失败加错误提示 / 做一个公开 API 小工具}


请先输出：
1. 你会先读哪些文件或目录，为什么
2. 这个目标可能涉及的入口文件、组件、接口或配置
3. 今天能完成的最小交付版本
4. 不应该顺手改的范围
5. 需要我补充的阻塞信息
6. 完成后应该用什么方式验证

这段话的重点不是“聊天”，而是交代一个工作单。Codex 和 Claude Code 都适合先读仓库、建立上下文，再决定是否动手。

如果它开始闲聊或泛泛建议

Section titled “如果它开始闲聊或泛泛建议”

复制：

请不要给通用建议。请基于当前仓库，只输出和这个任务相关的文件、改动范围、风险和验证方式。

如果它要问问题

Section titled “如果它要问问题”

允许它问，但只问会影响开发的问题：

如果信息不足，请只问会阻塞实现的问题。
每个问题都要说明：为什么这个问题会影响文件选择、实现方式或验证方法。
不要问和当前任务无关的问题。

好问题长这样：

  • “这个按钮是只改首页，还是所有页面都要统一？”
  • “失败提示应该只显示文字，还是还要记录日志？”
  • “这个功能完成后用浏览器手动验收，还是已有测试命令？”

坏问题长这样：

  • “你喜欢什么风格？”
  • “你希望产品面向什么人群？”
  • “你想做一个什么样的应用？”

这些问题太宽，容易把开发任务带回聊天。

让 agent 整理任务卡

Section titled “让 agent 整理任务卡”

只读摸底后，再复制：

请把这个任务整理成一张开发任务卡。


格式：
1. 任务目标
2. 最小交付版本
3. 会修改的文件候选
4. 明确不改的范围
5. 风险点
6. 验证方法
7. 如果进入实现，第一步应该做什么


先不要改文件。

进入实现前的确认句

Section titled “进入实现前的确认句”
请按任务卡执行，只做最小交付版本。
改动前先列出最终会修改的文件。
改完后运行或说明验证方法，并总结实际改动。

如果是 Codex，可以优先用 Plan mode 或让它先计划；如果是 Claude Code，可以用 plan mode 先 Explore、Plan，再 Implement。

成功标志

Section titled “成功标志”
  • agent 能指出具体文件、目录或入口，而不是只说“检查代码”。
  • 最小交付版本能在今天完成。
  • 它知道哪些范围不改。
  • 它给了验证方法，比如打开哪个页面、运行哪个测试、看哪段输出。
  • 你能把这张任务卡继续交给 Codex 或 Claude Code 执行。

看到这些就叫停

Section titled “看到这些就叫停”
  • 它没有读项目，就开始写完整方案。
  • 它把一个小功能扩成登录、后台、数据库、支付、部署。
  • 它要你提供 Token、cookie、私钥、生产环境 .env。
  • 它准备改很多无关文件。
  • 它没有说明验证方式。

叫停句：

先停。请回到当前仓库和我的原始目标，只保留今天能交付的最小版本。

来源与日期

Section titled “来源与日期”