SuperAPI AI 工具集

planning-validate

数据与分析

查看项目

更新于 10-15 21:13

技能介绍

用途:在 /speckit.plan 执行完成后,自动校验规划产物的质量与一致性,以便在任务生成前发现规范缺口。

主要能力:检查 spec.md 是否完整(存在且可读,摘要、用户故事、功能需求 FR-XXX、成功标准等必要章节是否缺失);检查 plan.md 是否可执行(是否存在技术上下文、项目结构、宪法检查章节,Gate Result 是否为 PASS);若存在 data-model.md,检查实体章节、至少一个实体、实体命名与 spec.md 术语是否一致;若存在 contracts/,检查至少一个契约文件、文件是否为有效 markdown、契约端点是否匹配 spec.md 需求;若存在 constitution.md,检查计划是否引用宪法原则且 Gate Result 无违规。

输出:质量评估结果分为 GREEN(全部通过,可继续 /speckit.tasks)、YELLOW(有警告,可审阅后继续)、RED(存在阻塞项,必须解决后才能继续)。退出码:0 表示 GREEN,1 表示 YELLOW,2 表示 RED,3 表示缺少必要文件。

使用方式:该技能在 /speckit.plan 后自动运行,也可手动执行:npx skills run planning-validate。

适用场景:在使用 speckit 工作流进行规划、准备生成任务之前,用于自动拦截缺失章节、命名不一致、契约覆盖不足、宪法违规等问题。

限制:资料未提供该技能的安装方式、依赖环境、支持的平台、版本信息与收费情况;具体校验规则的实现细节暂未提供。