用途
refactor-skill 用于重构或优化一个已有的技能，范围可以从整体结构调整一直到一行措辞的修正。它的核心判断依据是技能会消耗两种预算：description 会被加载进每一个会话，因此其中的每个词都必须承担触发作用；正文在技能被调用时进入上下文，并在此后整个会话中一直保留，因此正文的每一行都必须为通过该技能的所有路径提供指引。条件性内容应移到指针之后，不必要的内容应移出技能。
主要能力
该技能会先确定目标技能：如果调用时指定了目标，就解析到它的 SKILL.md；否则询问是哪一个技能。对于完整审计，会读取 SKILL.md 及其目录下的每一个同级文件；对于定向修改，会读取 SKILL.md、受影响的文件以及评估其交互所需的引用。
随后获取指南：根据目标技能的 model frontmatter 选择一份模型指南。未设置或 inherit 表示使用运行此技能的模型家族中最强的模型：Claude 下为 fable，GPT 模型下为 gpt-6-astra。对应引用为 Claude Code（fable、opus、sonnet）读取 references/claude-code.md，Codex（gpt-6-astra）读取 references/codex.md，并抓取其中列出的页面。
审计阶段会对范围内的每个 frontmatter 键、正文指令和同级文件给出恰好一个裁决，判断标准如下：
- contradiction：与另一条指令冲突，或 frontmatter 承诺了正文未兑现的内容，例如 context: fork 的技能正文却假设存在对话历史。需记录双方。
- delete：未通过 no-op 测试，即目标模型在没有它时行为相同，或抓取的页面指出应移除它（因为它为更早模型的习惯而写）。涵盖对模型已知内容的解释、不携带指令的强调，以及没有任何指向的同级文件。
- demote：真实内容，但只有部分运行会到达。去向包括：技能目录中由 SKILL.md 链接的文件（一层深度）；当步骤确定时放到 scripts/ 下的脚本；仅当需要自己的触发条件或另一个技能必须访问它时才拆为独立技能。需指明去向。
- rewrite：含义正确但措辞未达到抓取页面的要求，例如 description 列举功能而非触发条件、步骤没有完成标准、禁令没有正向目标、用大写喊出的规则而非解释。也包括该行本身含有未通过 no-op 测试的词：另一行的重复、对模型已知术语的定义或强调；理由或示例则保留，因为两者都能引导模型。语气遵循系统提示：正文以“you”称呼模型、以“the user”称呼人类，因此用“I”或“my”指人类、用“Claude”或“the agent”指模型都属于需要重写；作为用户话语引用的词保留其自身语气。
- keep：按原样值得其成本。
各部分的标准：
Frontmatter（每个键都是一个决策，在正文之前判断）：仅当只有用户会命名该技能时使用 disable-model-invocation: true；当智能体必须自行到达该技能，或另一个技能或 CLAUDE.md 行会调用它时省略。当人类从不手动运行时使用 user-invocable: false。当参数完全指定了工作且正文不需要对话历史时使用 context: fork。仅当在继承值下运行失败时才使用 model 和 effort，且 model 仅用于 context: fork 的技能或拥有整个回合的技能。技能接受参数时提供 argument-hint，不接受时省略。
Description（加载进每个会话）：每个词都承担触发作用。以何时使用开头，每个不同的触发条件只命名一次，标出它不应触发的近似情况。用户调用的技能获得一行面向人类的摘要，不含触发条件列表。
Body（从调用到会话结束都在上下文中）：包含通过该技能的所有路径都需要的动作、约束、完成标准或引用。仅在正确性依赖顺序时要求固定顺序；将条件性工作流路由到支持文件。以常设指令书写，因为正文不会被重新读取。
Sibling files（仅在到达时加载）：每个文件在 SKILL.md 中都有指针，说明它是什么以及何时读取；对于脚本，说明何时运行。没有指针的文件不可达。
使用方式
在可用时，Claude Code 中使用 AskUserQuestion，Codex 中使用 request_user_input。获取决策时复用用户已授权的改动和裁决。尽可能依据指令优先级和明确的用户意图解决矛盾；对每个未解决的矛盾问一个单选问题。呈现剩余的 delete 和 demote 提议，并用一个问题收集确认。保留明确的审查边界，未获批准的提议保持不动。
重写阶段一次性应用已授权的改动和裁决，不再询问。只应用这些：编辑时注意到的其他内容作为后续事项在最终消息中报告。保留目录名和 name 字段，因为重命名会改变斜杠命令。当每个审计项都落到其裁决所指的位置（保留、重写、降级或删除）时完成。当 description 发生变化时，在最终消息中指明一个触发测试：Claude Code 中使用带 tool_used: Skill 评分器的 claude plugin eval，Codex 中使用 skill-creator 技能的前向测试。
适用场景
适用于准备重构或优化一个已有技能、其 SKILL.md 或同级文件时，从整体重构到一行措辞修正均可。
限制
资料未提供该技能的收费、价格、平台支持范围或效果保证等信息。