SuperAPI AI 工具集

cmd-speckit-converge

通用与其它

查看项目

更新于 10-16 05:50

技能介绍

用途:对照某个功能的 spec.md、plan.md、tasks.md(并以项目宪章为约束),评估代码库当前实现状态,找出未满足、未完成或仅部分满足的需求、验收标准、计划决策和既有任务,把剩余工作作为可追溯的新任务追加到 tasks.md 末尾,交给实现命令完成。它不追踪变更,不做 git 或分支对比,只看当前代码状态。

主要能力:读取规格中的功能需求(FR-###)、成功标准(SC-###)、用户故事与验收场景、边界情况;读取计划的架构与技术决策、数据模型、阶段与涉及文件;读取任务 ID 与分组;读取宪章中的 MUST/SHOULD 条款(若为未填模板则跳过)。据此构建意图清单与代码范围映射,对范围内代码检查,按 missing、partial、contradicts、unrequested 分类,并给出 CRITICAL/HIGH/MEDIUM/LOW 严重度。追加前先在会话中输出分级发现摘要与统计。

使用方式:仅可在当前 tasks.md 上运行过实现命令、且任务命令已生成完整 tasks.md 之后运行。从仓库根运行 {SCRIPT} 解析 FEATURE_DIR 与 AVAILABLE_DOCS,推导 SPEC、PLAN、TASKS、CONSTITUTION 路径。若缺少 spec、plan 或 tasks,会停止并提示对应前置命令,不产出部分结果。含单引号的参数用转义写法,如 'I'''m Groot'。

写入约束:唯一写入是向 tasks.md 追加一个 ## Phase N: Convergence 段。不得修改 spec.md 或 plan.md,不得重写、重编号、重排或删除任何既有任务(含此前 Convergence 阶段的任务),不得改动应用代码。若代码已满足全部要求,则 tasks.md 保持逐字节不变,不添加空标题,并报告已收敛。

追加格式:扫描现有任务 ID 取最大值 M,取最高阶段号加一为 N,输出单个 ## Phase N: Convergence 标题;按 CRITICAL/HIGH 优先排序,每条为 - [ ] T{M+1:03d} <命令式描述> per <source-ref> (<gap-type>),source-ref 如 FR-003、SC-002、US1/AC2、plan 决策或 Constitution II。宪章违规任务最先输出并标注 CRITICAL,绝不重用或重编号既有 ID;已有 Convergence 阶段时在其下方新开独立编号段。无发现则不修改文件,报告已收敛及检查计数。

扩展钩子:运行前检查项目根 .specify/extensions.yml 的 hooks.before_converge;运行后检查 hooks.after_converge。文件不存在或无法解析时静默跳过;enabled 显式为 false 的过滤掉,无 enabled 视为启用;无 condition 或为空则视为可执行,非空 condition 跳过交由 HookExecutor 处理。可选钩子输出提示由用户决定是否执行,强制钩子需实际调用并等待结果后继续。

适用场景:在规格驱动开发流程中,实现一轮后核查代码与规格、计划、任务之间的差距,并生成后续待办。限制:需要完整的前置文档与命令流程;不做变更追踪;不删除代码;不修改应用代码;缺失事实(如安装命令、收费信息、平台)暂未提供。