用途
本技能是一份操作指南,用于从现有工作流中移除技能,并同步更新所有相关文档。适用于用户希望从工作流中删除某个技能的场景,例如用户说出“remove skill”“delete skill”“移除技能”“删除技能”,或需要清理工作流中未使用、已弃用的技能。
主要能力
指南覆盖从识别技能到更新文档的完整移除流程,具体包括:
- 识别技能:在工作流中搜索技能名称,了解其使用情况。
- 删除技能文件夹:移除工作流中的技能目录。
- 更新 skill-source.json(如存在):从该文件中移除对应技能条目。
- 更新所有相关文档:移除技能后,必须更新七类文件。
使用方式
移除流程
第 1 步:识别技能
在工作流中搜索技能名称,了解其使用情况:
# Find all references to the skill
grep -r "skill-name" /path/to/workflow/
第 2 步:删除技能文件夹
从工作流中移除技能目录:
rm -rf /path/to/workflow/.claude/skills/skill-name/
第 3 步:更新 skill-source.json(如存在)
从 /path/to/workflow/.claude/skill-source.json 中移除该技能条目。
第 4 步:更新所有相关文档
移除技能后,必须更新以下文件:
| 文件 | 更新内容 |
|---|---|
| workflows/<workflow-name>/README.md | 技能数量、技能表格、流水线阶段、技能组合 |
| workflows/<workflow-name>/README_cn.md | 同上(中文版) |
| workflows/<workflow-name>/AGENTS.md | 可用技能列表、推荐序列 |
| website/content/en/workflows/<workflow>.mdx | 技能数量、技能表格、流水线、技能组合 |
| website/content/zh/workflows/<workflow>.mdx | 同上(中文版) |
| README.md(根目录) | 工作流表中的技能数量 |
| README_cn.md(根目录) | 工作流表中的技能数量(中文版) |
文档更新清单
对每个文档文件,更新以下内容:
- 技能数量:减少技能总数(例如“20 skills”改为“19 skills”)
- 技能表格:从任何技能列表表格中移除该技能行
- 流水线/阶段:从流水线图或阶段描述中移除技能引用
- 技能组合:移除任何包含被移除技能的技能链
- 示例工作流:移除或更新引用该技能的示例
示例
从 talk-to-slidev-workflow 移除 ppt-creator 技能:
# 1. Search for references
grep -r "ppt-creator" workflows/talk-to-slidev-workflow/
# 2. Delete skill folder
rm -rf workflows/talk-to-slidev-workflow/.claude/skills/ppt-creator/
# 3. Update skill-source.json
# Remove the ppt-creator entry
# 4. Update documentation files
# - Update skill count from 20 to 19
# - Remove ppt-creator from skill tables
# - Remove from pipeline Stage 6
# - Remove from skill combinations table
适用场景
- 用户希望从工作流中移除某个技能。
- 用户说出“remove skill”“delete skill”“移除技能”“删除技能”。
- 清理工作流中未使用或已弃用的技能。
限制与注意事项
- 移除前务必搜索技能引用,以了解影响范围。
- 根目录 README 只需更新工作流表中的技能数量。
- references/skill-sources.md 保持不变(它记录的是生态系统技能,而非工作流特定安装)。
- 如果示例工作流引用了被移除的技能,应删除该示例或将其更新为使用替代技能。