Coding Agent 第一小时：完成一个可交付的小任务

第一小时不要练“聊天技巧”。直接练一个真实工作流：让 Codex 或 Claude Code 读项目、定范围、改一处、验证结果。

0-10 分钟：选一个能交付的小任务

适合第一小时的任务：

• 改一个页面标题、按钮文案或错误提示。
• 给一个已有页面加一个空状态。
• 修一个能稳定复现的小报错。
• 给一个小函数补一个测试。

不适合第一小时的任务：

• 做完整产品。
• 接支付、登录、数据库、云服务。
• 重构整个项目。
• 修一个没有复现步骤的线上问题。

可以 1:1 复刻的样板任务

如果你手上没有项目，先用 TodoMVC 这类练习仓库。不要急着提交 PR，只在本地或自己的 fork 里练。

样板任务：在一个 TodoMVC 示例里，用户输入空白 Todo 并按回车时，不新增空 Todo，而是在输入框附近显示一句轻量提醒。

为什么这个任务适合第一小时：

• 它有清楚的用户动作：输入空白内容，按回车。
• 它有清楚的错误结果：不应该出现空 Todo。
• 它通常只影响新增 Todo 的输入逻辑和一个提示文案。
• 它不需要账号、数据库、支付、云服务。

给 agent 的目标可以这样写：

目标：在 TodoMVC 的一个示例里，给空白 Todo 输入增加轻量提醒。

验收：
1. 输入空白内容按回车，不新增 Todo
2. 页面显示一句提醒，例如“请输入待办内容”
3. 输入正常内容后，仍然可以新增 Todo
4. 删除、勾选、筛选功能不能被顺手改坏

如果你不是用 TodoMVC，把上面的目标替换成你自己的小任务，但保留“用户动作、预期结果、不能改坏的旧行为”这三项。

复制给 agent：

你是我的 coding agent。今天只做 1 小时内能完成的小交付。

目标：{写一个非常小的目标}

请先只读项目，不要改文件。输出：
1. 这个任务是否适合 1 小时完成
2. 最小交付版本是什么
3. 可能涉及哪些文件
4. 哪些范围今天不碰
5. 完成后怎么验证

10-25 分钟：只读摸底

请进入只读摸底阶段。

要求：
1. 先读 README、包管理配置、页面入口或相关目录
2. 不修改文件
3. 不运行写入命令
4. 输出相关文件清单和理由
5. 给出最小实现计划

成功标志：agent 能列出具体文件，比如 src/pages/index.tsx、src/components/Button.tsx、package.json，而不是只给通用建议。

一个合格的只读输出应该接近这样：

我会先看：
1. examples/react/package.json：确认启动和测试命令
2. examples/react/src/main.jsx：确认应用入口
3. examples/react/src/App.jsx 或 Todo 相关组件：定位新增 Todo 的输入处理

最小交付：
- 只处理空白输入提醒
- 不重写 TodoMVC
- 不改依赖
- 默认最多改 1-2 个文件

验证：
- 空白输入按回车不会新增
- 非空输入仍能新增
- 原有删除、勾选、筛选功能不变

如果它只说“我会检查代码并优化逻辑”，没有文件名、没有不改范围、没有验证动作，就是空话。

25-40 分钟：最小实现

确认计划后再让它动手：

按刚才的计划执行，只做最小交付版本。

约束：
1. 最多改 1-3 个文件
2. 不重构
3. 不新增生产依赖
4. 不处理无关问题
5. 改完后说明实际改了什么

如果它准备改太多文件，叫停：

范围太大。请收窄到今天能交付的最小版本，最多改 1-3 个文件。

40-50 分钟：验证

让 agent 先找项目自己的验证方式：

请根据项目文件判断应该如何验证这次改动。

优先级：
1. 项目已有测试命令
2. 项目已有 lint 或 typecheck
3. 本地启动后手动验收路径
4. 如果都没有，请给人工验收清单

不要编造不存在的命令。

如果项目是 Git 仓库，你可以检查改动范围：

git diff --stat

成功标志：你知道改了哪些文件、怎么验证、验证结果是什么。

看 diff 时只看 4 件事

新手第一次看 diff 不需要理解每一行。先看这 4 件事：

1. 文件数量是否在计划内：第一小时通常 1-3 个文件。
2. 是否改了无关文件：比如格式化了全项目、升级了依赖、改了锁文件。
3. 是否保留旧行为：正常新增 Todo、删除、勾选、筛选有没有被动到。
4. 是否有验证记录：运行了什么，没运行什么，人工怎么验收。

如果 diff 里出现大量你没要求的改动，先不要继续让它修，直接叫停：

先停。请根据当前 diff 做一次范围审查，只保留和“空白 Todo 输入提醒”直接相关的最小改动，列出哪些改动应该撤回。

50-60 分钟：交付说明

请生成这次小交付的说明。

格式：
1. 完成了什么
2. 实际改了哪些文件
3. 没有改哪些范围
4. 如何验证
5. 剩余风险
6. 下一步可以做什么

这就是把 coding agent 用在产品和项目上的基本闭环：任务、计划、实现、验证、交付。

交付记录模板

完成后，把结果记成这 6 行，方便你下次复盘：

任务：给空白 Todo 输入加轻量提醒
实际修改：
- {文件 1}：{改了什么}
- {文件 2}：{改了什么}
已验证：空白输入、正常新增、删除、勾选、筛选
未验证：{如果没有跑测试或没有启动项目，写清楚}
风险：{例如只在一个浏览器手动看过}
下一步：把这个流程换到自己的项目里做一次

今天不要做

• 不要把密钥、Token、cookie、生产 .env 贴给 agent。
• 不要让 agent 直接连接真实支付、数据库或云资源。
• 不要让它同时做多个功能。
• 不要只看“它说完成了”，一定看 diff 和验证结果。

来源与日期

• 来源：Codex Best Practices、Codex CLI Features、Claude Code Product、Claude Code Common Workflows、Claude Code Best Practices。
• 分享日期：2026-06-16。
• 复测日期：2026-06-16。