start-workflow 是 easy-claude 技能集合中的工作流启动管理技能,其主要用途是在确定要执行某个工作流后,负责激活该工作流或自定义流水线,并建立完整的执行跟踪计划。
主要能力包括:
-
工作流选择与激活:接受用户明确指定的工作流 ID,或在启用运行时路由时由路由负载匹配的工作流。在自动选择前,会向用户提出一个包含三个选项的问题:完整工作流、精简自定义流水线、直接执行,并根据回答执行。
-
规范解析:通过共享清单解析器解析工作流的完整规范,包括意图(intent)、结果门禁(outcomeGates)、有序步骤(occurrences)、并行组(parallelGroups)、阶段(phases)和指纹(fingerprint),并读取工作流自身的 SKILL.md 文件。
-
待办跟踪:在将第一个任务标记为进行中之前,批量创建所有待办跟踪项,每个清单阶段对应一个待办项,每个步骤作为一行列出。
-
执行协议:门禁步骤始终执行;核心和可选步骤为建议,可在结果门禁仍可满足且数据依赖成立的前提下跳过、合并、简化或重排,但每次偏离都必须记录。
-
自定义流水线:当没有匹配的目录工作流或匹配度不高时,可自动选择自定义流水线,使用规范步骤 ID 按逻辑顺序组合,并保留必要的质量门禁(如缺陷根因调查、测试、审查、规范/文档同步)。
使用方式:通过 $start-workflow <id> 调用,或在运行时路由启用时由路由负载触发。激活前需要确保工作流条目具有非空的 preActions.injectContext。在 Codex 环境下,需加载注册的 .agents/skills/<name>/SKILL.md 并执行。
适用场景:需要启动已检测到的工作流、初始化工作流状态或激活工作流序列时使用。不适用于手动步骤执行、工作流设计或目录管理。
限制:自动选择仅在运行时路由负载存在时可用,否则需要显式指定工作流 ID。会话中途不会自动激活工作流或询问是否启动。工作流目录字段 workflows 为对象结构,必须使用 workflows[workflowId] 访问。并行组不会跨阶段,无 parallelGroups 时按顺序执行。