implement-plan

实施计划

移交

在 herdr 中（HERDR_ENV=1），除非你是实施者，或已被要求在此处实施（参见 orchestrate-agents），否则将计划移交给新的 Agent：

1. 创建一个工作树（参见 use-worktrees）。如果计划和 ADR 尚未提交，请将它们复制到工作树中。
2. 在当前 herdr 工作区中打开一个新窗格，标记为你的工作者（参见 use-worktrees），并在其中启动一个与你类型相同的 Agent。绝不要为此创建新的工作区或标签页。提供计划路径、计划中缺少的上下文，以及以下指示：“你是实施者。在此检出中使用 implement-plan；不要移交。”
3. 只有在它受阻或提出问题时才介入。
4. 当它报告所有任务均已实施并验证后，以相同方式启动审查者，在同一工作树中为其创建独立的带标签窗格。告诉它计划路径、实施者的窗格，以及以下指示：“你是审查者。按照 implement-plan 的审查轮次进行，并直接与实施者解决审查发现。不要编辑文件。”
5. 审查问题解决后，退出审查者并关闭其窗格。将尚未解决的分歧提交给用户。
6. 当实施者报告其 PR 后，检查分支是否已完整推送，退出 Agent，关闭其窗格，移除工作树（参见 use-worktrees），并报告 PR。

否则，自行实施。

实施

1. 阅读计划及其 ADR。如果有不清楚或看起来不妥的地方，先提问再着手实施。
2. 按顺序完成各项任务。用最简单的方式满足每项任务，不要为不可能发生的情况添加额外层次、选项或防御性代码。
3. 将复杂或可并行的任务交给子 Agent。
4. 仅在能保护重要行为时添加或更新测试（参见 awesome-tests）。
5. 自行验证每项任务：运行计划中指定的检查，并使用 agent-browser 在真实浏览器中检查所有带 UI 的功能。为检查准备所需的服务或测试数据；不要把测试留给用户。
6. 保持计划文件为最新。如果有偏离，请更新计划；如果决策发生变化，请编写新的 ADR。
7. 完成所有任务后，进行审查轮次。如果计划是移交给你的，请说明已准备就绪并等待审查者；否则自行启动审查者（在其独立的 herdr 窗格中，或在 herdr 外部作为子 Agent）。
8. 提交、推送并创建拉取请求，说明更改内容、验证方式以及审查带来的修改。
9. 停止开发服务器并关闭浏览器。将工作树留给创建它的人。

报告 PR 链接、验证结果、审查结论以及所有尚未解决的事项。

审查轮次

每项实施都必须由未参与编写的 Agent 审查一次，以发现作者可能忽略的问题，而不是扩充代码。

• 审查者： 阅读计划、ADR、完整差异，以及与之衔接的代码（参见 code-review）。运行检查，并尝试像用户一样找出问题。只报告真实且可能发生的问题，以及可移除的复杂性；每项都要说明具体的故障场景（或要移除的复杂性）以及修复方法。跳过罕见边缘情况、推测性的加固措施和风格偏好。
• 实施者： 评估每项发现，不要照单全收。用最简单的修复解决真实问题；对于增加的复杂性超过问题本身代价的修复，应说明理由并拒绝。
• 通过直接讨论解决审查发现；尚未解决的问题提交给用户。只有在完成重大修复后才再次审查。