它是什么

AAS Core（Agentic Awesome Skills）是一个本地优先、以 agent 为中心的技能控制面（control plane）与技能目录库。它本身不是一个替你写代码的 agent，而是给 Codex、Claude 这类编码 agent 提供一套可检索、可校验、可复用的技能（Skill）资源，以及围绕「选技能 → 组栈 → 校验 → 出计划」的只读工作流。仓库自述收录 2,115+ 个 agentic skills，当前发布版本为 V17.1.0。

理解它的关键，在于把握项目反复强调的一个设计取向：选型权归 agent，工具不替 agent 做决定。AAS Core 明确声明自己不排序、不推荐技能，只提供完整的本地目录供 agent 检索阅读，并用只读工具校验 agent 自己挑出来的那套组合是否成立。这解决的是随着技能数量膨胀后出现的新问题——不是「找不到技能」，而是「怎么在成百上千个技能里确定一套确切、可复核、可复现的组合」。

仓库存放的可复用 SKILL.md 剧本、专用插件、bundle、workflow 与直接安装器，构成围绕 AAS Core 的内容层、策展层、分发层与兼容层。它们并不是与核心竞争的独立产品，而是被核心组织起来、可被检索与装配的素材。这是一个独立社区项目，与 Google 无隶属、赞助、背书或授权关系；Google、Antigravity、Gemini 等名称仅用于描述兼容性与安装目标。

核心功能 / 内容清单

• 完整本地目录检索（catalog discovery）：agent 搜索并读取完整的本地技能目录，而不是只看摘要或精选列表。当你面对上千条技能时，「完整」比「精选」更重要，因为抽样会直接造成漏选。
• AAS MCP（本地、只读）：以本地 stdio 形式暴露 MCP 接口供 agent 调用，且为 read-only。只读是关键约束——它保证在你看过方案之前，工具不会自作主张改动项目。
• compose_stack 只读校验工具：接收 agent 选定的技能 ID 组合，在内存中完成组合校验，随后即丢弃。它不做排名、不做推荐，只回答「这个组合是否成立」。
• CLI 与 aas-stack.json 清单：由客户端或 aas CLI 把选定的组合持久化为 aas-stack.json，并可附带可选证据（evidence），再生成一份不可变（immutable）的计划预览供人工复核。
• 可复用内容与分发层：SKILL.md 剧本、专用插件、bundle、workflow 以及直接安装器，负责技能的具体内容、策展、分发与兼容适配。
• Workbench 与托管目录：面向浏览器本地的发现与审阅界面，属于辅助性的浏览与复核入口，并非托管控制面。

典型使用场景

场景一：接手一个不熟悉的项目，需要快速装配一套可用技能。 流程是：由 Codex 或 Claude 检查你的项目（注意这一步不是 AAS 在做）→ agent 检索并阅读完整的本地目录 → 通过只读 MCP 获取候选 → agent 自行选出确切的技能 ID → compose_stack 在内存中校验该组合 → 客户端或 CLI 落盘 aas-stack.json → CLI 执行 validate 并生成不可变计划预览 → 人工复核（可选在 Workbench 中）→ 之后才谈得上做改动。这条链路的价值在于：变更之前先有一份可读、可审、冻结的计划。

场景二：团队内部复用并评审一套标准化技能组合。 因为选择结果会落成 aas-stack.json 这样的清单文件，它可以像配置文件一样进入代码评审流程。团队成员能看清「这次打算启用哪些技能、依据是什么」，而不可变的计划预览则让复核发生在实际动作之前，避免技能被静默引入。

场景三：技能资产盘点与选型调研。 当你需要确认某个能力是否已有现成技能、多个技能组合在一起是否会冲突时，可以直接用完整目录检索配合只读 MCP 做核对，而不必逐个翻阅仓库文件。

适合谁用

• 使用 Codex / Claude 等编码 agent 的开发者：需要一个受控、可复核的技能来源，而不是让 agent 随意上网找招数。
• 团队的平台或工具链维护者：需要把「项目用哪些技能」变成可评审、可版本化的清单。
• 做 agent 生态调研与选型的技术决策者：可直接以 2,115+ 技能的目录规模作为观察样本，理解 SKILL.md 这一封装形态的实际生态。
• 相对不适合的人：期待开箱即用、全自动改代码的流水线用户。apply 与 recovery 仍属实验性，明确位于受支持的预览路径之外。

快速上手

大致路径是：从 GitHub 仓库获取资源（该仓库为 canonical，即权威来源）→ 阅读随版本发布的 AAS Core 预览指南（docs/users/aas-core.md，对应 v17.1.0）→ 将本地只读 MCP 以 stdio 方式接入 Codex 或 Claude → 用 aas CLI 完成 validate 与计划预览。安装命令、具体配置片段与参数细节请以官方 README 与该版本化指南为准，不同版本之间存在差异。

注意事项

• 发行状态要分清：catalog 检索、agent 选型、manifest 校验、planning、诊断属于受支持的预览能力；apply 与 recovery 是实验性的，不在受支持路径内。
• 版本与分支差异：README 跟踪的是 main 分支，而部分变更（如完整 bundle 检查、Workbench 证据导入、稀疏安装器获取）需要等后续版本发布才可用；请以对应版本号的指南为准。
• 工具不背书选择结果：AAS Core 不做排序与推荐，选型责任落在 agent 和使用者身上，校验通过不等于选择合理。
• 只读是设计边界：MCP 与 compose_stack 均为只读，真正的持久化由客户端或 CLI 完成，便于在改动前留出人工复核环节。
• 品牌与归属：项目为独立社区项目，与 Google 无关；相关产品名仅用于说明兼容性与安装目标。托管目录与 Workbench 是辅助的发现审阅界面，不是托管控制面。
• 协议：MIT，可自由使用与修改，但请留意各技能条目自身可能附带的额外条款。