Agentic Awesome Skills 上下文过载恢复实战：Antigravity 截断与崩溃的完整修复指南

Agentic Awesome Skills 上下文过载恢复实战Antigravity 截断与崩溃的完整修复指南【免费下载链接】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导读在 agentic-awesome-skillsAAS仓库中Antigravity 作为宿主集成会在一次任务中加载过多技能Skill时触发截断truncation、上下文溢出或轨迹转换trajectory conversion错误导致 Agent 崩溃甚至重启循环。本指南以官方恢复文档 agent-overload-recovery.md 为核心结合仓库内 activate-skills.sh、activate-skills.bat 与 get-bundle-skills.py 的真实实现完整讲解症状识别、Linux/macOS 激活脚本快速路径、Windows 崩溃循环修复以及基于 manifest 契约的预防方案帮助你彻底摆脱技能太多 → 上下文爆炸 → 反复崩溃的死循环。症状识别什么时候该使用本指南当 Antigravity 因加载过多技能而开始出现以下三类信号时应立即进入恢复流程仅在大型技能目录存在时崩溃同一个任务在没有技能库的干净环境中运行正常一旦完整技能文件夹在场就报错错误信息包含截断或轨迹转换关键词例如TrajectoryChatConverter: could not convert a single message before hitting truncation或提示上下文转换失败message 无法转换问题随任务规模放大在大仓库、长时间运行任务上出现频率显著更高因为对话轨迹trajectory持续累积并叠加技能指令最终突破上下文窗口上限。这类错误的本质是宿主把大量SKILL.md指令一次性塞进系统提示词加上历史轨迹后超出模型上下文限制。因此恢复的核心思路只有一个——减少同时暴露的活跃技能数量让全量技能库保持归档状态。Linux 与 macOS 快速恢复路径激活脚本Linux/macOS 下推荐的恢复方案是使用仓库自带的激活脚本将完整技能库归档保存只把当前任务需要的 bundles 或技能暴露到 Antigravity 的活跃目录中。操作步骤完全关闭 Antigravity必须完全退出不能只关窗口在本地克隆本仓库git clone https://gitcode.com/gh_mirrors/an/agentic-awesome-skills从克隆目录运行激活脚本。三种典型用法# 用法一按 Bundle 名称激活支持引号包裹的含空格名称 ./scripts/activate-skills.sh Web Wizard Integration APIs # 用法二清空当前活跃目录后重新激活恢复干净状态的首选 ./scripts/activate-skills.sh --clear # 用法三按技能 ID 直接激活 ./scripts/activate-skills.sh brainstorming systematic-debugging注意脚本支持混用 Bundle 名称与技能 ID例如./scripts/activate-skills.sh --clear Essentials brainstorming会先归档当前活跃技能再激活 Essentials 包和brainstorming技能。脚本的实际工作流程源码级解析通过阅读 activate-skills.sh可以看到脚本按以下顺序执行理解它有助于你判断恢复过程中的每个输出信息同步技能库第 117-120 行若仓库skills/目录存在将整个技能树复制到~/.agents/skills_librarybacking store保证全量库不丢失初始化技能库第 122-136 行若skills_library尚不存在将当前活跃目录中的技能移入库中并把历史上所有skills_archive*归档目录合并回来确保没有任何技能因迁移而丢失处理--clear第 138-147 行若指定了--clear先把当前活跃目录整体移动到一个带时间戳的归档目录命名格式skills_archive_YYYYmmdd_HHMMSS见 activate-skills.bat 第 65-67 行的 Windows 对应实现否则以追加模式叠加展开 Bundle第 151-160 行调用tools/scripts/get-bundle-skills.py将 Bundle 名解析为具体技能 ID 列表若脚本缺失或 Python 不可用回退到默认技能集concise-planning git-pushing kaizen lint-and-validate systematic-debugging第 162-173 行恢复选中技能第 175-187 行对每个技能 ID已活跃的输出.从库中复制到活跃目录的输出库中不存在则输出-not found in library。无参数运行时的默认行为直接运行./scripts/activate-skills.sh不带任何参数时脚本会默认激活Essentials包。其内容定义在 data/editorial-bundles.json 中包含 5 个基础技能concise-planning、test-driven-development、lint-and-validate、systematic-debugging、git-pushing。这 5 个技能恰好对应脚本第 164 行的 Bash 回退列表仅kaizen被替换为test-driven-development保证即使 Python 环境异常也能提供一个最小可用的恢复集。Bundle 解析原理get-bundle-skills.py 如何工作脚本展开 Bundle 依赖 get-bundle-skills.py理解它有助于你正确传参数据源优先读取仓库根data/editorial-bundles.json第 28-30 行其中每条 bundle 包含id、name、skills[]数组也兼容旧版 Markdown 格式的 bundles 文档查询匹配第 80-107 行查询词先小写化并去引号然后转成 slug如Integration APIs→integration-apis与 bundle 的name子串或id精确匹配若任何 bundle 都未命中则把查询词当作技能 ID 直接加入前提是通过安全校验安全过滤第 7-17 行所有技能 ID 必须匹配正则^(?!.*(?:^|/)\.{1,2}(?:/|$))[A-Za-z0-9._-](?:/[A-Za-z0-9._-])*$即禁止.、..及任何路径穿越写法防止恶意参数逃逸到活跃目录之外。仓库中可用的 Bundle 名称节选包括Essentials、Web Wizard、Web Designer、Full-Stack Developer、Agent Architect、Security Engineer、Data Analytics、DevOps Cloud、QA Testing、Integration APIs、Automation Builder、Expo React Native等 50 个主题包覆盖 Web、安全、数据、移动端、营销与运营等多个方向可按需查询 data/editorial-bundles.json 确认完整列表与对应技能集合。可配置的环境变量覆盖脚本通过环境变量提供灵活的自定义路径方便多环境部署与 CI 场景# 自定义 Antigravity 基础目录默认 ~/.agents AG_BASE_DIR/custom/antigravity ./scripts/activate-skills.sh --clear Essentials # 自定义仓库技能源目录默认克隆仓库内的 skills/ AG_REPO_SKILLS_DIR/path/to/repo/skills ./scripts/activate-skills.sh brainstorming完整的环境变量清单来自 activate-skills.sh 第 5-13 行环境变量作用默认值AG_BASE_DIR基础目录其他路径的根$HOME/.agentsAG_SKILLS_DIR活跃技能目录$BASE_DIR/skillsAG_LIBRARY_DIR全量技能库backing store$BASE_DIR/skills_libraryAG_ARCHIVE_PREFIX归档目录前缀--clear时使用$BASE_DIR/skills_archiveAG_REPO_SKILLS_DIR仓库技能源目录$SCRIPT_DIR/../skillsAG_BUNDLE_HELPERBundle 展开脚本路径tools/scripts/get-bundle-skills.pyAG_PYTHON_BIN指定 Python 解释器自动探测python3/pythonAG_NO_PAUSE仅 Windows设为1时跳过批处理结尾的 pause空此外Windows 批处理版还额外支持AG_SKILLS_DIR、AG_LIBRARY_DIR的独立覆盖activate-skills.bat 第 5-12 行默认PYTHON_BIN为python并通过robocopy实现与 Bash 版等价的同步、迁移与恢复逻辑。Windows 崩溃循环恢复如果 Antigravity 在 Windows 上陷入重启 → 恢复同一损坏会话 → 再崩溃的循环请改用专门的 Windows 恢复指南windows-truncation-recovery.md。该指南覆盖了宿主反复重开同一损坏会话时所需的浏览器/应用存储清理核心要点备份优先删除任何内容前先备份%USERPROFILE%\.gemini\antigravity-browser-profile\Default、%AppData%\antigravity、%USERPROFILE%\.gemini\antigravity若技能装在自定义目录也一并备份移除问题技能从%USERPROFILE%\.gemini\antigravity\plugins\skills删除引发崩溃的技能或包清理损坏存储删除浏览器配置目录下的Local Storage、Session Storage、IndexedDB以及%AppData%\antigravity下对应的Local Storage、Session Storage并清空%TEMP%重启并最小化重装只重装实际需要的技能或改用带显式数量上限的懒加载集成。该指南还附带一个社区提供的批处理辅助脚本自动备份到桌面AG_Emergency_Backup_时间戳目录后执行清理运行前请务必审阅其逻辑确认要删除的路径与你的安装一致。预防方案从源头避免上下文过载恢复只是亡羊补牢真正的解法是让宿主以受控方式加载技能。官方恢复文档给出了四条预防铁律并与 discovery-manifest.md 中定义的 manifest 契约相互印证从一个小型 Bundle 起步开始任务时先激活 3-5 个技能例如只激活 Essentials而不是一次性暴露全量技能库打开超大仓库前先做 Bundle 激活仓库越大历史轨迹膨胀越快务必在任务开始前就把活跃技能集收敛到最小保持角色化技能栈、归档其余按当前角色如安全工程师Web 前端维护一个常驻活跃栈其他技能全部归档到skills_library宿主会话状态损坏时先清宿主状态再恢复如果宿主如 Antigravity 浏览器配置存有损坏的会话状态先按上文 Windows 流程清理再恢复一个更小的活跃集。稳定宿主集成的 manifest 契约对于自研宿主集成discovery-manifest.md 明确要求不得一次性加载所有技能指令文件推荐行为如下读取仓库根skills_index.jsoncanonical 发现源data/skills_index.json仅为兼容镜像两者内容必须一致作为唯一权威索引仅解析对话中出现的skill-id引用对每个解析出的技能按需懒加载单个SKILL.md强制每轮per-turn技能数量上限确保用户提示低于上下文限制校验每个解析路径始终位于配置的SKILLS_ROOT之内防止路径逃逸。该 manifest 的 JSON 数组条目包含id、path、category、name、description、risk、source、date_added等字段schema 定义在 schemas/skills-index.v1.schema.json仓库根与data/下的skills_index.json各含约 2100 条技能记录可作为你集成开发时的权威数据源。另外若需要更工程化的管理方式可关注 AAS Core它通过有界、只读的本地 MCP 工具对外暴露完整技能目录提供搜索、检视与 Agent 自主组合能力从架构层面避免全量技能塞入上下文的粗暴做法没有 AAS Core 宿主适配器的集成才需要直接对接上述 manifest。总结上下文过载与截断崩溃是可预防、可恢复的。恢复路径分三层Linux/macOS 用激活脚本快速切换活跃技能集activate-skills.shWindows 用专门的存储清理流程windows-truncation-recovery.md根治则靠懒加载 per-turn 上限的 manifest 契约discovery-manifest.md。记住关键顺序先关宿主、再收敛技能、后清理损坏状态、最后按需重装——即可让 Antigravity 在拥有 2100 技能能力的同时始终保持稳定的上下文窗口。【免费下载链接】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辅助生成（AIGC），仅供参考