SuperAPI AI 工具集

optimize-context

智能体与模型

查看项目

更新于 10-16 08:00

技能介绍

用途:optimize-context 用于降低 AI 代理的上下文膨胀,分两遍执行(除非用户另有说明)。前置条件:存在 plugins/ 目录、插件内有 scripts/optimize_context.py,且项目根目录至少有一个可读指令文件(CLAUDE.md、GEMINI.md 或 .github/copilot-instructions.md)。

主要能力:第一遍做技能去重。原因是 Claude Code 会自动扫描整个仓库中的 SKILL.md(标记为 Plugin),也会扫描 .claude/skills/(标记为 Project),旧安装器把内容符号链接到 .claude/ 导致每个技能被加载两次。修复方式是清空 .claude/ 下的 skills、agents、commands、hooks 副本,让 Claude Code 依赖对 plugins/ 的自动扫描;.agents/skills/ 是多 IDE 共享存储,不会被改动,Gemini CLI、Copilot、Antigravity 不受影响。第二遍优化指令文件,目标每文件不超过 80 行或约 800 token,保留项目目的、关键开发命令、通用编码规则、技能标准等,删除会过期的统计、重复安装命令、过细架构图等。第三遍(可选)给出会话 token 效率建议,如把模板填充、数据提取等确定性任务委派给廉价子代理,在主题切换时使用 /compact,为无关工作开启新会话,传递结构化文件而非对话记录。

使用方式:支持参数 --dry-run(仅报告不写入)、--verbose、--project-root PATH、--skills-only、--instructions-only。实时写入前需用户确认。可用命令包括 ls .claude/skills 等查看数量,rm -rf .claude/skills/* .claude/agents/* .claude/commands/* .claude/hooks/* 清除副本,以及 python plugins/dev-utils/scripts/optimize_context.py [--dry-run] 运行扫描器。验证用 wc -l CLAUDE.md 和扫描器 --dry-run。

适用场景与限制:适用于使用 Claude Code 等 IDE、存在重复技能加载或指令文件过长的项目。仅移除 .claude/ 副本,不触碰 .agents/。若 .claude/ 已空、plugins/ 不存在、指令文件已精简或用户拒绝重写,则按回退规则跳过相应阶段。具体收费、价格与平台信息暂未提供。