skill-lint
Skill创建预检、可靠性验收与格式审查工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:skill-lint。 它的用途是:Skill创建预检、可靠性验收与格式审查工具 详细介绍见:https://321skill.com/skills/skill-lint-x-8/ 请根据该页面的说明完成安装。
使用示例
“请使用skill-lint检查我新创建的Skill ‘skill-weather’,确保其指令遵循稳定、验证模态正确、无约束漏检。”,它会自动扫描目录结构、检查Harness契约、注入故障测试、报告安全风险,并生成一份预检报告,帮助你在发布前发现潜在问题。
介绍
本工具解决AI Agent Skill创建、重大改造或审查过程中的可靠性问题。旧版Skill常出现指令遵循不稳定、产出漂移、验证模态错配、约束漏检等隐患,同时Harness契约、候选绑定证据、故障注入、目录结构、业务流和安全风险等环节也容易被忽略。skill-lint通过自动化检查,在Skill发布前识别这些潜在缺陷,确保技能符合规范且稳定可靠。
使用方式简单:将待检查的Skill目录或仓库路径传入工具,它会自动扫描目录结构、解析Harness契约、验证验证模态、检查约束完整性、执行故障注入测试、审查业务流与安全风险,并生成结构化的预检报告。报告会列出所有发现的问题、严重等级以及修复建议,帮助开发者快速定位和修复。
适合智能体开发者、测试工程师和运维工程师在Skill开发流程中使用。无论是新创建的Skill,还是对现有Skill进行重大改造后的回归审查,或是从社区获取的第三方Skill的合规性评估,都能通过该工具获得可靠的质量保障。
注意:此工具专为AI Agent Skill设计,不能替代业务领域验证器、通用代码审查、应用功能测试或通用编程任务。对于非Skill场景的代码质量检查,请使用专门的代码lint工具。建议在CI/CD流程中集成,作为Skill发布前的必要环节。
核心特点
同类lint工具通常针对通用代码,而skill-lint专门检测AI Agent Skill特有的指令遵循稳定性、验证模态错配、Harness契约完整性等风险,并支持故障注入测试,这是通用代码审查工具无法覆盖的。
注意事项
不能代替业务领域验证器、代码审查、应用功能测试或通用编程任务。
常见问题
skill-lint能检查哪些类型的Skill?
支持所有基于标准Skill规范创建的AI Agent Skill,包括自定义指令、Harness、验证模态等结构。
如何集成到CI/CD流水线?
安装后使用命令行调用,可设置非零退出码触发构建失败,方便在GitHub Actions、GitLab CI等平台集成。