SuperAPI AI 工具集

spec-inspect

设计与创作

查看项目

更新于 10-15 16:51

技能介绍

用途:spec-inspect 用于自动校验 spec-generator 输出的规格文档(requirement.md、design.md、tasks.md),在实现前发现质量问题,并以 Markdown 报告形式输出。

主要能力:按顺序执行多项检查,包括需求 ID 一致性(引用未定义 ID 标为 CRITICAL,未引用 ID 标为 INFO,覆盖率不足标为 WARNING)、必需结构与需求边界、跨文档矛盾检测、歧义表达检测、术语一致性、设计到任务覆盖、任务依赖验证、不可行需求、缺失需求、命名约定、目录结构、重复实现、项目规则合规,以及 API/UI 命名约定等扩展检查。支持日语和英语,自动检测输入语言并用相同语言输出报告。

使用方式:定位 .specs/{project-name}/ 路径,确认三个规格文件存在后读取内容;用 Read 读取相关引用文件并按步骤执行检查;结果汇总为 Critical、Warning、Info 计数,写入 .specs/{project-name}/inspection-report.md,并在控制台显示摘要。随后可询问下一步动作,选择后调用 spec-to-issue 技能,或将检查结果以 JSON 写入 .specs/{project-name}/.inspection_result.json 供后续使用。

适用场景:在 spec-generator 完成后、用 spec-to-issue 登记 Issue 前,或更新规格文档后运行。

限制:仅支持日语和英语的 Markdown 规格文档,依赖 spec-generator 的输出格式;自然语言分析存在固有准确度限制,矛盾检测依赖 LLM 推理能力,为尽力而为;若必需文件缺失则报错退出。其他事实如具体性能或收费信息暂未提供。