agent-plugins 配置实战skills_lint.yaml 从全局规则到目录级覆盖完整指南【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-pluginsagent-plugins是 Flutter 团队维护的一组 AI Agent 插件集合核心作用是为 AI 编程助手安装标准化的 Flutter / Dart 开发技能Skills让助手可靠地遵循最佳实践完成任务。这套插件自带名为skills_lint的技能校验系统而 tool/generator/skills_lint.yaml 就是控制它的核心配置文件。本文将带你搞懂它如何从「全局规则」一路覆盖到「目录级配置」三步即可上手。一、skills_lint.yaml 是什么为什么需要它简单说skills/目录下每个技能如 skills/dart-use-ffigen/、skills/flutter-add-widget-test/都是一份给 AI 的操作说明书。技能数量一多难免出现路径写错、格式不统一等问题。skills_lint就是专门给这些技能做体检的校验器而skills_lint.yaml就是它的体检标准。它的完整依赖与入口在这里定义tool/generator/pubspec.yaml引入skills_lint包、tool/generator/test/lint_skills_test.dart校验的测试入口。 记忆口诀YAML 文件定规则skills 目录放技能测试负责跑校验。二、全局规则一次定义处处生效打开配置文件结构非常简洁skills_lint: rules: check-relative-paths: error check-absolute-paths: error directories: - path: ../../skills其中最上层的rules节点就是全局规则——在这里声明的规则会对所有被校验的目录统一生效。以仓库当前配置为例规则名级别作用check-relative-pathserror技能内引用的路径必须是相对路径check-absolute-pathserror禁止出现绝对路径这里的error表示一旦违反就判为失败保证 CI 阶段能第一时间拦住问题。三、目录级覆盖给不同技能区量身定做真正体现从全局到目录级的关键是directories节点。每一个列表项都通过path字段圈定一个具体目录本仓库指向../../skills也就是仓库根目录下的 skills/ 技能集合directories: - path: ../../skills它的意义在于分层全局层rules所有目录共享的基线规则改动一处、全局生效目录层directories[].path可以针对某个技能目录追加或覆盖规则实现个别目录特殊对待。也就是说当你有一批新技能只想放宽某条规则、或某目录需要额外严格时不必污染全局配置——在对应的directories条目下单独声明即可这就是目录级覆盖的价值。四、三步上手从零跑通一次技能校验第 1 步确认配置文件就位。校验器默认在当前目录读取skills_lint.yaml测试代码 tool/generator/test/lint_skills_test.dart 会先检查该文件存在并确认config.directoryConfigs不为空。第 2 步明确校验范围。通过path把范围对准skills/目录确保校验的是你想要的那批技能。第 3 步执行校验。进入 tool/generator/ 目录按 tool/generator/README.md 的说明运行dart analyze dart testdart test会触发 lint 校验把技能里不符合规则的地方以日志形式列出帮你快速定位问题。五、避坑清单新手最容易踩的 3 个坑路径写错导致校验找不到技能——path是相对当前目录计算的../../skills表示从tool/generator/向上两级再进skills改动前请先确认相对关系。误以为目录层会删除全局规则—— 目录级是追加/覆盖而非替换全局基线仍然生效。把error改成warning来绕过问题—— 这会让 CI 静默放行建议先修好技能内容本身而不是降低规则等级。⚠️小结skills_lint.yaml用全局规则 目录级覆盖的两层设计让一套技能既能有统一的质量底线又能为个别目录保留灵活性。掌握它你就能在 agent-plugins 中快速、可靠地新增和维护任何 Flutter / Dart 技能。相关文件速查配置文件tool/generator/skills_lint.yaml校验测试tool/generator/test/lint_skills_test.dart技能集合skills/工具说明tool/generator/README.md【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 agent-plugins 配置实战：skills_lint.yaml 从全局规则到目录级覆盖完整指南
agent-plugins 配置实战skills_lint.yaml 从全局规则到目录级覆盖完整指南【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-pluginsagent-plugins是 Flutter 团队维护的一组 AI Agent 插件集合核心作用是为 AI 编程助手安装标准化的 Flutter / Dart 开发技能Skills让助手可靠地遵循最佳实践完成任务。这套插件自带名为skills_lint的技能校验系统而 tool/generator/skills_lint.yaml 就是控制它的核心配置文件。本文将带你搞懂它如何从「全局规则」一路覆盖到「目录级配置」三步即可上手。一、skills_lint.yaml 是什么为什么需要它简单说skills/目录下每个技能如 skills/dart-use-ffigen/、skills/flutter-add-widget-test/都是一份给 AI 的操作说明书。技能数量一多难免出现路径写错、格式不统一等问题。skills_lint就是专门给这些技能做体检的校验器而skills_lint.yaml就是它的体检标准。它的完整依赖与入口在这里定义tool/generator/pubspec.yaml引入skills_lint包、tool/generator/test/lint_skills_test.dart校验的测试入口。 记忆口诀YAML 文件定规则skills 目录放技能测试负责跑校验。二、全局规则一次定义处处生效打开配置文件结构非常简洁skills_lint: rules: check-relative-paths: error check-absolute-paths: error directories: - path: ../../skills其中最上层的rules节点就是全局规则——在这里声明的规则会对所有被校验的目录统一生效。以仓库当前配置为例规则名级别作用check-relative-pathserror技能内引用的路径必须是相对路径check-absolute-pathserror禁止出现绝对路径这里的error表示一旦违反就判为失败保证 CI 阶段能第一时间拦住问题。三、目录级覆盖给不同技能区量身定做真正体现从全局到目录级的关键是directories节点。每一个列表项都通过path字段圈定一个具体目录本仓库指向../../skills也就是仓库根目录下的 skills/ 技能集合directories: - path: ../../skills它的意义在于分层全局层rules所有目录共享的基线规则改动一处、全局生效目录层directories[].path可以针对某个技能目录追加或覆盖规则实现个别目录特殊对待。也就是说当你有一批新技能只想放宽某条规则、或某目录需要额外严格时不必污染全局配置——在对应的directories条目下单独声明即可这就是目录级覆盖的价值。四、三步上手从零跑通一次技能校验第 1 步确认配置文件就位。校验器默认在当前目录读取skills_lint.yaml测试代码 tool/generator/test/lint_skills_test.dart 会先检查该文件存在并确认config.directoryConfigs不为空。第 2 步明确校验范围。通过path把范围对准skills/目录确保校验的是你想要的那批技能。第 3 步执行校验。进入 tool/generator/ 目录按 tool/generator/README.md 的说明运行dart analyze dart testdart test会触发 lint 校验把技能里不符合规则的地方以日志形式列出帮你快速定位问题。五、避坑清单新手最容易踩的 3 个坑路径写错导致校验找不到技能——path是相对当前目录计算的../../skills表示从tool/generator/向上两级再进skills改动前请先确认相对关系。误以为目录层会删除全局规则—— 目录级是追加/覆盖而非替换全局基线仍然生效。把error改成warning来绕过问题—— 这会让 CI 静默放行建议先修好技能内容本身而不是降低规则等级。⚠️小结skills_lint.yaml用全局规则 目录级覆盖的两层设计让一套技能既能有统一的质量底线又能为个别目录保留灵活性。掌握它你就能在 agent-plugins 中快速、可靠地新增和维护任何 Flutter / Dart 技能。相关文件速查配置文件tool/generator/skills_lint.yaml校验测试tool/generator/test/lint_skills_test.dart技能集合skills/工具说明tool/generator/README.md【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考