agent-plugins的validate-skill深度使用AI重新生成验证一致性指南【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins什么是 validate-skill用 AI 做技能一致性体检在agent-pluginsFlutter 官方维护的 AI Agent 技能插件仓库中validate-skill是 Skills CLI 内置的一个核心命令。它的原理非常巧妙把原始文档资源重新抓取一遍交给 Gemini 重新生成一份 SKILL.md再与仓库中现有的技能文件对比打分从而验证已有技能是否过时、是否与源头文档保持一致。这套机制的价值在于技能文档由 AI 生成就会随时间和模型版本产生漂移。validate-skill就像给每个技能做了一次一致性回归测试输出 0-100 的 Grade 分数和详细的验证报告。一键安装获取仓库与准备 API KeyStep 1克隆仓库本地操作环境请自行创建目录git clone https://gitcode.com/GitHub_Trending/skills16/agent-pluginsStep 2配置 Gemini API Key必需环境变量export GEMINI_API_KEY你的密钥Step 3确保已安装 Dart SDK即可运行所有 CLI 命令。核心用法三条命令快速上手所有命令统一从仓库根目录执行入口在 tool/generator/ 下场景命令验证全部技能dart run tool/generator/bin/skills.dart validate-skill只验证某个技能dart run tool/generator/bin/skills.dart validate-skill --skill flutter-add-widget-test指定技能目录dart run tool/generator/bin/skills.dart validate-skill --directory ./skills预演不调用 AIdart run tool/generator/bin/skills.dart validate-skill --dry-run--dry-run是最划算的第一步它只抓取资源并统计新旧内容的 token 量不会调用 Gemini、不会写任何文件适合快速评估成本见 base_skill_command.dart 中--dry-run选项定义。验证流程深度拆解AI 如何判断一致性validate-skill的完整流水线源码见 validate_skill_command.dart分为五步配置校验检查 YAML 配置文件——每个技能必须有namekebab-case 命名、description、非空的resources列表且资源 URL 必须使用 HTTPS重新抓取资源把该技能resources里列出的文档页面全部抓下来并转成 Markdown硬性检查比对现有 SKILL.md 中的name:字段是否与配置一致不一致会直接报 Validation Failed: Skill name mismatchAI 打分调用 Gemini默认模型见 gemini_service.dart让它以如果今天重新生成应该是什么样为基准从准确性、结构、完整性三个维度评估现有技能并考虑生成日期、模型版本等因素输出报告结果写入validation/技能名/validation.md日志中同时打印 Grade 分数。其中第 4 步使用的评分提示词写在 prompts.dart 的validateExistingSkillContentPrompt中要求模型在最后一行输出Grade: [0-100]——这就是报告分数的来源。读懂验证报告Grade 分数怎么看每个技能会生成一份独立的验证报告典型内容包含Accuracy / Structure / Completeness三个维度的定性评价扣分原因缺失的内容、模型版本变化、技能生成时间过久more than a few months old等结论与分数最后一行Grade: 85这样的总分。经验法则分数低于 80 的技能建议用update-skill命令重新更新因为它说明源头文档已发生变化现有技能内容已经陈旧。常见问题报错排查清单日志信息原因解决办法GEMINI_API_KEY environment variable not set未配置密钥设置环境变量Configuration file not foundYAML 路径错误默认读取resources/flutter_skills.yaml从仓库根目录运行Skill name mismatchSKILL.md 的 name 与配置不符检查 frontmatter 中的 name 字段Existing skill file not found技能目录缺失先用generate-skill生成resources must not be empty配置中 resources 为空至少提供一个文档 URL配套生态验证、更新与同步闭环validate-skill不是孤立的——它和仓库里的其他命令形成闭环generate-skill从零生成技能update-skill结合现有内容与最新资源更新技能低分时的修复手段update-readme刷新 README.md 中的技能表格sync_skills.dart位于 tool/sync_skills.dart用于技能同步。此外skills_lint.yaml 定义了技能目录的静态检查规则相对路径、绝对路径检查与 validate-skill 的语义级验证互为补充形成格式层 语义层的双重质量保障。写在最后validate-skill体现了一种工程化思路既然技能由 AI 生成就用 AI 来验证 AI。定期跑一次全量验证关注 Grade 分数变化就能让 agent-plugins 中的技能始终保持与官方文档同步也让你的 Flutter Agent 开发工作流始终踩在最佳实践上。 延伸阅读完整命令文档见 tool/generator/README.md测试用例可参考 validate_skills_test.dart其中对每条报错分支都有精确断言是理解命令行为的最佳教材。【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考