implementing

实施

你正在实施一份已批准的技术计划，按阶段执行，并在每一步进行验证。每个阶段都作为后台子 Agent 通过 desplega:phase-running 执行，主会话则充当协调者。

工作约定

所有面向用户的问题都必须通过 AskUserQuestion 提出——参阅 desplega:ask-user 了解规范。切勿在聊天中以普通项目符号列表提问。

所有读取、研究和验证工作都必须由子 Agent 完成——不要将原始工具输出带入主会话。默认使用 run_in_background: true。

自主模式（如下）决定你多久确认一次进度。始终使用 AskUserQuestion。

默认启用文件审查——某个阶段完成重大变更后，调用 /file-review:file-review <path> 获取行内反馈（仅 Autopilot 模式下可跳过）。

适用场景

在以下情况启用此技能：

• 用户调用 /implement-plan 命令
• 其他技能引用 **REQUIRED SUB-SKILL:** Use desplega:implementing
• 用户要求执行或实施现有计划

自主模式

根据自主模式调整行为：

模式	行为
Autopilot	执行所有阶段，仅在需要人工验证或遇到阻碍时暂停
Critical（默认）	在各阶段之间暂停并征求批准；发现不匹配时询问
Verbose	频繁确认进度，每次重大变更前都进行确认

自主模式由调用此技能的命令传入。如果未指定，则默认为 Critical。

初始设置问题

确认用户偏好后，使用 AskUserQuestion 收集实施所需的具体信息：

1. 分支／工作树设置

首先，检查当前分支：git branch --show-current

然后检查 wts 插件是否可用（查看可用技能中是否有 wts:wts）。

如果已安装 wts 插件，使用 AskUserQuestion 并提供以下选项：

问题	选项
“你当前位于分支 <current-branch>。希望在哪里进行实施？”	1. 继续使用当前分支，2. 创建新分支，3. 创建 wts 工作树

如果未安装 wts 插件，使用 AskUserQuestion 并提供以下选项：

问题	选项
“你当前位于分支 <current-branch>。希望在哪里进行实施？”	1. 继续使用当前分支，2. 创建新分支

2. 提交策略

使用 AskUserQuestion 并提供以下选项：

问题	选项
“实施期间希望如何处理提交？”	1. 每个阶段结束后提交（复杂计划推荐），2. 最后统一提交（所有变更合并为一次提交），3. 过程中由我决定

如果选择“每个阶段结束后提交”：

• 完成每个阶段的验证后，创建一条提交，消息格式为：[Phase N] <phase name>
• 使用计划中的阶段描述作为提交消息

3. 代码审查模式

使用 AskUserQuestion 并提供以下选项：

问题	选项
“是否在每个阶段后自动进行代码审查？”	1. 每个阶段进行自动双轴审查（推荐），2. 仅在最后进行一次审查，3. 关闭——我会自行审查

在 Autopilot 模式下，跳过此问题，默认启用每个阶段的自动审查。

保存这些偏好，并在整个实施过程中始终遵循。

回顾先前经验

可选子技能： 如果 ~/.agentic-learnings.json 存在，则运行 /learning recall <current topic>，在继续之前查找相关的既往经验。

开始使用

收到计划路径后：

1. 完整阅读计划
2. 检查是否有已勾选的复选框（- [x]）
3. 通过编辑 frontmatter 中的 status 字段，将计划状态设为 status: in-progress。这会向进度跟踪钩子表明当前激活的是哪个计划。
4. 完整读取文件——绝不使用 limit/offset 参数
5. 深入思考各个部分如何相互配合
6. 创建待办事项列表以跟踪进度
7. 如果你了解需要完成的工作，就开始实施

如果未提供计划路径，请询问。

实施理念

计划经过精心设计，但现实可能纷繁复杂。你的工作是：

• 在遵循计划意图的同时，根据实际情况灵活调整
• 完整实施每个阶段后，再进入下一阶段
• 在更广泛的代码库背景下确认你的工作合理
• 完成计划中的各个部分后，更新相应的复选框

如果实际情况与计划不完全一致，请思考原因并清楚说明。

处理不匹配情况

如果遇到不匹配情况（且自主模式不是 Autopilot）：

• 停止并深入思考为何无法遵循计划
• 使用 AskUserQuestion 说明问题并征求指示：

问题	选项
“阶段 [N] 出现问题：预期情况为 [计划中的说明]，实际情况为 [实际情况]。原因：[说明其重要性]。我应该如何继续？”	1. 调整计划以适应实际情况，2. 按原计划继续，3. 停止并讨论

在 Autopilot 模式下，请自行判断并在注释中记录决策。

验证方法

每个阶段都通过后台子 Agent 执行，运行 desplega:phase-running：

1. 在主会话中阅读阶段概览（尽量减少上下文用量）
2. 在后台启动 desplega:phase-running Agent，并提供计划路径和阶段编号：
   • 使用 Agent 工具，并设置 run_in_background: true
   • 将计划路径和阶段编号作为上下文传入
3. 等待 Agent 完成——完成后你会收到通知
4. 检查 Agent 的报告——查看状态（已完成/受阻/失败）、更改的文件和验证结果
5. 检查 QA 文档状态——如果阶段 Agent 报告了 QA Doc: <path>，则关联的 QA 文档包含需要执行的场景。请针对该 QA 文档路径调用 desplega:qa。（如果报告为 QA: n/a，则正常继续。）注意：阶段 Success Criteria 中的自动化 QA 项目已由阶段 Agent 处理，此处只需单独安排关联的 QA 文档。
6. 进行每阶段代码审查（除非审查模式为 Off）——针对该阶段的差异调用 desplega:code-reviewing：将 Standards 和 Spec 轴作为并行后台子 Agent 处理（按照 desplega:delegate-work 进行路由），Spec 的来源为阶段正文和 Success Criteria。关键问题会阻止阶段关闭——修复并重新验证后再提交。如果选择了“Only at the end”，则在“完成实施”之前对完整差异进行一次审查。
7. 与用户处理手动验证——向用户展示该阶段的手动验证项目
8. 用户确认后，再进入下一阶段

实施技能是一个编排器——它负责协调阶段、处理人工检查点和管理跨阶段决策，但会将实际实施工作委派给阶段运行子 Agent。

执行器路由：如果 desplega:delegate-work 技能可用，请根据其路由矩阵为每个阶段选择执行器，而不是默认使用 phase-running 子 Agent——阶段可能会路由到 Codex 变体或特定 Claude 模型层级。只有执行器选择会改变；此处其他所有内容（自主模式、检查点、计划记录、验证、提交策略）保持不变。

暂停以等待人工验证（非 Autopilot 模式或执行多个阶段时）

Phase [N] Complete - Ready for Manual Verification

Automated verification passed:
- [List automated checks that passed]

Please perform the manual verification steps listed in the plan:
- [List manual verification items from the plan]

Let me know when manual testing is complete so I can proceed to Phase [N+1].

如果指示连续执行多个阶段，则跳过暂停，直到最后一个阶段。

未经用户确认，不要勾选手动测试项目。

遇到困难时

如果有些内容未按预期运行：

1. 确保已阅读并理解所有相关代码
2. 考虑代码库是否已在编写计划后发生变化
3. 清楚说明不一致之处并寻求指导（Autopilot 除外）
4. 谨慎使用子任务，针对性地进行调试

恢复工作

如果计划中已有勾选项：

• 相信已完成的工作确实已经完成
• 从第一个未勾选的项目继续
• 只有在发现异常时才验证先前的工作

记录经验

可选子技能： 如果此工作流中产生了重要见解、模式、易错点或决策，可考虑使用 desplega:learning，通过 /learning capture 记录下来。重点记录能帮助他人在未来会话中开展工作的经验。

完成实现

所有阶段均已完成并验证后：

1. 将计划 frontmatter 中的 status 字段设为 completed。
2. 确保已更新自动化验证复选框。
3. 在用户确认完成前，保持手动验证复选框未勾选。
4. 提供实现后的审计选项：“是否要我运行 /verify-plan 进行实现后的审计，然后运行 /review 做最后的质量检查？”
5. 如果工作通过 GitHub PR 发布：审查意见发布后，使用 desplega:tackle-gh-comments 处理这些意见（获取讨论串、逐条核实说法、修复、回复、解决，最后再推送）。

请记住：你是在实现解决方案，而不只是勾选项目。始终牢记最终目标。

集成审查

文件审查默认开启（Autopilot 除外）：

• 每个阶段完成重要代码更改后，调用 /file-review:file-review <changed-file-path>，获取行内人工评论
• 在进入下一阶段前，使用 file-review:process-review 技能处理反馈