在 Gemini CLI 中启用 Agentic Awesome Skills：安装、验证与提示词实战指南
【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills
Agentic Awesome Skills（AAS）是一个以 Agent 优先设计的技能仓库，通过.gemini/skills/标准路径直接支持 Gemini CLI，将 2,126+ 个可安装技能、捆绑包与工作流带进 Google 生态。本文以该仓库的 Gemini CLI 接入文档为主体，结合安装器源码与核心技能文件，完整讲解从安装、验证到提示词调用的全流程，读完即可在 Gemini CLI 中按任务驱动地启用技能。
Gemini CLI 技能支持概览
Agentic Awesome Skills 对 Gemini CLI 的支持遵循一条简单而关键的约定：技能必须安装到 Gemini CLI 期望的.gemini/skills/路径下。仓库中的技能文件（每个技能目录内均含SKILL.md）本身与工具无关，既包含通用软件工程剧本，也覆盖 AI 系统、集成、基础设施、测试、产品与增长等专业方向，因此安装后 Gemini CLI 可以直接按技能名调用。
该支持路径在安装器源码中有明确对应：在 tools/bin/install.js 的getTargets()函数中，--gemini参数被解析为Gemini CLI目标，目标路径为path.join(HOME, ".gemini", "skills")，即用户主目录下的~/.gemini/skills/。这正是 Gemini CLI 原生扫描技能目录的位置，属于"直接安装到预期技能路径"的设计。
为什么选用此仓库作为 Gemini CLI 技能库
对于正在 GitHub 上评估 Gemini CLI 技能的用户，该仓库是一个覆盖面广的起点，其优势集中在四点：
- 安装即用：直接安装到 Gemini CLI 预期的技能路径，无需手工搬运或配置别名；
- 纵深兼顾：既包含核心软件工程技能，也包含更深层的 Agent/LLM 导向技能（如 RAG、LangGraph、MCP 构建）；
- 低门槛起步：通过捆绑包（Bundles）和工作流帮助新用户快速上手，而不是从 2,126+ 个文件中冷启动；
- 场景灵活：无论你需要一个广泛的内部技能库，还是希望用单个仓库快速测试多种工作流，它都适用。
安装 Gemini CLI 技能
在终端中执行以下命令，安装器会从验证过的发布版本中拉取技能并写入 Gemini CLI 技能路径：
npx agentic-awesome-skills --gemini从源码看，该命令的完整行为链如下（tools/bin/install.js）：
parseArgs()解析--gemini布尔标志（tools/bin/install.js）；getTargets()将目标解析为~/.gemini/skills（tools/bin/install.js）；- 使用
git clone --depth 1 --filter=blob:none --sparse拉取发布版本并执行稀疏检出（sparse-checkout set --cone skills），只物化skills/目录（tools/bin/install.js、tools/bin/install.js）； - 将每个技能复制为
<目标路径>/<技能名>/布局，并写入安装清单（manifest）用于后续增量更新与过期清理（tools/bin/install.js、tools/bin/install.js）。
安装默认需要 Git 2.25+（支持部分克隆与稀疏检出）以及 Node.js 22+（见 package.json）。由于--gemini属于"已验证目标"之一，直接安装完整技能集不会触发 Antigravity 目标那种强制选择校验，但仓库仍建议在可能影响宿主上下文容量时使用选择器缩小范围。
验证安装
安装完成后，用下面命令确认技能已落在预期路径（项目级或用户级任一存在即可）：
test -d .gemini/skills || test -d ~/.gemini/skills若输出无错误（退出码为 0），说明.gemini/skills目录存在；你也可以进一步列出目录内容核对技能：
ls ~/.gemini/skills | head更精细的安装选项
实际使用中，安装器还提供了一批与 Gemini CLI 安装组合使用的选择器（均见 tools/bin/install.js 的帮助文本与参数解析实现）：
| 选项 | 作用 | 示例 |
|---|---|---|
--skills <csv> | 只安装指定技能（支持技能名、id 或嵌套路径） | npx agentic-awesome-skills --gemini --skills brainstorming,prompt-engineering |
--risk <csv> | 按风险标签过滤（如safe,none） | npx agentic-awesome-skills --gemini --risk safe,none |
--category <csv> | 按类别过滤 | npx agentic-awesome-skills --gemini --category development,backend |
--tags <csv> | 按标签过滤，-后缀表示排除 | npx agentic-awesome-skills --gemini --tags debugging,typescript-legacy- |
--dry-run | 只预览安装/更新/移除计划，不写入任何文件 | npx agentic-awesome-skills --gemini --skills brainstorming --dry-run |
--release <ver> | 安装指定 npm 发布版本并校验其公开 Git 提交 | npx agentic-awesome-skills --gemini --release 17.4.0 |
--path <dir> | 安装到自定义目录 | npx agentic-awesome-skills --path .gemini/skills |
例如，仅安装五个入门技能并先预览计划：
npx agentic-awesome-skills --gemini --skills brainstorming,prompt-engineering,rag-engineer,langgraph,mcp-builder --dry-run安装器在--dry-run下会打印精确技能集合与每个目标的变更计划，且明确承诺"不会创建、修改或删除任何文件"，适合在正式安装前审查。
Gemini CLI 的最佳入门技能
仓库文档推荐以下五个技能作为 Gemini CLI 用户的首选，每个技能目录都包含一份结构化的SKILL.md（含name、description、risk等 frontmatter 元数据，供 Agent 按需加载）：
brainstorming: 把模糊目标转化为更清晰的实现规范。其SKILL.md明确要求以"设计促进者"身份工作——逐个提问、锁定理解、显式记录假设与决策日志，在实现之前产出经验证的规格（skills/brainstorming/SKILL.md）；prompt-engineering: 提高提示质量与任务框架。系统覆盖少样本学习、思维链、提示优化、模板化系统与系统提示词设计等模式，并提供"渐进式披露"与"指令层级"等可操作框架（skills/prompt-engineering/SKILL.md）；rag-engineer: 构建与评估检索系统。覆盖嵌入模型选型、向量数据库、分块策略、混合检索与重排，强调"检索质量决定生成质量"（skills/rag-engineer/SKILL.md）；langgraph: 设计有状态的代理工作流。覆盖图拓扑、状态管理与 reducer、循环与分支、checkpointer 持久化、人在回路（human-in-the-loop）以及 ReAct 代理模式（skills/langgraph/SKILL.md）；mcp-builder: 添加工具集成与外部能力。以四阶段工作流指导如何创建高质量 MCP 服务器，平衡 API 覆盖与工作流工具设计（skills/mcp-builder/SKILL.md）。
五个技能的风险标签均可从各自SKILL.md的 frontmatter 读取（如brainstorming为risk: critical，prompt-engineering为risk: none），这正好对应安装器--risk过滤器的数据来源——安装器通过readSkill()读取每个技能的元数据并按风险/类别/标签做匹配（tools/bin/install.js）。
Gemini CLI 提示词示例
安装完成后，在 Gemini CLI 对话中以@技能名语法引用技能即可。文档给出的三个可直接复制的示例：
使用 @prompt-engineering 改进这个编码助手的系统提示词。使用 @langgraph 为支持分类设计一个有状态的代理工作流。使用 @mcp-builder 规划 GitHub + Slack 集成所需的工具。结合仓库的通用使用指南（docs_zh-CN/users/usage.md），Gemini CLI 场景下更完整的调用方式为：
使用 brainstorming 技能帮助我规划这个应用几个进阶用法可以显著提升效果：
- 指定文件路径：
使用 @lint-and-validate 检查 src/components/Button.tsx——特定技能 + 特定文件 = 精确结果； - 组合技能：
使用 @brainstorming 设计支付流程，然后应用 @stripe-integration 实现它——在同一提示中按顺序链接多个技能； - 按角色选技能：Web 开发可组合
@frontend-design、@react-best-practices、@tailwind-patterns、@seo-audit；安全方向则组合@api-security-best-practices、@vulnerability-scanner等。
使用技巧与注意事项
- 一次只应用一个技能：安装后先保持活跃集较小，针对面前的任务选择清晰的工作流导向技能，效果最佳；
- 控制活动集规模：如果 Gemini CLI 在几轮对话后开始挂起，请开启新对话，并暂时将活动集减少到 2~5 个技能，排除上下文持续增长的问题（docs_zh-CN/users/usage.md）；
- 按需加载而非全量注入：即使本地安装了全部 2,126+ 个技能，也不应将每个
SKILL.md都塞进系统提示词。预期模式是：用根目录 skills_index.json 作为规范清单发现技能，仅为当前对话实际使用的@技能名加载对应的SKILL.md文件； - 安装后识别失败时：重启 Gemini CLI，确认安装路径确为
~/.gemini/skills，或使用显式命令重新安装。
下一步操作
- 想要按角色划分的更小的精选子集，请从 捆绑包指南 开始；
- 正在比较通用代理技能库，请阅读 ai-agent-skills.md；
- 想要更多在真实提示词中调用技能的示例，请使用 usage.md；
- 需要完整的端到端流程，可进一步参考 工作流指南 与 技能目录。
【免费下载链接】agentic-awesome-skillsAAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,600+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/GitHub_Trending/an/agentic-awesome-skills
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
