skill-lint
Skill 创建预检、可靠性验收与格式审查工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:skill-lint。 它的用途是:Skill 创建预检、可靠性验收与格式审查工具 详细介绍见:https://321skill.com/skills/skill-lint-x-2/ 请根据该页面的说明完成安装。
使用示例
'使用 skill-lint 审查当前目录下的 Skill 项目,检查目录结构和指令格式',它会自动扫描并输出问题列表和修复建议。例如:'发现约束字段缺失,建议补充 version 和 description 字段;Harness 契约中缺少故障注入测试用例'。
介绍
解决什么问题:在用户创建、重大改造或审查 Skill 时,常遇到指令遵循不稳定、产出漂移、验证模态错配、约束漏检等问题。本工具提供系统性预检与格式审查,帮助识别 Harness 契约、候选绑定证据、故障注入、目录结构、业务流和安全风险,确保 Skill 的可靠性和一致性。
怎么用:通过命令行工具对 Skill 项目进行快速扫描,自动检查目录结构、指令格式、约束定义、安全风险等维度。用户可将其集成到 CI/CD 流程中,在每次 Skill 变更时自动触发预检,并输出详细的审查报告,标注问题位置与修复建议。
适合谁:智能体开发者、AI 应用开发者、运维工程师、质量控制人员。如果你正在开发或维护多个 AI Agent Skill,需要确保其质量与稳定性,本工具将是你的得力助手。
使用建议:建议在 Skill 开发早期阶段频繁使用,并配合版本控制。本工具专注于 Skill 本身的结构与可靠性,不可替代业务领域验证、功能测试或通用代码审查。审查结果应作为人工复核的辅助参考。
核心特点
与通用代码 lint 工具不同,本工具专门针对 AI Agent Skill 的独特结构(如指令、约束、Harness 契约)进行校验,能识别旧版 Skill 的指令漂移、验证模态错配等特定问题,是 Skill 生态的质量守门人。
注意事项
不适合用于代替业务领域验证器、代码审查、应用功能测试或通用编程任务,仅关注 Skill 自身的结构可靠性与格式合规。
常见问题
这个工具能检查 Skill 的哪些具体问题?
能检查指令遵循稳定性、产出漂移、验证模态错配、约束漏检、Harness 契约、候选绑定证据、故障注入、目录结构、业务流和安全风险等。
如何集成到现有工作流中?
在 CI/CD 流程中添加一条命令运行本工具即可,支持输出标准格式报告,也可与预提交钩子集成,在每次提交前自动审查。