SuperAPI AI 工具集

optimise-claude

通用与其它

查看项目

更新于 10-16 04:57

技能介绍

optimise-claude 用于审计和重构项目内的 AI 技能文件,以降低上下文窗口占用。适用范围严格限定在项目级技能目录:.agents/skills/ 与 .claude/skills/(均相对项目根目录),绝不触碰用户级位置 ~/.agents/skills/ 和 ~/.claude/skills/,也不读取、列出或修改当前项目根($PWD)之外的任何文件。

触发条件包括:技能文件超过约 120 行;frontmatter 或章节顺序不符合规范;多个技能存在重复内容;AGENTS.md 中存在超过 30 行、本应拆为技能的内联指令块。

工作流分阶段顺序执行,不适用的阶段可跳过,且只处理当前项目仓库内文件:

  1. 清点与分类:列出项目 .agents/skills/ 下每个 SKILL.md,记录名称、行数、是否有 frontmatter、章节是否规范,标记违规项,输出按行数降序的表格。
  2. 减少 token:把散文改为命令式要点,压缩冗长示例,删除父级 AGENTS.md 已覆盖的说明和列表项间空行,目标控制在 120 行内,仍超出则拆为聚焦的子技能。
  3. 修正结构与 frontmatter:确保 YAML frontmatter 的 name 与目录一致、description 以“Use when”开头;章节顺序固定为 H1 标题、范围行、When to Use、Rules/Instructions、Quick Reference、Validation;删除空占位章节,全程使用命令式语气。
  4. 跨技能去重:找出重复超过 5 行的内容块,迁到项目根 AGENTS.md 或专门的共享技能,用一行指针替代,并重写重叠的 description 使触发条件唯一。
  5. 提取臃肿的 AGENTS.md 块:扫描项目中超过 30 行的内联指令块,在 .agents/skills/<name>/SKILL.md 新建技能,用精简指针加 Quick Reference 替换原块;若项目有技能同步脚本,运行它以将 .agents/skills/ 同步到 .claude/skills/。

完成后输出优化报告,含 Before/After/Delta 表格、技能总数、节省行数与新建技能数。验证命令:wc -l .agents/skills/*/SKILL.md,确保无文件超过 120 行;每个 SKILL.md 都有含 name 和 description 的有效 YAML frontmatter;无两个技能共享超过 5 行相同内容;项目内无未加技能指针、超过 30 行的内联指令块;项目根外文件未被修改。真源是项目的 .agents/skills/,不要直接编辑 .claude/skills/。