skill-lint
Installation
SKILL.md
Skill Lint
本技能负责 Skill 创建前设计预检和创建后质量验收:审查一个 Skill 是否结构合规、文档一致、可发布、可评估、安全风险可控,判断它是否真实承载业务流程,并检查“完成”结论是否由候选绑定证据和多轮真实产物支撑。
本技能不代替主要创建者或领域验证器。创建或大改 Skill 时,用它先审查 Harness 设计,再由创建工具实现,完成后回到本技能做候选绑定验收。
工作原则
- 先看硬性问题,再看优化问题。
- 先做静态审查,再判断业务流深度。
- 先定位审查单元,再审查目标 Skill 目录及明确给出的上下文。
- 不把格式合规等同于任务效果通过。
- 不采信生产者自报的 PASS;正式验收必须绑定当前候选、当前规则和实际日志。
- 不把“有 checker”当作“覆盖完整”;每条硬约束必须追踪到合适模态、正确产物阶段和回归用例。
- 不比较自然语言输出的整文件哈希;只比较合同声明的关键覆盖集合和可观察不变量。
- 客观缺陷 fail-closed;语义质量保留人工判断,不伪装成万能自动化。
- 只审查领域 checker 的覆盖、模态和证据,不把证据不足冒充为已经发现具体领域算法错误。
- 已知漏报必须有最小违规反例,已知误报必须有合法近似正例;两者都由目标 Skill 的领域 checker 定义。
- 对无法确认的能力标注“未提及/待补充”。