企业官网建设流程全解析

Antigravity Skills 是面向 Google Antigravity 的技能库（Skill Vault），收录了 307 个即装即用的 Agent Skills。很多新手一上来就执行install --all，结果 Token 越烧越多、技能误触发频发——而老手都只按需安装。本文详解 Antigravity Skills 省 Token 的 3 种精准安装策略（单技能、标签、Bundle），并附官方 5 个 Bundle 的选型对照表，帮你花最少的 Token 获得最强的 AI 编程助手。

一、为什么 install --all 是新手最贵的操作？

install --all并不是不能用，而是代价很高。理解它的代价，是省 Token 的第一步。

1. 每次会话都要为 307 份元数据"买单" 💸

Antigravity 的机制是：会话启动时，自动加载所有已安装技能的元数据（名称 + 描述），而不是技能正文。

每个技能的SKILL.md都带有一段 frontmatter 描述，例如 skills/python-pro/SKILL.md：

--- name: python-pro description: Master Python 3.12+ with modern features, async programming... ---

这几十个字 × 307 个技能，意味着你每一次新开会话，还没干活，上下文窗口就先被一大片"菜单"占满了。技能装得越多，固定成本越高。

2. 自动激活的"误伤"率直线上升 ⚠️

Antigravity 会根据你的提问自动匹配并激活描述相符的技能。菜单越大，误触发概率越高：

• 你只是想写个 FastAPI 接口，kubernetes-architect也插了一嘴；
• 你在问 SQL 索引，incident-responder居然被唤醒了。

官方 README 对此有明确说明：技能越多，"token 消耗越多 + 无关技能被误触发的概率越高"，见 README.md。

3. 官方 CLI 的"黄色警告"

在 bin/cli.js 中，只要触发--all，CLI 会立刻打印警告：

Warning: Installing all skills increases token usage and activation noise.

README 里对这条命令的官方定性是："advanced and not recommended for most projects（高级用法，不推荐大多数项目）"，见 README.md。

一句话总结：--all省了一次敲命令的功夫，却让之后的每一次会话都在为 307 份菜单付 Token 账。

二、老手的决策树：先想清楚再装技能

在敲下任何install命令之前，先问自己三个问题：

我只需要一个明确的能力？ → 方式①：单技能安装 我这个方向（K8s / 安全 / 数据）要系统性地做？ → 方式②：Bundle 安装 我想按关键词批量圈定一批相关技能？ → 方式③：标签安装

💡 注意：CLI 强制一次只能选一种方式——技能名、--all、--tag、--bundle四选一，见 bin/cli.js。这其实是在帮你避免"装多了"。

三、3 种省 Token 的精准安装方式

方式①：单技能安装——按需取用，Token 最低

先用搜索确认目标，再精准安装，装完立即验证。这是新手最该养成的习惯：

# 1️⃣ 先搜，看看有什么 npx @rmyndharis/antigravity-skills search kubernetes # 2️⃣ 只装当前需要的这一个 npx @rmyndharis/antigravity-skills install kubernetes-architect # 3️⃣ 验证已装技能 npx @rmyndharis/antigravity-skills installed

小技巧：长技能名有**别名（alias）**可用，aliases.json 里维护了短名到完整 ID 的映射，例如输入full-stack-feature实际安装的是full-stack-orchestration-full-stack-feature。

方式②：Bundle 安装——官方精选组合，闭眼入

Bundles.json 内置了 5 个官方精选组合，都是"去重 + 精选"过的成套能力。各 Bundle 规模一览（当前版本）：

一条命令安装整个方向：

# 按 Bundle 安装 npx @rmyndharis/antigravity-skills install --bundle k8s-core # 也可以全局安装（所有项目可用） npx @rmyndharis/antigravity-skills install --bundle security-core --global

为什么 Bundle 比--all强？因为它替你做完了筛选：比如k8s-core只装了 17 个真正相关的技能，而不是把 307 个全塞给你。

方式③：标签安装——按主题批量圈定

技能都带 tags 和 triggers，可以用--tag按主题圈一批：

# 安装所有 kubernetes 标签的技能（标签可重复传递） npx @rmyndharis/antigravity-skills install --tag kubernetes

适合"我要把某个方向的相关技能一次配齐"的中间态需求：比单技能省事，比 Bundle 更灵活。

四、3 步上手：搜索 → 安装 → 验证

把上面三种方式串起来，就是一个完整的省 Token 工作流：

Step 1：搜索定位（支持多关键词，全部命中才算匹配，见 skills_cli.py 的匹配逻辑）

npx @rmyndharis/antigravity-skills search fastapi testing

Step 2：选择安装范围（单技能 / 标签 / Bundle 三选一）

npx @rmyndharis/antigravity-skills install fastapi-pro

Step 3：验证 + 重启会话（关键！）

npx @rmyndharis/antigravity-skills installed

⚠️装完技能必须重启 agent 会话，Antigravity 才会重新扫描并加载新技能。这一点在 CLI 结尾提示和 README 中都有强调，见 README.md。

安装位置速查（来源：bin/cli.js）：

五、老手避坑清单：6 条黄金法则

1. 从少到多，滚动添加🌱：先装 1 个技能跑通流程，遇到新需求再加，绝不一步到位。
2. 项目级优先于全局：工作区技能随项目走，不污染其他项目的上下文；只有bash-pro、sql-pro这类通用能力才值得--global。
3. Bundle 是"精选套餐"，不是"全部"：5 个 Bundle 合计覆盖约 200 个技能位（有重叠），依然远少于 307。
4. 每次装完跑一遍installed：确认实际落盘的技能列表和你预期一致。
5. 装错了别慌，update管更新：单个技能用update <skill>升级，全部升级用update，见 README.md。
6. --all留给"评测基准"场景：除非你在做技能库本身的测试（可参考 tests/cli-install.test.js 里的用法），否则永远不要在生产工作流里敲它。

六、FAQ：3 个高频疑问

Q1：装过的技能不触发时，会一直占 Token 吗？会。占 Token 的是元数据（名称+描述），它在会话启动时就全部加载，与是否触发无关。这就是"少装 = 省"的根本原因。

Q2：Bundle 和技能名可以同时指定吗？不行。CLI 明确报错 "Choose only one of skill name, --all, --tag, or --bundle"，四选一（bin/cli.js）。

Q3：如何浏览所有 307 个技能再决定装哪个？两个入口：人类可读的索引 CATALOG.md（按分类分组，含描述/标签/触发词），机器可读的 catalog.json（search命令的数据源）。

七、总结：省 Token 就记一句话

Antigravity Skills 的最佳安装姿势 = 先 search 定位，再"单技能 / 标签 / Bundle"三选一，装完重启会话。

install --all看似一步到位，实则是把 307 份"菜单"永久挂在了你的每次会话里。老手的 Token 账单之所以好看，靠的不是魔法，而是按需安装这四个字。