用途
Check Completion 是一个两阶段的“审计 + 整改”技能,用于核验被声称已完成的工作。它适用于会话、计划、分支或 PR 层面的完成度审计,用于回答“我们做完了吗”“还剩什么”“X 真的完成了吗”这类问题,也用于在宣布完成前核验一个被声明完成的会话、计划、分支或 PR,以及从中断、崩溃或半途而废的执行中枚举剩余工作。
该技能明确说明不适用于以下场景:为单个声明做验证(应改用 Gate Function 作为局部验证门)、评估评审评论或外部评审文档、从 GitHub issues 规划后续工作、审查他人的 PR 或分支 diff、调试运行时故障。
主要能力
22 项状态分类体系
每一项任务只能获得以下状态之一,不允许自行发明第 23 种状态:Implemented、Partially Implemented、Implemented but Untested、Implemented but Broken、Implemented but Outdated、Assumed Complete、Incorrectly Implemented、Stalled、Timed Out、Crashed、Skipped、Forgotten、Blocked、Deferred to Human、Deprioritized、Superseded、Cancelled、Ambiguous、Duplicate、Planned / Queued、Not Planned、Out of Scope。其中终态包括:Implemented、Deferred to Human、Deprioritized、Cancelled、Out of Scope、Superseded(替换项已验证)、Blocked(无法解决但附具体下一步)。
第一阶段:审计
从六类来源枚举任务:对话消息、工具调用历史(Edit/Write/Bash)、TodoList 状态、Git log 与 diff、测试输出/CI、Bash history。合并为去重后的扁平列表后,用 Gate Function 为每项分类。对于 Implemented 判定,须依次:确认何种证据能证明完成、运行验证或找到本会话中的既有证据、读取输出/diff/状态、核对证据与任务匹配,之后才能标注 Implemented。其他状态则应选择最悲观的适用状态,并引用排除 Implemented 的具体证据。
第二阶段:整改
按优先级顺序执行:先阻断项,其次“Implemented but Broken / Outdated”修复回归,然后是 Incorrectly Implemented、Stalled/Crashed/Timed Out、Partially Implemented、Forgotten/Not Planned(相关)/Planned / Queued、Implemented but Untested / Assumed Complete 验证、无正当理由的 Skipped、Ambiguous、Duplicate、Superseded,最后是各类终态记录。整改不因单项阻断而中止。
输出契约
按顺序产出:范围声明、来源扫描摘要、第一阶段审计表、整改日志、阻断文档、第二阶段完成报告。其中审计表与完成报告是核心交付物。若将内容保存为 Markdown 文件,可在进入第二阶段前运行 bash scripts/check-task-status.sh <audit.md>,该检查器会报告状态计数、被发明的状态,以及缺少 Action Required 的非 Implemented 行;声明完成前可对报告运行同一脚本,若 Ended 值被发明或非终态则会失败。
不可协商的规则
- 审计与整改是两个阶段,审计表必须在任何整改前作为独立交付物产出。
- 绝不默认判定为 Implemented;任何疑问都应选择最悲观的适用状态。
- 每个 Assumed Complete 行都需后续验证或降级。
- 每个非 Implemented 行都必须有具体的 Action Required。
- 先有证据后有状态,无证据则不得判定 Implemented。
- 整改顺序为阻断项 → 损坏项 → 缺失项 → 未测试项,而非任务书写顺序。
- 第二阶段不得中途暂停等待确认。
- 完成报告中每一行都必须落在终态。
使用方式
该技能以技能说明与配套参考文件、脚本的形式提供。核心使用流程为:先声明审计范围(会话、计划、分支、PR 或自定义列表),再从六类来源扫描并枚举任务,接着用 Gate Function 逐项分类以产出审计表,然后按优先级逐项整改,最后产出完成报告。若保存了 Markdown 文件,可调用 bash scripts/check-task-status.sh <文件> 进行确定性校验。
适用场景
适用于声称已完成工作的核验、会话/计划/分支完成度审计、发现部分完成或被假定完成的任务、回答“我们是否……”,以及将一句随意的“我觉得没问题”转化为严格的完成审计。
限制
资料未提供该技能的收费、价格、平台支持或具体运行环境要求。其分类与流程细节分散在 references/ 与 scripts/ 目录下的配套文件中,具体实现未在本资料中给出。