SuperAPI AI 工具集

plan-6a-v2-update-progress

通用与其它

查看项目

更新于 10-15 22:40

技能介绍

用途:更新计划(plan)与档案(dossier)的进度跟踪,写入任务状态,并为变更记录补充领域(domain)上下文。它是进度更新的单一来源,官方建议始终通过该命令更新,而不是手工编辑任务表。

主要能力:解析 --plan 定位计划与目录;按 --inline 更新计划内联任务表,按 --phase 定位 PLAN_DIR/tasks/${PHASE_SLUG}/tasks.md,按 --subtask 定位子任务档案;解析 --changes 为变更文件列表;确定领域(优先 --domain,否则从任务表 Domain 列推断,找不到则用 unknown);更新任务状态(completed→[x]、in_progress→[~]、blocked→[!]),并更新架构图节点与计划中的进度区;记录受影响领域、新增组件、契约变更,并在需要时提示更新 docs/domains/domain-map.md 或 domain.md 的 Concepts。

用法:命令为 /plan-6a-v2-update-progress,常用参数包括 --plan、--task(如 T001)、--status(completed|in_progress|blocked)、--changes(逗号分隔文件)、--domain(可选);可选 --phase、--subtask、--inline、--companion-run-id、--companion-slug(默认 code-review-companion)。非伙伴调用示例:/plan-6a-v2-update-progress --task <T> --status completed --plan <P>,此时跳过伙伴收尾;带 --companion-run-id 时触发收尾流程。

伙伴收尾(仅当同时满足 --status completed、阶段最后一个任务、提供了 --companion-run-id):先发送最终扫描请求并等待 30-60 秒读取收件箱,再发送 control:stop,随后通过 minih retros 或 minih validate 读取告别信封,逐条对发现做处理(内联修复、说明理由后延期、或说明不同意),并把 magicWand 作为后续候选提示(不自动创建档案)。

限制:已退役的计划级 flight plan 更新与编排器回顾不再由本技能承担,本技能不写回顾产物、不触发 harness 接缝;docs/harness/agents/** 为只读历史。未提供 --companion-run-id 时整个收尾步骤跳过。其余细节资料未提供。