SuperAPI AI 工具集

skill-deep-review

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

Skill Deep Review 用于对单个技能执行全面的质量审查,结合静态分析与通过 /skill-creator 进行的实时触发测试。\n\n适用时机:发布前对单个技能做深度评审;排查技能为何不触发或输出效果差;在重大修改后验证技能;在技能进入生态前做质量把关。\n\n输入:技能路径(技能目录路径,必须包含 SKILL.md);上下文(可选,说明触发此次审查的原因,例如“它从不触发”“输出不正确”)。\n\n流程分为四个阶段。第一阶段为结构分析:读取技能的 SKILL.md 及其目录树中的所有文件,依据 references/deep-review-rubric.md 中的评分标准进行评估,对每个维度按 1–5 分打分并记录具体问题。维度包括:frontmatter 合规性(必填字段齐全、类型正确、版本为有效 semver、描述符合模式)、描述质量(动作动词、触发上下文、关键词变体、长度适当、“pushiness”)、渐进式披露(正文少于 500 行、合理使用引用文件、清晰指向引用文件)、指令清晰度(使用祈使语气、逻辑流畅、无歧义、解释“为什么”而不仅是“做什么”)、协调性(归属声明、composes_with 准确性、与现有技能无重叠)、完整性(所有引用文件存在、无死链、需要处有验证清单)、反模式(无硬编码项目细节、无缺乏理由的过度 MUST/NEVER、正文与引用间无重复内容)。\n\n第二阶段为实时触发测试:利用 /skill-creator 的评估基础设施测试技能是否真正生效。生成 3–5 个应触发该技能的真实测试提示,生成 2–3 个不应触发的接近但未命中的提示,使用 skill-creator 的描述优化工具运行触发评估,报告触发准确率(应触发命中率与不应触发误报率)。\n\n第三阶段为输出质量抽样:若技能产生结构化输出(报告、文件、配置),选取 2 个代表性测试提示,通过 /skill-creator 的测试基础设施运行,对照技能自身声明的格式/预期评估输出,记录承诺输出与实际输出之间的差距。\n\n第四阶段为生成审查报告:产出结构化 Markdown 报告,包含标题(Deep Review: [skill-name]、审查时间、技能路径)、摘要(各维度得分与问题表格、总体评分 X.X/5.0、结论 SHIP | NEEDS WORK | MAJOR REWORK)、触发测试结果(应触发命中率、误报率、问题触发列表)、按严重程度编号的问题(维度、位置、描述、建议)、优点(具体示例)、按影响排序的优先改进建议。报告保存到 {skill-path}/deep-review-report.md 或用户指定位置。\n\n输出后提示用户:审查完成,可将报告输入 /skill-improvement-plan 生成按优先级排序的编辑计划。\n\n准则:保持建设性,每个问题都应有具体建议;诚实评分并解释理由,尤其是低分;若技能功能健全,不纠缠风格细节;高度重视触发测试,不能触发的技能无论写得多好都无用;若用户提供了已知上下文(如“它从不触发”),优先排查该具体问题。\n\n引用文件:references/deep-review-rubric.md,包含各维度的详细评分标准。