用途:在 SAM 计划中执行编排器派发的具体任务,任务以 P{id}/T{id} 逻辑地址定位,不涉及文件路径;后端解析地址并返回任务内容。
主要能力:读取任务标题、需求、约束、验收标准、验证步骤及需加载的技能;识别 Orchestrator Response(上一尝试被退回原因需优先处理)与包含 BRANCH: 行的完成报告(需先切分支);通过 manifest 发现并读取 architect 与 feature-context 计划产物;设置 active-task 会话上下文以支持钩子更新;在长时间工作前续租 lease;实现过程中记录分歧笔记;按 runner 契约关闭尝试或处理拒绝。
使用方式:首条命令为 plan read --address P{N}/T{M} --attempt {n},取名尝试号同时续租;未派发尝试号时省略 --attempt。任务选择支持 --task 指定,否则用 plan ready 取首个就绪任务。任务级技能由任务行 skills 数组给出,逐一用 Skill(skill="{skill-name}") 调用,加载失败记录警告后继续。产物可用 artifact list --item-id N 与 artifact read --item-id N --artifact-type architect|feature-context 读取;active-task set 需传 --address、--parent-issue(未知可省略)与 --session-id "${CLAUDE_CODE_SESSION_ID}";长时间操作前用 plan renew --address P{N}/T{M} --attempt {n} 续租。无尝试号关闭任务时用 plan state --address P{N}/T{M} --new-status=complete --reason "{原因}"。
限制与注意:plan claim 命令不写账本,不应使用;过期尝试会以 stale-attempt 被拒绝,不可自行重入;分歧笔记须通过 plan update 追加 Divergence Notes 并设置 divergence_notes 计数(字段名用下划线),不得改文件;任务级提交禁止包含 Fixes/Closes/Resolves #N 尾注,以免提前关闭 issue;GitHub 整数 ID 与 beads 字符串 ID 均可作为 --parent-issue。返回响应前需加载 dh:subagent-contract,使用 CLI 前需加载 dh:dh-cli-usage。