用途:对已有技能做就地更新,把新上下文、模式或改进写入技能源仓库中的 SKILL.md,并以草稿 PR 形式提交,不修改已安装副本。创建新技能应使用 skill-creator。
主要能力:支持程序化输入。传入 GitHub issue 编号时,用 gh issue view <N> 读取 issue,其中“Where to look”指明技能,验收标准即改动内容,其中的场景即需重跑的场景,跳过发现与选择步骤。传入结构化载荷(skill_name、skill_path、improvement_suggestions[])时同样跳过发现与选择,直接应用建议;每条建议含 priority(high/medium/low)、category(instructions/tools/examples/error_handling/structure/references)、suggestion、expected_impact,按优先级从高到低应用。即使走程序化路径,写入前也要执行预览并确认。
使用方式:先解析源仓库,读取 ~/.claude/skill-updater.config,存在且非空则作为 <source-repo>;缺失或为空时询问用户技能源仓库绝对路径,校验其为含 skills/ 目录的 git 仓库后写入该配置,并用一行报告解析结果。随后枚举 <source-repo>/skills/**/SKILL.md,记录名称与绝对路径;未指定技能时列出并询问。完整阅读目标 SKILL.md 及相关引用文件,编辑前说明技能当前作用、受影响章节与拟改动并等待确认。编辑前把当前技能目录复制到 <scratchpad>/<name>-baseline/ 以便重跑旧版本;只改该技能自身的 SKILL.md 与 references/,绝不编辑 ~/.claude/skills/... 或 .agents/skills/...。保持原有语气风格,不改用户未要求的章节;内容若使 SKILL.md 超过 100 行则拆到 references/;改动影响触发或行为时更新 description;删除无行为影响的死行;新指令要说明原因;使用祈使句。
验证:用 issue 验收标准或技能 evals/evals.json 中的用例,在全新子代理中分别对基线副本与编辑后技能以相同提示各跑一次并对比。新通过而基线失败则继续;新不通过则返工一次重跑,仍失败则拒绝改动并说明原因,不开 PR;基线也通过说明场景未测到改动,需收紧场景重跑或报告改动未经验证。把场景以 {"id": <next>, "prompt": ..., "expected_output": ...} 追加到 <skill>/evals/evals.json(不存在则创建 {"skill_name": "<name>", "evals": []}),并保留基线与新输出用于 PR 正文。
提交:参考 references/pr-workflow.md 的 git 与 gh 命令,fetch origin 后从 origin/main 创建分支 skill-update/<name>-<YYYYMMDD>,暂存 SKILL.md、evals/evals.json 及 references/ 新增内容,提交信息草拟为 chore(skills/<name>): <one-line summary>,按模板草拟 PR 正文,向用户展示提交信息与 PR 正文并等待确认后再推送并开草稿 PR,返回 PR URL。最后输出编辑文件路径与 PR URL,并可回读更新后的技能供用户审阅。
限制:只编辑 <source-repo>/skills/ 下的技能;插件技能或 ~/.claude/skills/ 条目不在范围内,需对插件上游仓库走 fork-and-PR 流程。资料未提供收费、价格、平台与效果等信息。