yoi/.yoi/tickets/00001KXKJGYGD/item.md

title	state	created_at	updated_at	assignee
Replace workflow tracking with proper Skills support	planning	2026-07-15T19:02:13Z	2026-07-15T19:02:13Z	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 が通る。