
agent-plugins AI技能生成实战从Flutter官方文档一键产出SKILL.md的完整指南【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-pluginsagent-plugins 是 Flutter 官方团队维护的 AI 智能体插件集合内置一条完整的AI 技能生成流水线只需在 YAML 里列出 Flutter 官方文档地址工具就会自动抓取文档、调用 Gemini 大模型一键产出结构规范的SKILL.md技能文件让 AI 智能体像专家一样写 Flutter 代码。本文带你从零跑通这条流水线。agent-plugins 是什么一句话概括它把AI 会用 Flutter这件事打包成了可复用的技能包。一个插件 Skills技能 MCP 配置 Rules规则Skills教智能体怎么做某件具体事每个技能就是一个文件夹加一个 SKILL.mdskills/ 目录下共有 24 个现成技能覆盖 Widget 测试、集成测试、路由、本地化、HTTP 请求等场景⚙️Rules定义自动化触发行为例如 rules/flutter-hot-reload.md 会在你修改lib/下的.dart文件后自动触发热重载MCP 配置给智能体接上专业工具而本仓库真正硬核的地方是 tool/generator/ 下的Skills CLI——一个能把外部文档网站喂给 Gemini、再吐出SKILL.md的技能生成器。核心原理文档是如何变成技能的整条流水线分四步逻辑清晰读取配置从 YAML 文件解析出技能清单名称、描述、文档来源列表抓取资源resource_fetcher_service.dart 负责拉取 URL 或本地文件markdown_converter.dart 再把 HTML 转成干净的 MarkdownAI 重写generate_skill_command.dart 把抓取到的内容交给 Gemini提示词见 prompts.dart落盘输出为每个技能创建独立文件夹写入SKILL.md生成的技能并非随意发挥。系统提示词 skill_instructions.dart 内嵌了一整套技能作者最佳实践祈使句写指令、H1 标题用动名词、长内容用折叠标签、复杂任务配任务进度清单——所以产出的文件质量高度稳定。快速上手3 步完成 AI 技能生成第 1 步获取项目git clone https://gitcode.com/GitHub_Trending/skills16/agent-plugins第 2 步配置 Gemini API 密钥工具依赖 Gemini 模型必须设置环境变量export GEMINI_API_KEY你的密钥第 3 步运行生成命令在仓库根目录执行入口脚本为 tool/generator/bin/skills.dartdart run tool/generator/bin/skills.dart generate-skill常用参数参数作用--skill flutter-layout只生成指定名称的技能-d ../skills/指定输出目录默认../skills/--dry-run演练模式只显示将生成的内容和 token 数不写文件建议先跑一次--dry-run确认文档抓取量和 token 规模后再正式生成。YAML 配置用 5 行声明一个技能所有技能都声明在配置文件默认resources/flutter_skills.yaml中格式极简- name: flutter-layout description: 布局技能描述 resources: - https://docs.flutter.dev/ui/widgets/layout - https://docs.flutter.dev/ui/layoutresources里既可以填文档 URL也可以填本地文件路径——把网页文档 源码注释混在一起喂给模型技能会更扎实。四大命令覆盖技能的完整生命周期命令用途适用场景generate-skill从零生成技能初次建设技能库update-skill结合新文档增量更新已有技能官方文档改版后validate-skill重新生成并对比打分0-100 分测试提示词效果、回归校验update-readme把技能清单自动写回根目录 README 表格每次新增技能后其中update-skill和validate-skill支持--thinking-budget参数默认 2048用来调节模型生成前的思考token 预算预算越高模型斟酌越充分适合对质量要求苛刻的技能。validate-skill的评分逻辑见 prompts.dart它会从内容缺失、模型变更、文档过期等维度给出扣分理由是天然的技能质量仪表盘。质量保证不止有生成器自动化测试tool/generator/test/ 覆盖命令解析、Markdown 转换、抓取服务等核心模块静态检查配合 skills_lint.yaml 与dart analyze保证代码规范Dart 技能同步tool/sync_skills.dart 是一个独立脚本通过对比 Git 提交哈希把 Dart 官方仓库的技能增量同步进来无变化时直接跳过以节省 CI 时间写在最后agent-plugins 的价值不在于又一个 Flutter 插件而在于它展示了AI 技能工程化的完整范式文档是原料、大模型是编译器、YAML 是构建脚本、评分系统是质检环节。当你想让智能体稳定掌握任何一门技术栈时照抄这套流水线即可。完整命令参考见 tool/generator/README.md上手成本几乎为零。【免费下载链接】agent-plugins项目地址: https://gitcode.com/GitHub_Trending/skills16/agent-plugins创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考