技能 CLI（skills） Skill 技能

技能简介

skills（Dart Skills CLI）是由 Dart 官方团队维护并发布的命令行工具，用于把 Dart 与 Flutter 包依赖中自带的 AI Agent Skill 直接安装进你的 AI 编程助手。它由 Serverpod 团队最初开发，1.0 版本起正式交由 Dart 团队维护。核心思路是：让包作者把结构化的技能说明随代码一起发布，用户只需运行一条命令，AI 助手就能读懂项目里的每一个依赖，从而解决「AI 不认识你的技术栈、凭空猜测 API」的长期痛点。

核心能力

• 依赖技能自动发现：扫描项目 pubspec 中的依赖树，找出每个包内置的 skills/ 目录，并按正确的 Agent 目录结构安装。
• 多 Agent 兼容：安装后的技能可被 Antigravity、Claude、Codex、Cursor 等主流 AI 编程助手读取使用。
• Git 仓库安装：支持通过 add 命令从任意 Git 仓库安装技能，与 npx skills 用法几乎完全一致。
• 版本精确匹配：技能随包版本一起分发，保证你使用的技能说明与项目中实际依赖的版本严格对应。
• 一键批量安装：使用 --all 参数可跳过交互提示，一次性安装全部可用技能，适合在 CI 或脚本中调用。
• 清理与修剪：prune 命令会自动移除已从依赖树中删除的包对应的技能，保持 Agent 配置整洁。
• 团队技能共创：create 命令允许包作者为自己的包创建技能，随包一起发布给用户使用。

安装配置

• 环境要求：需安装 Dart 或 Flutter SDK，无需预先安装 Node.js，避免了对 npx 的依赖。
• 无需全局安装：直接使用 dart run skills@ 前缀即可调用，Dart 会自动拉取并运行该包。
• Git 支持（可选）：若要从 Git 仓库安装技能，需要本机安装 Git 并加入 PATH，否则会提示并仅使用 Dart 包技能。
• 版本控制建议：若不对 Agent 配置目录做版本控制，应把 .config/dart_skills 加入 .gitignore。

使用步骤

1. 进入你的 Dart 或 Flutter 项目根目录，确认依赖已配置在 pubspec 中。
2. 运行 dart run skills@ get，工具会自动执行 pub get 并扫描依赖中的技能。
3. 在弹出的对话中勾选想安装的技能，或直接加 --all 参数安装全部技能。
4. 如需从 Git 仓库获取技能，运行 dart run skills@ add 添加来源。
5. 完成后 AI 助手即可读取对应技能；后续再次运行 get 会检查已添加仓库的技能更新。
6. 需要清理时，运行 dart run skills@ prune 移除已失效的技能。

适用场景

• 使用 Flutter 或 Dart 后端框架（如 Serverpod）开发，希望 AI 助手准确理解框架 API。
• 团队统一 AI 编程规范，把内部技能包分发给所有成员。
• 在脚手架项目或多包 monorepo 中为所有子包批量安装技能。
• 从 skills.sh 等技能聚合站安装通用技能，但不想额外安装 Node 环境。
• 需要在 CI 流程中自动为 Agent 注入技能上下文。

适用人群

主要面向 Dart 与 Flutter 开发者、维护多包项目的团队，以及希望让 AI 编程助手更懂自己技术栈的工程人员。

工作原理

Dart 包可以在顶层放置 skills/ 目录，其中包含遵循 Agent Skills 规范的 SKILL.md 等结构化指令文件。skills CLI 会根据当前项目依赖，遍历依赖树寻找这些目录，并按照不同 AI 助手的约定路径把技能写入对应的 Agent 配置目录。它同时支持从 Git 仓库抓取技能，爬取时会忽略 third_party 目录与以点开头的隐藏目录。整个过程基于 Dart 原生能力实现，做到「开箱即用」，无需 Node 或 NPX。

官方链接

pub.dev 包地址：https://pub.dev/packages/skills