SuperAPI AI 工具集

speckit-analyze

通用与其它

查看项目

更新于 10-15 21:46

技能介绍

Speckit Analyze 是一个用于规格驱动开发流程的一致性分析技能,必须在 /speckit.tasks 成功生成完整 tasks.md 之后运行。

用途:在实现开始前,检查 spec.md、plan.md、tasks.md 三份核心工件之间是否一致,识别不一致、重复、歧义与欠明确项。

主要能力:执行多类检测,包括需求重复检测、歧义检测(如 fast、scalable 等无可测量标准词,以及 TODO、TKTK、??? 等占位符)、欠明确检测(缺对象或可测量结果、用户故事缺验收标准、任务引用未定义文件或组件)、宪法对齐检测、覆盖缺口检测(需求无对应任务、任务无对应需求、非功能需求未落入任务)以及不一致检测(术语漂移、计划引用但规格缺失的数据实体、任务顺序矛盾、需求冲突)。

严重度:CRITICAL(违反宪法 MUST、缺失核心工件、零覆盖且阻塞基础功能)、HIGH、MEDIUM、LOW 四级。

使用方式:技能先运行 .specify/scripts/powershell/check-prerequisites.ps1 -Json -RequireTasks -IncludeTasks 并解析 FEATURE_DIR 与 AVAILABLE_DOCS,随后按需加载工件并构建需求清单、用户故事清单、任务覆盖映射与宪法规则集,最后输出 Markdown 分析报告,含发现表、覆盖汇总表、宪法对齐问题、未映射任务与指标(需求总数、任务总数、覆盖率、歧义数、重复数、严重问题数),并给出后续命令建议。

限制:严格只读,不修改任何文件,不自动应用修复;宪法冲突一律视为 CRITICAL,且不能通过稀释或忽略原则解决,原则本身变更需在 /speckit.analyze 之外单独更新宪法。发现上限 50 条,其余汇总。缺失章节如实报告,不臆造。必须工具有 PowerShell 脚本环境,具体平台支持范围暂未提供。