From a8f7ea9aed22e4ffde25d85bb9d2a73b6c96d05e Mon Sep 17 00:00:00 2001 From: Hare Date: Thu, 16 Jul 2026 04:03:06 +0900 Subject: [PATCH] ticket: replace workflow tracking with skills --- .yoi/tickets/00001KXKJGYGD/artifacts/.gitkeep | 0 .yoi/tickets/00001KXKJGYGD/item.md | 48 +++++++++++++++++++ .yoi/tickets/00001KXKJGYGD/thread.md | 7 +++ 3 files changed, 55 insertions(+) create mode 100644 .yoi/tickets/00001KXKJGYGD/artifacts/.gitkeep create mode 100644 .yoi/tickets/00001KXKJGYGD/item.md create mode 100644 .yoi/tickets/00001KXKJGYGD/thread.md diff --git a/.yoi/tickets/00001KXKJGYGD/artifacts/.gitkeep b/.yoi/tickets/00001KXKJGYGD/artifacts/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/.yoi/tickets/00001KXKJGYGD/item.md b/.yoi/tickets/00001KXKJGYGD/item.md new file mode 100644 index 00000000..48d8db00 --- /dev/null +++ b/.yoi/tickets/00001KXKJGYGD/item.md @@ -0,0 +1,48 @@ +--- +title: 'Replace workflow tracking with proper Skills support' +state: 'planning' +created_at: '2026-07-15T19:02:13Z' +updated_at: '2026-07-15T19:02:13Z' +assignee: null +--- + +## 背景 + +現在の Workflow は、Workflow resource を single-step な procedural prompt として提示し、ActiveWorkflowList / ActiveWorkflowComplete / ActiveWorkflowCancel で追跡する中途半端な obligation tracking になっている。Workflow を state machine や外部状態接続の制御機構へ育てると、Ticket queue 消化、Worker spawn、workdir 管理、review wait などは結局 Plugin / feature tool surface の責務になり、Workflow が半端なスクリプト言語になってしまう。 + +一方で、Yoi には既に Skills/SKILL.md 的な資源のサポートが部分的にあり、LLM に渡す再利用可能な手順・作法・報告形式は Skill として扱う方が自然。外部 authority や状態変更は typed feature/tool 側に置き、Skill は参照可能な procedural guidance としてちゃんとサポートする。 + +## 要件 + +- ActiveWorkflow tracking 系を削除する。 + - ActiveWorkflowList / ActiveWorkflowComplete / ActiveWorkflowCancel tools を削除する。 + - Worker durable state / compaction / rehydration / system-item extension から active workflow snapshot を削除する。 + - active workflow prompt / resident workflow obligation wording を削除または Skill 前提に置き換える。 +- 既存 Workflow resource の扱いを廃止または Skill 互換へ移行する。 + - `resources/workflows` / `.yoi/workflow` の長期 authority をやめる。 + - 必要な既存 reusable 手順は `SKILL.md` 形式へ移す。 + - workflow invocation `/slug` の扱いは削除するか、明示的な Skill invocation / Skill reference に置き換える。 +- Skills を first-class にする。 + - builtin skill と workspace skill の discovery / override / provenance を定義する。 + - Skill は `SKILL.md` を最小形とし、LLM-facing procedural guidance として扱う。 + - Skill は外部状態を直接制御しない。Ticket / Worker / workdir / queue などの authority は feature/tool surface が持つ。 +- Knowledge と Skill の境界を明確にする。 + - Knowledge は facts / rationale / reference。 + - Skill は task execution guidance / reusable procedure / report shape。 +- Plugin / feature との境界を明確にする。 + - Skill は prompt/resource。 + - Plugin / feature は typed tools、external state、authority、automation を提供する。 +- Coder review cycle や Orchestrator queue consumption は、Skill + Workspace/Ticket/Worker feature tools の組み合わせで設計できるようにする。 +- 既存 role prompts から Workflow 固有の記述を削除し、Skill を使う文言へ更新する。 +- Workflow 関連 crate/resource/API/test を削除または Skill 実装へ置き換え、不要な互換 layer を残さない。 + +## 受け入れ条件 + +- `ActiveWorkflow*` tools が model-visible tool schema から消えている。 +- active workflow state が Worker snapshot / compaction / rehydration に残らない。 +- Workflow resource discovery / invocation path が削除されるか、Skill discovery / invocation に置き換わっている。 +- builtin/workspace Skill の loading、override priority、provenance、lint が tests で確認されている。 +- 既存 workflow resources のうち残すべき手順は Skill に移行されている。 +- role prompts / internal prompts / docs が Workflow 前提ではなく Skill 前提に更新されている。 +- Ticket queue、Worker spawn、workdir 管理などの外部状態制御は Workflow/Skill ではなく feature/tool surface に残る。 +- affected crates の `cargo test` と `nix build .#yoi` が通る。 diff --git a/.yoi/tickets/00001KXKJGYGD/thread.md b/.yoi/tickets/00001KXKJGYGD/thread.md new file mode 100644 index 00000000..b5e6611f --- /dev/null +++ b/.yoi/tickets/00001KXKJGYGD/thread.md @@ -0,0 +1,7 @@ + + +## 作成 + +LocalTicketBackend によって作成されました。 + +---