77 lines
5.3 KiB
Markdown
77 lines
5.3 KiB
Markdown
# Workflow 実装
|
||
|
||
## 背景
|
||
|
||
`docs/plan/workflow.md` で決まった「制約付きの強制的な作業フロー」を `/<slug>` で呼び出せるようにする。Knowledge (`#<slug>`) を依存として inject できる経路を持つことで、procedural な能力を再利用可能な単位に固定する。
|
||
|
||
memory 機構（`docs/plan/memory.md`）からは独立してスタートできる: Workflow は人間が書く / consolidation の offer 経由でしか作られず、自動書き込み禁止のため Phase 2 の前提に依存しない。Knowledge resolver は `requires` の inject 経路として相互依存する。
|
||
|
||
agent-skills (agentskills.io 形式) は本チケットの ingest 経路を再利用して Workflow として読み込む側になる（`tickets/agent-skills.md` 参照）。
|
||
|
||
## 決定事項の参照
|
||
|
||
詳細は `docs/plan/workflow.md` 参照。要点のみ:
|
||
|
||
- 呼び出し: `/<slug>`、フラットな名前空間、kebab-case
|
||
- 配置: `<workspace_root>/.insomnia/memory/workflow/<slug>.md`（ファイル名 = slug、frontmatter に `name` を持たない）
|
||
- frontmatter: `description` / `auto_invoke` (default OFF) / `user_invocable` (default ON) / `requires: [knowledge-slug, ...]`
|
||
- 実行: `requires` の Knowledge 本文を context に inject してから Workflow 本文を実行
|
||
- 自動書き込み禁止（consolidation の write tool schema に `workflow` カテゴリを含めないことで構造的に担保。Linter で人間にも見える形で再保証）
|
||
|
||
## 方針
|
||
|
||
### MVP スコープ
|
||
|
||
1. **Workflow loader / 検証**
|
||
- `<workspace_root>/.insomnia/memory/workflow/*.md` を走査
|
||
- frontmatter を仕様通り検証。必須欠落・型不一致・slug とファイル名の不一致は hard error（Pod 起動失敗）
|
||
- 未知フィールドは `tracing::warn!` して無視（既存 manifest と同方針）
|
||
- 重複 slug は最初に見つかったものを採用 + warn（後述の skill ingest が乗ると衝突解決ルールが追加で必要になる）
|
||
|
||
2. **`/<slug>` 呼び出し経路**
|
||
- `Segment::WorkflowInvoke { slug }` を Pod 側で resolve
|
||
- 解決失敗（slug 未登録 / `user_invocable: false`）は `ToolError` 相当でユーザーに返し、Worker には届かない
|
||
- `requires` の Knowledge 本文を Knowledge 検索ツールの slug 完全一致経路で取得し、Workflow 本文の前に context へ inject
|
||
- Workflow 本文は Markdown のままサブミット内容として扱う（DSL 化はしない）
|
||
|
||
3. **`auto_invoke` 注入**
|
||
- `auto_invoke: true` な Workflow の `description` を通常 Pod の system prompt に常駐注入する。Phase 2 prompt には入れない
|
||
- 予算は Knowledge の常駐注入（`memory.md` §retrieval 経路）と合算管理。description 上限は agentskills 準拠の 1024 chars に揃える
|
||
|
||
4. **Linter ルール**
|
||
- `memory/workflow/*.md` への write/edit は memory 専用 Tool 経由でのみ許可（汎用 Write/Edit は Scope deny）
|
||
- consolidation の write tool schema からは `workflow` カテゴリを除外（自動書き込み禁止の構造的担保）
|
||
- Workflow 自体の Linter は frontmatter 検証 + slug/ファイル名一致のみ。意味検証は将来検討
|
||
|
||
### 範囲外
|
||
|
||
- DSL 化や step 粒度の制約（Markdown 本文をそのまま実行）
|
||
- 中断・再開・トランザクション管理
|
||
- 品質検証フロー（external author empirical-prompt-tuning 相当、`docs/plan/workflow.md` §将来検討）
|
||
- LLM による Workflow 自律生成（offer までで留める方針は本チケットでは扱わず、consolidation 側の責務）
|
||
- Knowledge 検索ツール本体の実装（memory チケット側）。本チケットは slug 完全一致経路の利用者に留まる
|
||
|
||
## 完了条件
|
||
|
||
- `<workspace_root>/.insomnia/memory/workflow/*.md` をロードし、frontmatter 違反は Pod 起動エラーになる
|
||
- `/<slug>` を含む submit が `Segment::WorkflowInvoke` として送られ、Pod 側で `requires` Knowledge を inject した上で本文が実行される
|
||
- `auto_invoke: true` の Workflow description が通常 Pod の system prompt に列挙される
|
||
- `user_invocable: false` の Workflow は `/<slug>` 補完候補から除外され、明示呼び出しもエラーになる
|
||
- 単体テストで frontmatter 検証の正常 / 異常系、`requires` 解決、フラグ別の挙動が verify される
|
||
|
||
## 実装順序
|
||
|
||
1. `manifest` または既存 memory クレートに `Workflow` 構造体と `WorkflowDirectoryLoader` を置く。frontmatter パースと検証のみでテスト完結
|
||
2. Pod に Workflow registry を持たせ、`auto_invoke` description の system prompt 注入を組む
|
||
3. `Segment::WorkflowInvoke` の resolver を Pod 側に実装。Knowledge 検索ツールの slug 完全一致経路で `requires` を inject
|
||
4. 汎用 Write/Edit に対する `memory/workflow/` deny を Scope に追加、Linter 仕上げ
|
||
|
||
各ステップ終了時点でビルド通過・既存テスト合格を維持する。
|
||
|
||
## 参照
|
||
|
||
- 設計: `docs/plan/workflow.md`
|
||
- Knowledge / `#<slug>` の retrieval: `docs/plan/memory.md` §retrieval 経路
|
||
- Submit segment: `tickets/submit-tui-completion.md`（`Atom::WorkflowInvoke`）、`tickets/session-log-segments.md`
|
||
- 後続: `tickets/agent-skills.md`（外部 SKILL を Workflow として ingest する経路）
|