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 流程中添加一条命令运行本工具即可,支持输出标准格式报告,也可与预提交钩子集成,在每次提交前自动审查。