SuperAPI AI 工具集

workleap-skill-optimizer

通用与其它

查看项目

更新于 10-16 05:47

技能介绍

用途:Skill Optimizer 是一款优化智能体技能的工具,目标是降低技能 token 成本而不损失覆盖面。SKILL.md 正文中的每个 token 都会按对话付费,而 references/ 文件按需加载,因此应把非核心内容移入引用文件。

主要能力:提供四阶段优化流程。Phase 1 分析,统计 SKILL.md 正文行数(排除 frontmatter)并估算 token(约 4.5 token/行)、描述字符数、各引用文件行数,计算正文与引用文件的重叠百分比,并找出与同级技能描述逐字重复的名词。Phase 2 规划,决定正文保留哪些内容、哪些移入引用文件、哪些压缩;保留标准包括复杂多步模式、易错逻辑或参数、本技能独有概念、主要用例四类;同时对描述进行压缩,将 4 个以上具体名称改为类别化表述,用领域限定通用关键词,合并同主题条目,并保证触发类别不丢失。Phase 3 执行,按顺序压缩描述、删除正文重复段、新增 Reference Guide 段落指向各引用文件并补充说明、递增 metadata.version 次版本号。Phase 4 验证,用 Task 工具启动 opus 子代理,提供完整 SKILL.md、全部引用文件及 15-25 个验证问题,逐题评估仅凭 SKILL.md 和 SKILL.md 加引用文件的可答性(YES/PARTIAL/NO),识别缺口。

必要用法与目标:正文控制在约 250 行以内,描述控制在约 700 字符以内,与引用文件重复率为 0%。验证通过标准为 0 回归、描述中所有触发类别仍在、正文低于约 250 行。若发现缺口,需区分既有缺口与优化回归,仅回归需要修复后重评。无法启动子代理时可自评,并对每个问题标注 HIGH/MEDIUM/LOW 置信度,此前可答而现为 LOW 的即为回归。

限制:不要将“何时使用”触发信号从描述移入正文,因为描述是触发时唯一被读取的字段;不要删除保留正文段中的代码示例;不要仅为移动内容而创建新引用文件;不要添加与引用文件重复的内容。无 references/ 目录的技能可能需要先创建引用文件。详细清单、前后示例与完整验证方法见 optimization-playbook.md。