skill-inspector

对已存在的 Skill 做工业级质量审查的 Qoder Markdown Skill。输出评分报告，可选迭代修复。

是什么

skill-inspector 是一个 Skill 质量检查器，用六层模型对任意 Skill 做结构化评估：

层级	维度	方法
L1	结构完整性	静态检查：文件、frontmatter、引用可达
L2	触发准确性	description 覆盖度（正例 / 负例 / held_out）
L3	治理合理性	工具权限 + 模型适配建议 + 自动加载策略
L4	架构健康度	行数、内容密度、目录归类
L5	执行质量	生成 test cases 实际运行并打分
L6	增益验证	A/B 对比：有 Skill vs 无 Skill

核心设计

• 默认只读：不改原 Skill 文件，只出报告；修复需显式 repair_mode=true
• Runtime Adapter：自动识别 Claude Code / Cursor / Qoder / 通用 Markdown 四类运行时
• Hard Gates 先于评分：P0 致命项直接 BLOCKED，P1 严重项总分上限 6，P2 警告项记录
• 渐进式深入：static → dynamic → ab 三档按需开启
• author_intent 豁免机制：被审 Skill 可在 frontmatter 声明作者意图，避免规则误伤
• skill 有用性 > 格式合规：所有规则以此为锚点

使用

把这个目录放到你的 Skill 仓库（如 .claude/skills/ 或 Qoder 的 skills 路径），然后触发：

审查一下这个 skill：<path>
给这个 skill 打分
帮我对这个 skill 做个 eval

核心参数：

参数	默认	说明
eval_depth	static	static（L1-L4）/ dynamic（+L5）/ ab（+L6）
pass_score	7	达标分数线
repair_mode	false	true 时允许迭代修复原文件
trigger_eval_source	inferred	declared / inferred / held_out / all

目录结构

skill-inspector/
├── SKILL.md                      主入口（Phase 调度 + 参数 + 速查）
├── assets/
│   ├── report-template.md        报告模板
│   └── sample-report.md          示范报告
└── references/
    ├── inspection-philosophy.md  最高心法
    ├── rule-design-principles.md 规则设计三元原则（元规则）
    ├── scoring-rubric.md         评分细则
    ├── hard-gates.md             P0/P1/P2 硬扣分
    ├── directory-convention.md   工业化目录规范 + A-P 反模式
    ├── author-intent-schema.md   作者意图声明 schema
    ├── description-convention.md description 编写规范
    ├── runtime-adapters.md       运行时识别规则
    └── format-rules/             各运行时格式规则
        ├── claude-code.md
        ├── cursor.md
        ├── qoder.md
        └── generic.md

许可证

MIT