设计工作流技能 是做什么的？
指导设计和构建基于工作流的 Claude Code 技能，包含多步骤阶段、决策树、子代理委派和渐进式披露。适用于创建涉及顺序管道、路由模式、安全门、任务跟踪、分阶段执行或任何多步骤工作流的技能，也适用于审查或重构现有的工作流技能以提高质量。
概述
本技能提供了一套最佳实践和模式，用于在 Claude Code 中设计和实现复杂的工作流技能。工作流技能允许你将多步骤过程分解为可管理的阶段，在决策点路由逻辑，委派子代理处理子任务，并逐步向用户披露信息。
为什么使用工作流技能？
- 模块化：将复杂的任务拆分为单独的、可测试的阶段。
- 可维护性：清晰的阶段划分和路由逻辑使技能更容易更新和调试。
- 鲁棒性：通过安全门和任务跟踪确保工作流按预期执行。
- 用户体验：渐进式披露防止信息过载，并根据上下文提供相关信息。
关键概念
- 阶段（Phase）：工作流中的一个离散步骤，例如“收集输入”、“处理数据”、“生成输出”。每个阶段应明确输入、输出和预期行为。
- 决策树（Decision Tree）：在多个可能路径之间进行路由的机制。基于条件（如用户输入、先前结果）选择路径。
- 子代理委派（Subagent Delegation）：将子任务委派给专门的子代理，这些子代理拥有独立的功能。
- 渐进式披露（Progressive Disclosure）：按需显示信息，从高层次细节开始，允许用户深入挖掘。
- 安全门（Safety Gate）：在进入下一个阶段之前检查必要的前提条件或验证状态。
- 任务跟踪（Task Tracking）：采用一致的方法监控整个工作流的进度和状态。
设计模式
顺序管道
一系列按顺序执行的阶段，每个阶段依赖于前一个阶段的输出。
phases:
- name: "收集要求"
input: 用户需求
output: 要求文档
- name: "设计架构"
input: 要求文档
output: 架构图
- name: "实现"
input: 架构图
output: 代码
路由模式
根据条件分支到不同的阶段。
输入 -> 决策: 是简单任务吗？ -> 是: 直接处理
-> 否: 进入多步工作流
带委派的子代理
主工作流将特定任务委派给专门的子代理，然后等待结果。
主代理 -> 委派: 数据分析 -> 子代理: 运行报告
-> 委派: 代码审查 -> 子代理: 审查更改
安全门模式
在继续下一步之前验证前提条件。
阶段1 -> 安全检查: 是否已完成要求？ -> 是: 继续阶段2
-> 否: 提示用户提供缺失信息
在 SKILL.md 中实施
为你的工作流技能定义一个清晰的 SKILL.md 结构：
- 标题和描述：简要解释该技能的用途。
- 阶段定义：在 YAML 或列表中列出所有阶段及其依赖关系。
- 路由逻辑：描述如何以及何时做出决策。
- 子代理规范：界定子代理的范围和能力。
- 错误处理：定义当阶段失败时的后备策略。
- 示例：提供一个典型使用示例。
审查和重构
在审查现有工作流技能时，请注意以下问题：
- 阶段之间是否存在清晰的界限？
- 路由条件是否正确处理了所有情况？
- 子代理是否得到了正确的委派，并且不会相互干扰？
- 是否包含安全门来防止不完整的状态？
- 整个工作流是否容易理解？（可读性评分为“是”）
资源
- Claude Code 文档（链接）
- 关于工作流设计的优秀实践（链接）
许可
此技能根据 MIT 许可提供。