用途
accelint-skill-manager 是一个面向 Agent Skill 的创建、重构与审查工具。它适用于用户提出“创建一个技能”“做一个新技能”“为 X 构建技能”“审查这个技能”“检查技能质量”等场景。其核心定位不是教代理如何写代码或使用标准库,而是让技能只承载专家级、非显而易见、难以通过常识获得的知识,从而在有限的上下文预算内帮助另一个代理实例更有效地执行任务。
主要能力
技能创建与重构
提供一套“技能创建工作流”,按顺序执行以下四步:
- 理解:收集技能使用的具体示例,明确功能、使用示例和触发短语。可通过向用户提出 2-3 个具体问题逐步澄清,而不是一次性罗列全部问题。
- 规划:分析每个具体示例,找出可复用的脚本、参考文件和资产。例如 PDF 旋转操作可固化为 scripts/rotate-pdf.sh,前端应用脚手架可存为 assets/hello-world/ 模板,数据库查询可整理为 references/schema.md。
- 初始化:检查是否已有重叠技能,并创建目录结构。创建前建议检查项目级与全局技能目录。新技能可从 assets/skill-template/ 模板复制并定制;重构已有技能则直接进入第四步。
- 编辑:面向另一个代理实例编写内容,聚焦非显然的程序性知识、领域细节和可复用资产,并按任务脆弱程度校准自由度。更新已有技能时,需提升 frontmatter 中的 metadata.version,并维护 CHANGELOG.md。
技能审查
提供“技能审查工作流”,包括:
- Frontmatter 审查:检查 name(小写、仅连字符、不超过 64 字符、与目录名一致)、description(以“Use when”开头,包含 WHAT/WHEN/KEYWORDS 和具体触发短语)、license(建议但可选)、metadata.version(存在且与 CHANGELOG 最新版本一致)。
- 结构审查:对照预期章节(如 NEVER Do、Before [Action] Ask、How to Use、Main Workflow)检查缺失项。
- CHANGELOG 与版本审查:检查 CHANGELOG 是否存在、版本是否匹配、变更是否包含原因、格式是否符合“Keep a Changelog”、各章节是否有实质内容。
- 知识增量测试:逐块判断内容是否为代理已知,标出冗余内容并计算冗余比例;若冗余超过 50%,建议大幅修订。
- 产出可操作结果:按优先级给出具体改进建议,提供改写后的 description,并附上改进后的 SKILL.md。
编写约束与自由度校准
技能明确列出创建技能时的禁止事项,包括:不写基础教程;不把“何时使用”放在正文;不将所有内容堆进 SKILL.md;不使用“小心”“避免错误”这类泛泛警告;不对所有任务使用同一自由度;不解释标准操作;不写显而易见的步骤;不跳过反模式章节;不写模糊的 description;不混用创建与审查关注点。
自由度校准按任务后果划分:后果高(文件损坏、数据丢失)时使用低自由度与精确脚本;后果中等(次优代码、风格问题)时使用中等自由度与示例;后果低(审美选择、多种有效路径)时使用高自由度与原则性指导。
渐进式披露与版本管理
技能采用渐进式披露以最小化上下文占用:先遵循 SKILL.md 中的工作流,再按需加载 AGENTS.md,以及 references/ 下的具体参考文件(文件系统、description 约定、AGENTS.md 模式、渐进式披露规则、参考文件格式、脚本约定、资产指南、CHANGELOG 维护)。明确要求不要一次性加载全部参考文件,只加载当前步骤相关的文件。
版本控制建议:主版本用于重大重写、破坏性变更或完全重构;次版本用于新增章节、重要补充或改进;补丁版本用于缺陷修复和错别字更正。更新技能后应按“Keep a Changelog”格式更新或创建 CHANGELOG.md,记录 Added、Changed、Fixed 及版本变更说明,并确保 CHANGELOG 版本与 frontmatter 中的 metadata.version 一致。
使用方式
用户可在要求创建、重构或审查技能时使用该技能。创建或重构时按其四步工作流执行,并复制清单跟踪进度;审查时按 frontmatter、结构、CHANGELOG 与版本、知识增量测试的顺序检查并输出改进建议。加载参考文件时应按当前步骤按需加载。
适用场景
适用于需要为代理编写可复用技能、改进已有技能、或对技能质量进行系统审查的场景。尤其适合希望将专家经验固化为可被代理激活和执行的技能,同时控制 token 消耗的情况。
限制
资料未提供该技能的具体安装命令、运行环境要求、收费信息、价格、平台支持范围、实际效果数据或具体使用步骤示例。资料也未提供官方文本。