sickn33/agentic-awesome-skills

AAS Core – 智能体酷技能（AAS）

是什么

• 一个库和命令行工具，允许大型语言模型代理（如 OpenAI Codex、Anthropic Claude）搜索本地目录中的 2,115+ 个可复用的“技能”剧本，选择项目所需的精确技能 ID，并生成一个机器可读的清单（aas-stack.json），记录这些选择。
• 核心组件是只读的：它验证所选技能的 ID 和结构，但不进行排名、推荐或执行。一个独立的 CLI 可以预览不可变的计划，并可选择性地将技能写入本地目录。

为何重要

• 代理在对代码库采取行动时，通常需要具体的指令（如 "头脑风暴"、"系统性调试"）。AAS 提供了一个稳定、可检查的真相来源，使得同一组指令可以被审查、版本控制，并在以后重现。
• 所有目录文件均为纯文本（SKILL.md），因此无需运行任何代码即可检查，保持工作流安全且离线。

核心概念

概念	作用
目录	包含 SKILL.md 文件的目录，每个文件描述一个可复用的指令集。
MCP（模型-控制平面）	一个本地、只读的服务，暴露 search_skills、get_skill、compose_stack 等命令，供 LLM 调用。
代理拥有组合	LLM（Codex 或 Claude）决定使用哪些技能 ID；AAS 仅验证列表。
aas-stack.json	记录目标项目所选技能 ID 的 JSON 清单。
选择证据	可选的侧车文件（aas-selection-evidence.json），记录每个技能被选择的原因。
CLI	aas stack validate 检查清单；aas stack plan 创建只读计划；aas stack install-preview 可干运行直接安装器。
工作台	仅浏览器的 UI，加载清单和计划供人工审查；从不写入文件系统。

典型工作流程

1. 配置本地 MCP（预览指南说明如何启动）。
2. 让 LLM（Codex/Claude）检查你的仓库，并使用 MCP 搜索相关技能。
3. 模型返回技能 ID 列表（如 brainstorming、systematic-debugging）。
4. MCP 运行 compose_stack 以验证这些 ID 是否存在且符合结构限制（最多 128 个技能）。
5. 客户端或 aas CLI 写入 aas-stack.json（并可选写入证据文件）。
6. 运行 aas stack validate 以再次检查清单，然后运行 aas stack plan 以查看目标的不可变计划。
7. （可选）使用直接安装器（npx agentic-awesome-skills … --dry-run）预览将选定的技能目录复制到 ~/.agents/skills。
8. 人工批准后，重复安装命令不带 --dry-run 以实际部署技能。

安装与入口点

• npm 包：npm exec --yes --ignore-scripts --package=agentic-awesome-skills@<version> -- agentic-awesome-skills …
• npx 快捷方式：npx agentic-awesome-skills --skills <逗号分隔列表> --dry-run（预览）或 --antigravity 用于 Antigravity 风格目标。
• GitHub CLI（预览）：gh skill preview … / gh skill install … 用于单个技能。
• 安装器执行仓库的浅层部分克隆，验证提交哈希与 npm 包元数据一致，并仅复制请求的技能目录。

专用插件

• 仓库附带预打包的插件包（如 Web App Builder、Security Engineer、DevOps & Cloud），将特定领域的相关技能分组。
• 插件以 Claude-Code 和 Codex 兼容格式生成，并公开标准的 Agent Plugins 1.0 清单。

安全与限制

• AAS 不执行任何技能代码；仅复制文件。
• 核心不认证语义适用性——LLM 的选择可能仍不适合你的环境。
• 某些技能被标记为 关键 或 攻击性；安装器会打印风险摘要，并要求显式同意（--all）才能拉取完整目录。
• 应用/恢复功能标记为 实验性，在支持的预览中已禁用。

何时使用

• 你拥有 LLM 驱动的开发流水线，希望获得一个可重现、可审计的指令列表，供模型执行。
• 你需要在任何文件写入前审查模型选择的内容（合规、安全或团队审查场景）。
• 你希望在项目或团队成员之间共享一个经过筛选的技能集，而不依赖远程服务。

何时不适合

• 如果你只需要对 skills/ 文件夹进行简单的关键词搜索，AAS 会增加额外的验证和清单处理，可能并非必需。
• 需要自动执行技能的项目（如 CI/CD 运行器）必须自行构建运行器；AAS 仅提供静态指令。

了解更多

• 用户指南：docs/users/aas-core.md（信任边界、MCP 设置、CLI 生命周期）。
• 工作流与案例研究：docs/users/workflows.md。
• 安全与审计：docs/users/security-and-antivirus.md。
• 插件目录：plugins/ 目录及托管的主页 https://sickn33.github.io/agentic-awesome-skills/plugins。

---

总结：AAS Core 是一个预览阶段的本地运行工具包，允许 AI 代理从一个大型、可检查的可复用指令“技能”库中选择，并将这些选择记录在可重现的清单中。它面向希望在保留完全审计性和控制权的同时，利用 LLM 驱动自动化能力的团队。