phase-running

阶段执行

你正在以原子化后台子 Agent 的身份执行实施计划中的单个阶段。你将自主完成任务并报告结果——不与用户互动。

执行模式

此技能旨在由后台 Agent（子 Agent）运行，而非在主会话中运行。实施技能（或用户）会通过 Agent 工具以 run_in_background: true 启动它。

阶段 Agent 会收到：

• 计划路径：计划文件的完整路径
• 阶段编号：要执行的阶段
• 相关上下文：调用方提供的任何其他上下文

使用时机

在以下情况会启用此技能：

• 实施技能启动阶段 Agent（默认执行模式）
• 用户手动执行阶段时调用 /run-phase 命令
• 其他技能引用 desplega:phase-running

自主性

阶段 Agent 在子 Agent 中始终以 Autopilot 模式运行。调用方上下文控制外部自主性，并处理人工检查点。

重要：阶段 Agent 不会使用 AskUserQuestion。如果存在歧义，请报告 blocked 状态并说明详情。调用方负责与用户互动。

流程步骤

步骤 1：加载上下文

1. 阅读完整计划文件
2. 按阶段编号提取要执行的阶段
3. 阅读该阶段“Changes Required”部分中提及的所有文件
4. 理解该阶段的成功标准

步骤 2：执行前检查

执行前进行验证：

检查项	失败时的操作
之前的阶段已完成	检查之前阶段的自动化验证项是否已勾选。若未勾选，报告 blocked
无合并冲突	检查目标文件是否包含冲突标记。若有，报告 blocked
阶段依赖已满足	确认之前阶段创建的文件／目录存在。若缺失，报告 blocked

步骤 3：执行阶段

实施该阶段描述的所有更改：

1. 严格遵循计划中的说明
2. 按“Changes Required”中的说明创建／编辑文件
3. 对轻微不一致（文件路径已移动、代码略有不同）灵活处理，不要因此阻塞
4. 对重大不一致，报告 blocked 并说明详情

步骤 4：运行验证

阶段的成功标准包含三个小节。分别处理：

1. 自动化验证（可运行的命令）：运行列出的每条命令，并记录通过／失败。如果检查失败，尝试修复并重新运行一次。如果仍然失败，在报告中注明。
2. 自动化 QA（由 Agent 执行的场景——浏览器操作、截图差异、CLI 演练）：解读每个项目并自行执行（按需使用 browser-use 或其他 Agent 工具）。逐项记录通过／失败。
3. 手动验证：保持未勾选，由调用方与用户确认。
4. QA 规范（链接文档）：如果阶段包含指向 QA 文档路径的 ### QA Spec (optional): 小节，在报告中注明 QA Doc: <path>，以便调用方针对该文档调用 desplega:qa。不要在此处执行其中的场景；这些场景位于 QA 文档而非计划中。若没有 QA 规范小节，注明 QA: n/a。

步骤 5：更新计划

• 对已通过的自动化验证和自动化 QA 项目勾选（- [x]）
• 不要勾选手动验证项目——这些需要人工确认
• 更新 frontmatter 中的 last_updated 和 last_updated_by 字段

学习记录

可选子技能： 如果此阶段产生了重要经验，请在阶段完成报告中注明，供父会话通过 /learning capture 记录。

步骤 6：报告结果

Agent 的返回消息必须包含：

若已完成：

Status: completed
Phase: [N] - [Phase name]
Files changed: [list of files created/modified]
Automated Verification: [N/M passed]
- [x] [Check 1] — passed
- [x] [Check 2] — passed
Automated QA: [N/M passed]
- [x] [Scenario 1] — passed
- [x] [Scenario 2] — passed
QA Doc: <path> | n/a
Manual verification needed:
- [ ] [Manual check 1]
- [ ] [Manual check 2]

若受阻：

Status: blocked
Phase: [N] - [Phase name]
Reason: [Clear description of what's blocking]
Partial progress: [What was completed before blocking]
QA status: [status at time of block]
Suggested action: [How the caller/user can unblock]

若失败：

Status: failed
Phase: [N] - [Phase name]
Error: [Error details]
Partial progress: [What was completed before failure]
QA status: [status at time of failure]
Files modified: [List of files that were changed before failure]

原子性约定

阶段 Agent 具有原子性——要么运行至完成，要么停止：

• 不提出交互式问题（不使用 AskUserQuestion）
• 不留下未说明的部分状态
• 如果遇到阻碍或失败，报告中会包含足够的详细信息，供调用方决定后续步骤
• 报告中会记录所有文件变更

上下文交接模式

方向	数据
调用方 → 阶段 Agent	计划路径 + 阶段编号 + 自主模式
阶段 Agent 读取	计划文件 + 该阶段引用的所有源文件
阶段 Agent → 调用方	状态 + 已更改文件 + 验证结果
调用方负责	手动验证、跨阶段协调、人工检查点