用途:该技能面向 skills_lint 的日常使用,帮助运行校验器、排查失败运行,并在默认规则不足时编写自定义规则。首次接入(添加依赖、创建配置文件、生成基线)请参考 skills-lint-setup,完整规则参考见 RULES.md。
主要能力:运行 CLI 校验器;读取诊断信息(每条诊断会指出触发的规则、违规值和适用时的修复建议);修复违规;对可修复规则(check-absolute-paths、check-trailing-whitespace、invalid-skill-name)使用 --fix 写回磁盘,配合 --dry-run 预览差异;重新运行确认通过;通过继承 SkillRule 并传入 validateSkills 编写自定义规则。
使用方式:若 skills_lint 在 pubspec.yaml 中,运行 dart run skills_lint -d .agents/skills;若通过 dart install 全局安装,运行 skills_lint -d .agents/skills。完整参数列表见 dart run skills_lint --help 或 skills_lint --help。失败运行的工作流为:运行校验器、读取错误、修复违规(手动或 --fix / --fix --dry-run)、重新运行确认干净。自定义规则需继承 SkillRule,设置 name 与 severity,实现 validate 方法返回 ValidationError 列表,并在 Dart 测试中通过 validateSkills(config: config, customRules: [...]) 接入。
适用场景:维护 AI 智能体技能目录、在 CI 或本地校验技能规范、批量修复常见格式问题、扩展项目专属校验规则。
限制:资料未提供具体默认严重级别、诊断结构细节与可修复性清单,需查阅 RULES.md;首次配置步骤不在本技能范围内;未提供收费、平台或效果信息。