标记任务为阻塞状态并记录原因
检查任务是否存在于 .agents/workspace/active/{task-id}/。
注意:{task-id} 格式为 TASK-{yyyyMMdd-HHmmss},例如 TASK-20260306-143022
如果未找到,检查其他目录并告知用户。
阻塞之前,彻底分析:
获取当前时间:
date "+%Y-%m-%d %H:%M:%S%:z"
更新 .agents/workspace/active/{task-id}/task.md:
status:blockedblocked_at:{当前时间戳}updated_at:{当前时间戳}## Activity Log(不要覆盖之前的记录):
- {YYYY-MM-DD HH:mm:ss±HH:MM} — **Blocked** by {agent} — {一行原因}
在 task.md 中添加阻塞信息部分。
mv .agents/workspace/active/{task-id} .agents/workspace/blocked/{task-id}
ls .agents/workspace/blocked/{task-id}/task.md
检查 task.md 中是否存在有效的 issue_number。如果没有,跳过。
Issue 同步的 status label 规则见
.agents/rules/issue-sync.md。执行同步前先读取该文件,完成 upstream 仓库检测和权限检测。
如果存在有效的 issue_number,按 issue-sync.md 设置 status: blocked。
运行完成校验,确认任务产物和同步状态符合规范:
node .agents/scripts/validate-artifact.js gate block-task .agents/workspace/blocked/{task-id} --format text
处理结果:
将校验输出保留在回复中作为当次验证输出。没有当次校验输出,不得声明完成。
仅在校验通过后执行本步骤。
重要:以下「下一步」中列出的所有 TUI 命令格式必须完整输出,不要只展示当前 AI 代理对应的格式。
输出格式:
任务 {task-id} 已标记为阻塞。
阻塞原因:{摘要}
解除阻塞所需:{需要什么}
归档路径:.agents/workspace/blocked/{task-id}/
解除阻塞时执行:
mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
# 然后更新 task.md:status -> active,移除 blocked_at
下一步 - 检查任务状态(解除阻塞后):
- Claude Code / OpenCode:/check-task {task-id}
- Gemini CLI:/agent-infra:check-task {task-id}
- Codex CLI:$check-task {task-id}
.agents/workspace/blocked/当阻塞问题解决后:
# 1. 移回 active
mv .agents/workspace/blocked/{task-id} .agents/workspace/active/{task-id}
# 2. 更新 task.md:设置 status 为 active,更新时间戳
# 3. 从中断处继续(检查 current_step)