workflow-architect

工作流架构师

一项元技能，帮助你（和你的 Agent）了解自己实际的工作方式。它通过主动询问或被动观察，发现你的工作流模式，然后生成一个技能包——一组可加载的技能，每项技能都带有触发条件，用来编码你的工作流，让 Agent 在每次会话中都能顺应你的节奏。

你将获得什么

运行 workflow-architect 后，你的 Agent 技能目录中会新增一个技能包，其中包含：

• 总控 SKILL.md — 入口文件，其描述中的触发条件可让 Agent 自动识别技能包。使用 skill_view(name='<bundle-name>') 加载，或者在你说出与触发条件匹配的话时，让 Agent 自动发现它。
• 子技能 — 每个工作流阶段对应一项子技能，每项技能都带有 description，告知 Agent 何时加载（例如，“用户开始晨间分流流程时加载此技能”或“用户进入深度工作模式时使用此技能”）
• 清单 — 将技能名称与其触发条件、入口点和转换信号对应起来
• 决策图 — 使用 Mermaid 流程图展示 Agent 所看到的工作流
• 看板（可选）— 仅当你的工作流遵循可预测的线性路径，且在制品限制和泳道转换能带来价值时才会包含

总控技能和子技能通过 skill_manage(action='create') 注册，因此会显示在 skills_list() 中，并可在之后的会话中立即加载。

两种模式

Workflow-architect 会根据你希望如何使用它进行调整。

模式 1：主动询问（一次性）

适用场景： 你有几分钟时间来讲述自己的流程。这是最全面的模式——Agent 会引导你回答问题，根据你的回答调整问题方向，并逐步构建你的工作流模型。

调用方式：

/workflow-architect

Agent 会引导你进行一段约 8–15 个问题的对话。自然作答即可——这项技能会根据你的回答调整探查方向。

模式 2：被动观察

适用场景： 你已经开始处理实际工作，不想停下来反思。让此模式观察你的实际操作，再根据你的行动推断工作流模式。

调用方式：

/workflow-architect passive

Agent 会静默加载观察器技能。在你说出下方的某个触发短语之前，它不会执行任何操作；之后，它会扫描当前会话的消息历史，并根据已发生的内容重建你的工作流。

触发短语（说出其中任意一句即可启动观察分析）：

• “梳理我的工作流”
• “我的工作流是什么”
• “分析我的流程”
• “弄清楚我在做什么”
• “根据我刚才做的事推断”

限制： 在至少有 20+ 轮实质性工作的会话结束后，观察模式的效果最佳。如果会话上下文过少，观察器会建议改用主动询问模式。

加载流程

1. 阅读此总控 SKILL.md，了解背景
2. 如果使用主动模式：加载 references/active-workflow-discovery.md
3. 如果使用被动模式：加载 skills/observer/SKILL.md
4. 达成一致后：加载 skills/bundle-builder/SKILL.md，综合内容并编写输出技能包。技能包会写入 ~/.hermes/skills/<category>/<bundle-name>/ — 请确认可以通过 skill_view(name='<bundle-name>') 加载总控技能，并至少可以通过 skill_view(name='<bundle-name>-<phase-name>') 加载一项子技能。告知用户技能包所在位置、其中包含哪些技能，以及他们可以用来进入工作流的触发短语。

访谈会构建什么

访谈者（以及通过推断进行观察的观察者）会构建一个结构化模型，涵盖以下维度：

维度	内容
入口点	你的会话通常如何开始
阶段	工作流中不同的模式或阶段
分支信号	在每个分岔点，是什么让你选择不同方向
工具偏好	你在每个阶段会使用哪些工具
循环条件	什么让你继续处于某种模式，什么又会让你退出
退出标准	你如何判断会话已完成
痛点	哪些方面让你觉得不顺畅或效率低下

环境

无需环境变量。状态通过 memory tool 存储，前缀为 workflow-architect:state:，因此可在多轮访谈中跨轮次保留。

何时不应使用

不要将此技能用于一次性任务协助，也不要用于没有值得记录的可重复多阶段工作流的情形——这类情况更适合使用独立技能。如果你已经有定义明确的流程，只需要将其打包，那么请直接生成技能包，而不要重新进行访谈。

先决条件

此技能不包含脚本；它是由此 SKILL.md 随附文件承载的基于资源的协议：

• 主动探索参考 — references/active-workflow-discovery.md 在此父技能中包含引导式工作流访谈。主动模式下请阅读此文件。
• 子技能协议 — skills/observer/SKILL.md（被动观察）和 skills/bundle-builder/SKILL.md（技能包合成与注册）。请按上述加载协议加载。
• 参考模式 — references/workflow-archetypes.md（收敛检测模式库）、references/trigger-condition-patterns.md（触发条件格式规范）、references/kanban-decision-criteria.md（何时纳入看板）和 references/example-output/（已完成的技能包示例：developer-triage、developer-pipeline-kanban）。
• 生成模板 — templates/skill-skeleton.md、templates/manifest.yaml.tmpl、templates/decision-map.md.tmpl、templates/kanban-board-setup.sh.tmpl 和 templates/kanban-task-blueprints.yaml.tmpl，用于生成技能包的文件。
• Agent 能力 — 宿主 Agent 需要技能管理工具（skill_view、skill_manage、skills_list）、用于存储 workflow-architect:state: 键的 memory tool、用于观察模式的会话上下文访问能力，以及用于输出技能包的文件写入能力。
• 可写的技能目录 — 生成的技能包会存放在 ~/.hermes/skills/<category>/<bundle-name>/；该位置必须可创建并可注册。

限制

• 输出面向 compatibility 中指定的 Hermes 风格技能运行时：技能包属于标准 Agent Skills，但通过 skill_manage(action='create') 注册以及使用 ~/.hermes/skills 路径都依赖于该环境。在其他运行时中，请手动将技能包复制到客户端的技能目录。
• 被动观察只能重建当前会话中发生的内容；如果实质性轮次少于大约 20 轮，推断结果会不足，应改用主动访谈。
• 生成的工作流质量取决于你在探索过程中所说或所做的内容——阶段、分支信号和退出标准都是根据证据推断得出的，而非凭空编造，因此输入信息不足会导致生成的技能包过于通用。
• 生成技能包会写入新的技能文件并注册技能；如果要覆盖同名的现有技能包，请先确认范围。