跳转至

3.6 本地 Agent 任务模板

下面这些模板面向本地 Agent 的第一次稳定执行,可以直接用于 Claude CodeCodexOpenCode。根据工具差异微调 agent、模型、权限和命令即可。

如果你已经进入日常工作流,需要跨阶段的只读分析、diff review、文档同步和收尾提示,读 8.5 跨阶段提示词库

模板 1:只读分析

你现在在一个真实代码仓库里工作。

请先只读分析,不要修改文件。

目标:
<写清楚要完成什么>

请完成:
1. 阅读相关文件和现有类似实现。
2. 找出需要修改的文件范围。
3. 总结现有模式。
4. 列出风险和不确定点。
5. 给出验证命令。

等我确认后再开始修改。

模板 2:功能实现

目标:
<功能目标>

上下文入口:
- <路径 1>
- <路径 2>

约束:
- 不引入新依赖。
- 不修改公开 API。
- 不重构无关代码。

完成标准:
- <验收 1>
- <验收 2>
- 相关测试通过。

请先给计划,确认后再实现。

模板 3:Bug 修复

问题:
<现象>

复现步骤:
1. <步骤>
2. <步骤>

错误输出:
<粘贴日志或 stack trace>

要求:
1. 先定位可能根因,不要直接改。
2. 找到相关代码和测试。
3. 给出最小修复计划。
4. 修复后补回归测试。
5. 跑相关验证。

模板 4:重构

目标:
重构 <模块>,解决 <重复/复杂/性能/可维护性问题>。

边界:
- 不改变外部行为。
- 不改变公开接口。
- 不改无关文件。

要求:
1. 先分析当前结构。
2. 列出重构步骤。
3. 每步保持可运行。
4. 使用现有测试证明行为不变。
5. 如果缺测试,先补 characterization test。

模板 5:代码审查

请审查当前 git diff。

重点:
1. 是否有行为回归。
2. 是否有安全风险。
3. 是否缺测试。
4. 是否违反项目约定。
5. 是否有无关改动。

请只列真实风险,不要泛泛建议。
每条问题要给出文件、原因和建议修复方式。

模板 6:写回规范

请基于这次任务复盘:
1. 哪些问题是项目规则缺失导致的?
2. 哪些规则应该写入 AGENTS.md / CLAUDE.md / agent config?
3. 哪些流程适合做成 skill?
4. 哪些内容只是一次性经验,不需要固化?

请给出最小规则补丁,不要写长篇教程。

模板 7:多模型对照

请不要修改文件。现在只做第二意见审查。

输入:
- 当前任务目标:<目标>
- 当前 diff 或计划:<贴摘要或路径>

请重点检查:
1. 是否有更小的实现路径。
2. 是否遗漏边界情况。
3. 是否需要测试或文档。
4. 是否存在安全、性能或兼容性风险。
5. 哪些建议是必须修,哪些只是可选优化。

不要泛泛建议。每条建议必须能落到文件、行为或验证命令。