企业官网建设流程全解析

为什么你的AI Agent总装不够上下文？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,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills

用 AI Agent（Claude Code、Codex CLI、Cursor 等）干活时，你是否也遇到过"上下文装不下"的困境？想给它配点技能（Skills），结果技能一多，Agent 就开始截断、卡顿甚至直接崩溃。Agentic Awesome Skills（AAS）是一个拥有 2,115+ AI Agent 技能清单的开源目录，它的核心组件AAS Core正是为解决"AI Agent 上下文不足 / 上下文过载"而生：让 Agent 在本地完整目录里自主挑选所需技能，生成一份可审核、可复现的技能清单（aas-stack.json），再经校验和不可变计划后才落地——按需加载，而不是全量塞进上下文。

为什么全量安装技能会让 AI Agent 上下文爆炸？

很多新手的第一反应是："技能越多越好，全装上总没错。"但对 Agent 来说恰恰相反：

AAS 官方文档 agent-overload-recovery.md 明确列出了上下文过载的典型症状：Agent 只在技能目录很大时才崩溃、报错信息里出现 truncation（截断）或 context conversion（上下文转换）字样、问题在大仓库或长任务中更频繁。

💡 官方预防建议：从 3~5 个技能起步，按角色维护技能栈，其余全部归档——这正是"按需加载"的核心思想。

AAS Core 按需加载机制：Agent 选型，AAS 验证，你掌控

AAS 当前主版本 V17.4.0 的产品模型可以用一句话概括："The agent composes. You control. AAS keeps the stack reproducible."（Agent 负责组合，你负责掌控，AAS 保证技能栈可复现。）

完整工作流如下：

你的项目 -> Codex 或 Claude 检查项目（而不是 AAS 来检查） -> Agent 搜索并阅读完整的本地技能目录 -> AAS MCP（本地 stdio，只读） -> Agent 自主选择精确的技能 ID -> compose_stack 在内存中验证选型（只读） -> 客户端或 aas CLI 持久化为 aas-stack.json -> aas 命令校验 + 生成不可变计划预览 -> 人工审核（可在 Workbench 中完成）

它的关键设计决定了为什么能"装得下、用得准"：

• Agent 自主选择：本地 MCP 提供search_skills、get_skill、list_skill_files、read_skill_file、compose_stack、inspect_stack、diff_stack等只读工具。AAS 本身不排序、不推荐、不隐藏任何技能——判断权始终在 Agent 手里。
• 完整目录可搜索：每个技能都能被单独检索、阅读、选中；元数据缺失不会让技能"失去资格"。
• 持久化的是"已审核的清单"：产出物是批准后的技能栈和不可变计划，而不是一次性的黑盒安装。
• 技术上限可控：技能清单格式有 128 个技能的技术上限，从格式层面杜绝"无限堆技能"。

一键配置本地 MCP：让 Agent 获得完整目录的只读访问

配置 AAS Core 只需一条带精确版本号的命令（以 Codex 为例，详见 aas-core.md）：

npm exec --yes --ignore-scripts --package=agentic-awesome-skills@17.4.0 -- aas mcp configure \ --host codex \ --scope user \ --config /绝对路径/到/codex/config.toml \ --cache-root /绝对路径/到/aas-cache

这条命令第一次运行只是预览，会返回一个审批摘要（approval digest）而不改动任何配置；你审核后加上--approve <摘要>再执行一次即可。配置过程是显式且带完整性校验的——AAS 会安装或复用精确内容寻址的运行时、校验它，并且只修改自己托管的 MCP 配置段。

最快让 Agent 按需挑技能的方法

配置好 MCP 后，把下面这段提示词交给 Agent，让它评估项目的完整能力面（架构、领域行为、数据、集成、测试、安全、部署等），为每个能力域搜索并比对候选技能，最后用compose_stack生成清单：

检查这个仓库，搜索并阅读完整的本地 AAS 目录，枚举项目的主要能力域……为每个能力域选择一个或多个不冗余的可用技能，明确报告目录中无匹配的能力缺口。最后用 compose_stack 校验精确 ID 并在内存中返回 schema 2 清单，展示前先 inspect_stack。不要安装或应用任何东西。

Agent 返回aas-stack.json后，你只需两步确认：

aas stack validate # 校验清单 aas stack plan # 生成不可变计划预览（不落地任何技能）

上下文过载急救：用激活脚本只激活你需要的技能包

如果你已经装了大技能库、Agent 已经开始截断报错，AAS 提供了快速恢复路径——激活脚本会把完整库归档到后台存储，只把指定技能包暴露到活动目录（完整文档见 agent-overload-recovery.md）：

# 只激活指定技能包 ./scripts/activate-skills.sh "Web Wizard" "Integration & APIs" # 或按精确技能 ID 激活 ./scripts/activate-skills.sh brainstorming systematic-debugging # 清空当前活动集后重建 ./scripts/activate-skills.sh --clear Essentials

脚本做的事：把仓库skills/树同步到~/.agents/skills_library作为后备存储，只把请求的包或技能 ID 激活到~/.agents/skills。对应文件见 activate-skills.sh 与 Windows 版 activate-skills.bat。

用 Bundles 作为"角色级精选清单"

不确定选什么技能？Bundles 是官方按角色整理的技能包（如 Web Wizard、Security Engineer Pack、Essentials 入门包），本质是帮你缩小候选范围的精选清单，而不是要求你全量安装。编辑版包说明见 bundles.md，机器生成的包索引见 data/bundles.json。例如 Essentials 入门包只含 5 个技能：concise-planning、test-driven-development、lint-and-validate、systematic-debugging、git-pushing——完全符合"从 3~5 个开始"的防过载原则。

4 个防止上下文装不下的实用技巧

1. 永远从 Bundle 的 3~5 个技能起步，验证有效再逐步扩展，而不是暴露整个库。
2. 按角色维护技能栈：前端项目激活 Web 相关栈，跑安全审计时切换 Security 栈，其余归档。
3. 让 Agent 走 AAS Core 流程选型：搜索 → 比对 → 生成aas-stack.json→ 人工审核 → 校验 → 计划预览，每一步都可回退。
4. 警惕只读边界：AAS MCP 全程只读、单行 JSON 上限 256 KiB、单个技能文件读取上限 1 MiB——这些边界设计就是为了防止超大内容冲爆会话帧。

技能目录总览：2,126+ 技能都覆盖哪些领域？

按需加载的前提是"目录足够全"。AAS 的完整技能库（约 2,126 个技能）覆盖主要能力域如下（摘自 skills-library-overview.md）：

权威的可机读目录是 CATALOG.md 与 skills_index.json，每个技能目录都带SKILL.md前置元数据（名称、描述、标签、风险等级、来源），支持精确检索。

上手路径速查

⚠️ 安全提醒：每个技能都带有none / safe / critical / offensive / unknown风险标签。调用标记为critical或offensive的技能前，请先阅读 SECURITY_GUARDRAILS.md。结构校验不代表语义适配，最终是否落地由你审核决定。

总结

"上下文装不下"不是 Agent 的宿命，而是技能加载策略的问题。AAS Core 给出的答案是三条原则：Agent 拥有选型权（它最了解项目需要什么）、AAS 负责记录与验证（选型变成可复现的aas-stack.json+ 不可变计划）、你始终掌控（所有产物先审核、后落地）。配合 Bundles 精选清单和激活脚本，你可以让技能库保持 2,000+ 的完整度，同时只把当前任务真正需要的 3~5 个技能放进上下文——这才是 AI Agent 技能按需加载的正确姿势。

【免费下载链接】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,115+ agentic skills. Includes CLI, local MCP, catalog, plugins, and Workbench.项目地址: https://gitcode.com/gh_mirrors/an/agentic-awesome-skills