用途:该技能用于首次把 skills_lint 接入仓库,完成初始化与配置。日常运行、解读输出和编写自定义规则由 skills-lint-validation 技能负责;CI 工作流与 pre-commit 钩子示例见 README 的 Recipes 部分。
主要能力与用法:
- 添加依赖。在 dev_dependencies 中加入 skills_lint: ^0.5.0。建议尽量把依赖隔离在 tool/ 包中,而不是放在根 pubspec.yaml,以避免 linter 依赖进入运行时闭包。若必须添加到多个 pubspec.yaml,需保证 ref:(提交哈希)完全一致,防止解析结果分叉。
- 创建配置。在仓库根目录创建 skills_lint.yaml,使 CLI 与嵌入式测试调用共享同一配置,例如设置 rules 下 check-relative-paths、check-trailing-whitespace 为 error,并在 directories 中指定 path: ".agents/skills"。默认启用的规则(check-absolute-paths、valid-yaml-metadata、invalid-skill-name、description-too-long)只有在需要修改严重级别时才需列出,完整规则见 RULES.md。
- 生成基线。若接入的仓库已有遗留违规且暂不修复,可运行 dart run skills_lint --skills-directory=.agents/skills --generate-baseline,将当前失败写入忽略文件,使下次运行干净退出;基线之后新增的违规仍会报错。
- 接入 CI。可直接使用 README 中的 GitHub Actions 配方,或使用其下方的 pre-commit 钩子配方。
适用场景:Dart 项目中首次配置 skills_lint、需要统一 CLI 与测试配置、或需在存量仓库中平滑引入校验时。
限制:资料未提供 skills_lint 的完整规则列表、版本兼容范围、其他平台 CI 配置及具体错误信息说明,这些内容暂未提供。