workflow-architect

ワークフローアーキテクト

あなた（およびあなたのエージェント）が、実際にどのように作業しているのかを把握するためのメタスキルです。能動的な質問または受動的な観察を通じてワークフローのパターンを見つけ出し、スキルバンドルを生成します。スキルバンドルには、トリガー条件を備えた読み込み可能なスキルが含まれ、ワークフローをエンコードすることで、エージェントがどのセッションでもあなたの状況に合わせて対応できるようにします。

得られるもの

workflow-architect を実行すると、エージェントのスキルディレクトリに新しいバンドルが作成されます。内容は次のとおりです。

• アンブレラ SKILL.md — 説明内のトリガー条件によってバンドルを自動検出できるようにするエントリーポイントです。skill_view(name='<bundle-name>') で読み込むか、トリガーに一致する内容を伝えると、エージェントが自動的に検出します。
• サブスキル — ワークフローの各フェーズにつき 1 つずつ用意されます。それぞれの description で、エージェントがいつ読み込むべきかを指定します（例：「ユーザーが朝のトリアージルーチンを始めたときに読み込む」や「ユーザーが集中作業モードに切り替えたときに使う」）。
• マニフェスト — スキル名をトリガー条件、エントリーポイント、遷移シグナルに対応付けます。
• 意思決定マップ — エージェントから見たワークフローを可視化する Mermaid フローチャートです。
• カンバンボード（任意）— WIP 制限やレーン間の遷移が役立つ、予測可能な直線的な流れにワークフローが沿っている場合にのみ含まれます。

アンブレラとサブスキルは skill_manage(action='create') で登録されるため、skills_list() に表示され、今後のセッションですぐに読み込めます。

2 つのモード

Workflow-architect は、希望する進め方に合わせて対応します。

モード 1：能動的な質問（一回で実施）

使用する場面： 作業の進め方について話す時間が数分ある場合です。最も徹底的なモードで、エージェントが誘導する質問を行い、回答に応じて質問を分岐させながら、やり取りを重ねてワークフローのモデルを構築します。

呼び出し方：

/workflow-architect

エージェントが 8～15 問ほどの会話を案内します。自然に回答してください。スキルは、回答内容に応じて質問の切り口を調整します。

モード 2：受動的な観察

使用する場面： すでに実際の作業を行うセッション中で、作業を中断して振り返るのは避けたい場合です。このモードに実際の行動を観察させ、その後、行動からワークフローのパターンを推測させます。

呼び出し方：

/workflow-architect passive

エージェントはオブザーバースキルを通知なしで読み込みます。以下のトリガーフレーズのいずれかを伝えるまで何も行いません。伝えると、現在のセッションのメッセージ履歴をスキャンし、実際に起きたことからワークフローを再構築します。

トリガーフレーズ（いずれかを伝えると観察分析が始まります）：

• 「私のワークフローを整理して」
• 「私のワークフローは？」
• 「私の作業プロセスを分析して」
• 「私が何をしているのか解明して」
• 「今やったことから推測して」

制限事項： 観察モードは、実質的な作業を 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>') で少なくとも 1 つのサブスキルが読み込めることを確認します。保存先、含まれるスキル、ワークフローを開始するために使えるトリガーフレーズをユーザーに伝えます。

インタビューで構築する内容

インタビュアー（および推論を通じて観察者）は、次の観点からなる構造化モデルを構築します。

観点	把握する内容
開始点	セッションが通常どのように始まるか
フェーズ	ワークフローにおける明確に異なるモードや段階
分岐シグナル	各分岐で、どちらに進むかを決める要因
ツールの選好	各フェーズで何を使うか
ループ条件	あるモードを続ける条件と、そこから抜ける条件
終了基準	セッションの完了をどう判断するか
課題点	摩擦や非効率を感じる点

環境

環境変数は必要ありません。状態は、複数ターンにわたるインタビュー中も保持されるよう、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 です。
• エージェントの機能 — ホストエージェントには、スキル管理ツール（skill_view、skill_manage、skills_list）、workflow-architect:state: キー用のメモリツール、観察モード用のセッションコンテキストへのアクセス、およびバンドル出力用のファイル書き込み機能が必要です。
• 書き込み可能なスキルディレクトリ — 生成されたバンドルは ~/.hermes/skills/<category>/<bundle-name>/ に保存されます。この場所を作成でき、登録可能である必要があります。

制限事項

• 出力は compatibility に記載された Hermes スタイルのスキルランタイムを対象としています。バンドルは標準的な Agent Skills ですが、skill_manage(action='create') による登録と ~/.hermes/skills パスは、その環境を前提としています。他のランタイムでは、バンドルをクライアントのスキルディレクトリに手動でコピーしてください。
• 受動的な観察では、現在のセッションで起きたことのみを再構成します。実質的なターン数が約20未満の場合は推論が不十分になるため、アクティブな質問に切り替えてください。
• 生成されるワークフローの品質は、発見の過程での発言や行動に左右されます。フェーズ、分岐シグナル、終了基準は証拠から推測するもので、創作するものではありません。そのため、入力が少ないと汎用的なバンドルになります。
• バンドルの生成では、新しいスキルファイルを書き込み、登録します。同じ名前の既存バンドルを上書きする前に、対象範囲を確認してください。