SuperAPI AI 工具集

speckit-analyze

测试与质量

查看项目

更新于 10-15 20:34

技能介绍

用途:在 /speckit-tasks 成功生成完整 tasks.md 之后、进入实现之前,对 spec.md、plan.md、tasks.md 三份核心产物做非破坏性的跨文档一致性与质量分析,提前发现不一致、重复、歧义和欠规范项。

主要能力:检测需求重复、模糊形容词与未解决占位符、缺少可测结果的欠规范项、与项目宪法(.specify/memory/constitution.md)MUST 原则的冲突、需求与任务之间的覆盖缺口、术语漂移与实体不一致、任务顺序矛盾等;按 CRITICAL/HIGH/MEDIUM/LOW 分级,输出含 ID、类别、严重度、位置、摘要、建议的 Markdown 报告,并附覆盖汇总表、宪法对齐问题、未映射任务和指标(需求数、任务数、覆盖率、歧义数、重复数、严重问题数)。

使用方式:从仓库根目录运行 .specify/scripts/bash/check-prerequisites.sh --json --require-spec --require-tasks --include-tasks,解析 FEATURE_DIR 与 AVAILABLE_DOCS 后定位三份文件;缺少必需文件时报错并提示先运行前置命令。分析严格只读,不写文件;报告末尾给出后续动作建议(如 /speckit-specify、/speckit-plan 或手动编辑 tasks.md),并询问是否要针对前 N 个问题给出具体修复编辑,需用户明确批准后才执行。

扩展钩子:若项目根存在 .specify/extensions.yml,会读取 hooks.before_analyze 与 hooks.after_analyze;enabled 为 false 的跳过,无 enabled 视为启用;带非空 condition 的钩子跳过,交由 HookExecutor 处理;命令名中的点替换为连字符(如 speckit.git.commit → /speckit-git-commit)。可选钩子仅提示执行方式,强制钩子(optional: false)需实际调用并等待结果。YAML 无法解析时明确告知用户并继续。

限制:仅限上述三份产物与宪法范围;不修改文件、不臆造缺失章节;宪法冲突一律记为 CRITICAL,需在 /speckit-analyze 之外单独更新宪法;发现项上限 50 条,超出部分汇总;无问题时应输出成功报告与覆盖统计。具体安装方式与收费信息暂未提供。