remove-old-skills-from-workflow

从工作流中移除技能

介绍如何从现有工作流中移除技能并更新所有相关文档。

适用场景

• 用户想从工作流中移除技能
• 用户说“移除技能”“删除技能”或 "remove skill"、"delete skill"
• 清理工作流中未使用或已弃用的技能

移除流程

第 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 步：更新所有相关文档

移除技能后，必须更新以下文件：

需要更新的文件（7 个）

文件	更新内容
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 个技能” → “19 个技能”）
• 技能表：从所有技能列表中移除该技能对应的行
• 流水线／阶段：从流水线图或阶段说明中移除对该技能的引用
• 技能组合：移除包含该技能的所有技能链
• 工作流示例：移除或更新引用该技能的示例

示例

从 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

重要说明

• 移除前务必搜索对该技能的引用，了解影响范围
• 根目录的 README 只需更新工作流表中的技能数量
• 保持 references/skill-sources.md 不变（该文件介绍的是技能生态，而非特定工作流中的安装项）
• 如果示例工作流中引用了该技能，请移除该示例，或将其更新为使用替代技能