SuperAPI AI 工具集

speckit-converge

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:在 /speckit-implement 执行完当前 tasks.md、且 /speckit-tasks 已生成完整任务清单之后运行,用于弥合规格(spec.md)、计划(plan.md)、任务(tasks.md)与代码现状之间的差距。它只评估代码当前状态,不做 diff、不比较分支、不追踪历史。

主要能力:读取 spec.md、plan.md、tasks.md 作为意图来源,并以项目宪法(.specify/memory/constitution.md)为约束;建立需求清单(FR、SC、用户故事验收场景、计划决策、宪法原则),按计划与任务中提到的文件路径及关键词界定评估范围;将发现分类为 missing、partial、contradicts、unrequested,并评定 CRITICAL/HIGH/MEDIUM/LOW 严重度;先在会话内输出分级发现摘要,再把可执行发现按严重度排序追加为新的“## Phase N: Convergence”任务,任务 ID 从现有最大编号续编,并标注来源引用与差距类型。

使用方式:从仓库根目录运行 .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks 获取 FEATURE_DIR 与 AVAILABLE_DOCS;若缺少 spec.md、plan.md 或 tasks.md 则停止并提示对应命令(/speckit-specify、/speckit-plan、/speckit-tasks)。支持 .specify/extensions.yml 中的 before_converge 与 after_converge 钩子,钩子命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit);YAML 无法解析时需告知用户并继续。

限制:仅追加,绝不重写——不修改 spec.md 或 plan.md,不重写、重编号、重排或删除已有任务,也不改动应用代码;若代码已满足全部要求,tasks.md 保持逐字节不变且不写空标题,报告已收敛。宪法为未填充模板时跳过宪法检查。资料未提供安装命令、收费与平台信息。