Task Completion Loop 是一个编排型 Skill,旨在把已有的命名计划/规范或边界明确的未完成非平凡编码任务,收敛为同一份最终代码快照上的可验证终态。
用途
- 将已有 plan/spec 或半成品代码推进至可验证完成状态
- 管理任务账本、调用顺序、证据新鲜度、授权边界和停止条件
- 协调多个依赖 Skill(goal-gate、agentic-review-handoff、architecture-hardening-loop)和真实外部会话(Peer A、Peer B、Claude 盲审)完成闭环
主要能力
- 任务账本管理:将原始计划的每项工作标记为 VERIFIED_DONE、PENDING、OBSOLETE、EXCLUDED 或 HUMAN_DECISION,冻结本轮全部 PENDING 及必要测试/文档。
- 三方交叉质疑:宿主、真实 Peer A、真实 Peer B 分别读取同一组文档、代码和任务账本,独立形成立场,然后互相攻击最强论点并允许依据证据改口。
- 条件式用户决策:当出现真正的产品/领域决策、公共契约变更、数据归属、安全或范围扩张时,返回 HUMAN_GATE。
- Goal Gate:调用 goal-gate 技能,严格服从其 Decision/Next,确保 Goal 覆盖任务账本、冻结范围、验证、三道门禁和外部写边界。
- 实现与验证:按依赖顺序处理全部 PENDING,做最小内聚改动,使用真实 runtime 信号验证,证据通过后才标记 VERIFIED_DONE。
- 三道门禁:依次通过 agentic-review-handoff(代理评审)、architecture-hardening-loop(架构加固,要求 NO_ACTIONABLE_FINDINGS)和全新只读 Claude 盲审。
- 无人值守续跑:仅用于无人值守/自主运行场景,任务账本即 checklist,每回合更新,自动续跑最多 2–3 次。
- 跨任务经验:在终态报告前最多写一条新经验(cue、lesson、evidence 三项缺一不可,且需有对照证据)。
使用方式
- 启动条件:同时具备 Git 仓库和命名 plan/spec(或可从当前代码确定明确范围),以及明确的完整闭环实现请求。只要 Goal、只要 review-fix-re-review、只要架构加固、普通实现、纯讨论、纯 review 或只读诊断均不属于本 Loop。
- 能力预检:需确保 goal-gate、agentic-review-handoff、architecture-hardening-loop 及其传递硬依赖可用,且能启动真实 Peer A、Peer B 会话和真实 Claude Code 会话。缺少能力时返回 MISSING_DEPENDENCIES,禁止用通用 subagent 冒充 Peer 或盲审的 Claude。
- 状态机流程:预检与任务账本 → 三方交叉质疑 → 条件式 grill-with-docs(用户决策)→ Goal Gate → 实现全部 PENDING + 验证 → agentic-review-handoff → architecture-hardening-loop = NO_ACTIONABLE_FINDINGS → 全新只读 Claude 盲审 → COMPLETED。
- 终态报告:输出 Task Completion Result,包含 Scope/exclusions、Work ledger、Three-party decision、Goal 状态、最终 evidence id、实现内容、验证结果、各门禁结果、修复/Backlog/Rejected 项、协议/Git/外部动作、经验记录和最终 Result(COMPLETED、HUMAN_GATE、MISSING_DEPENDENCIES 或 UNVERIFIED)。
适用场景
- 已有明确 plan/spec 需要完整闭环实现至可验证终态
- 需要三方独立交叉质疑以确保决策质量
- 需要多道门禁(评审、架构加固、盲审)覆盖同一最终快照
- 无人值守或自主运行环境下的编码任务推进
限制
- 不授权 git add、commit、push、merge、rebase、branch/worktree 创建,不授权 PR、issue、评论、消息、任务、API 数据、部署或生产写。
- 不默认全仓库范围;无法安全确定范围时只问一个范围问题并停止。
- 原始 PENDING 不能被 reviewer 建议偷换成 Backlog;plan 承诺项的归属只属于用户或有效决策。
- 预算(Phase 1 deadline、B 轮数、Phase 4 两轮盲审)用尽不构成完成理由,也不改变代码正确性;必须交还控制时返回 UNVERIFIED 并保持 Goal active。
- 缺少能力时禁止代装依赖、复制缺失 Skill 逻辑或让通用 subagent 冒充真实模型立场。
- 分类标识为 coding(编程与开发)。