SuperAPI AI 工具集

quality-advisor

测试与质量

查看项目

更新于 10-16 01:50

技能介绍

用途:在 SDD 工件撰写过程中提供即时质量指导,让问题在创建阶段而非事后校验阶段被发现。它会对章节完成度打分、检测文档反模式、检查累积标签并校验命名,然后给出可执行的建议。

适用场景:撰写新工件并希望获得实时反馈;提交前审查工件;检查单个文档是否符合模板要求、标签或命名规范。不适用于完整的双向可追溯性或全项目校验(应使用 ../doc-validator/SKILL.md),也不适用于非 SDD 文档。

主要能力:给定工件内容、类型和可选检查级别(quick / standard / strict),该技能会从 ${CLAUDE_PLUGIN_ROOT}/framework/registry/LAYER_REGISTRY.yaml 加载该工件所属层的模板要求,包括必需章节、最低标签数量和特殊规则(如 PRD 的 KPI 必须量化、EARS 的 WHEN-THE-SHALL 语法、SPEC 的 YAML 形式);代码是 IPLAN 的下游执行目标,而非文档工件。随后评分章节完成度,识别必需章节并标记缺失或部分完成项,报告完成度分数与具体问题。检测反模式,包括缺少 Document Control、占位文本、验收标准含糊、缺少可追溯性标签、失效链接、ID 格式违规、空章节、孤立工件、计数或交叉引用不匹配、未定义缩写、ID 记法混用、前向引用不存在的文档,每项附带严重程度与修复建议。校验累积标签,确认工件恰好携带其层所需的上游标签族(BRD 0 → … → IPLAN 7),无缺口且无下游标签。检查命名,包括文档 ID TYPE-NN、元素 ID TYPE.NN.SS.xxxx、阈值标签和文件名 slug,遵循 ../doc-naming/SKILL.md 与 ${CLAUDE_PLUGIN_ROOT}/framework/governance/ID_NAMING_STANDARDS.md,并标记遗留模式。最后生成质量报告,包含总体状态与分数、错误/警告/信息计数、各领域结果、按优先级排序的建议及后续步骤(通常是先修复错误,再运行 ../doc-validator/SKILL.md)。

限制:该框架不附带运行时代码,此技能本身就是检查器,依据上述声明式检查对规范进行校验。相关资源包括层注册表与标签规则、ID 与标签标准、各层 README、命名技能、创建后校验技能及路由技能。具体安装命令与收费信息暂未提供。