From 7a71d9c114a2f720efa046d7f577a6ee59fec045 Mon Sep 17 00:00:00 2001 From: Hare Date: Thu, 16 Jul 2026 06:02:43 +0900 Subject: [PATCH] ticket: require workspace skills api --- .yoi/tickets/00001KXKMX0QM/item.md | 15 ++++++++++++++- .yoi/tickets/00001KXKMX0QM/thread.md | 11 +++++++++++ 2 files changed, 25 insertions(+), 1 deletion(-) diff --git a/.yoi/tickets/00001KXKMX0QM/item.md b/.yoi/tickets/00001KXKMX0QM/item.md index 6d7ae6d4..a50a383e 100644 --- a/.yoi/tickets/00001KXKMX0QM/item.md +++ b/.yoi/tickets/00001KXKMX0QM/item.md @@ -2,7 +2,7 @@ title: 'Implement Agent Skills support' state: 'planning' created_at: '2026-07-15T19:43:46Z' -updated_at: '2026-07-15T20:43:42Z' +updated_at: '2026-07-15T21:02:33Z' assignee: null --- @@ -60,6 +60,13 @@ Agent Skills 標準に従い、workspace-local Skills は `.yoi/skills/` 配下 - Skill discovery / lint / catalog / activation の authority は Workspace backend とする。 - `.yoi/skills/` は tracked workspace data の保存場所であり、Worker が各自で filesystem scan する source of truth ではない。 - Web Workspace UI、Runtime Worker、embedded Worker、CLI は Workspace backend API 経由で同じ Skill view を得る。 +- Ticket backend API と同様に、Worker / Runtime process が Workspace backend 経由で Skill を扱える typed API を整備する。 + - Skill catalog/list endpoint。 + - Skill detail/read endpoint。 + - Skill lint/diagnostics endpoint。 + - Skill activation body endpoint。 + - references / assets の resource read endpoint、または backend-resolved authority を返す endpoint。 + - 必要なら Worker-facing Skill operation endpoint を用意し、Worker-local filesystem scan に依存しない。 - Workspace backend は Skill catalog API を提供する。 - `name` / `description` / source / provenance / override status / diagnostics を返す。 - invalid Skill は catalog diagnostics として報告し、Worker ごとにばらばらな parse behavior を持たせない。 @@ -102,6 +109,11 @@ Agent Skills 標準に従い、workspace-local Skills は `.yoi/skills/` 配下 - override priority。 - provenance reporting。 - invalid Skill diagnostics。 +- Workspace Skill API tests を追加する。 + - catalog/list が Workspace settings と `.yoi/skills` を authority として使うこと。 + - detail/read/activation body が同じ Skill resolution を使うこと。 + - lint diagnostics が Worker / Web / CLI で共有できる response schema になること。 + - Worker-facing API 経由で Skill activation でき、Worker-local scan と結果が分岐しないこと。 ## 要決定事項 @@ -132,6 +144,7 @@ Agent Skills 標準に従い、workspace-local Skills は `.yoi/skills/` 配下 - `.yoi/skills//SKILL.md` が Agent Skills 標準の required frontmatter と naming rules で Workspace backend によって lint される。 - builtin/workspace Skill の loading、override priority、provenance、lint が Workspace backend API tests で確認されている。 +- Ticket backend API と同様に、Worker / Runtime process / Web / CLI が共有できる Skill catalog/read/lint/activation API が整備され、tests で確認されている。 - Worker / Web / CLI が同じ Workspace backend Skill catalog を参照し、Worker-local filesystem scan が primary authority になっていないことを tests で確認している。 - Full `SKILL.md` body は activation 時にのみ Workspace backend から取得されて LLM context に入り、metadata catalog と progressive disclosure の分離が tests で確認されている。 - Workflow projection 由来の標準外 Skill fields / semantics が Skill schema から除去され、Agent Skills 標準 field と明示的な Yoi 拡張だけが受理されることを tests で確認している。 diff --git a/.yoi/tickets/00001KXKMX0QM/thread.md b/.yoi/tickets/00001KXKMX0QM/thread.md index 2a9bc7eb..d88a7384 100644 --- a/.yoi/tickets/00001KXKMX0QM/thread.md +++ b/.yoi/tickets/00001KXKMX0QM/thread.md @@ -97,4 +97,15 @@ Workspace backend を Skill discovery / lint / catalog / activation の authorit これにより、Skill の override/provenance/lint diagnostics、Web からの編集・検証、Worker への progressive disclosure を同じ authority に寄せる。 +--- + + + +## Decision + +Skill support should mirror the Ticket backend direction: Workspace backend owns the shared authority and exposes typed APIs for Worker / Runtime process / Web / CLI access. + +Required API surface includes catalog/list, detail/read, lint/diagnostics, activation body retrieval, and resource access or backend-resolved authority for references/assets. Worker-local filesystem scanning must not become the primary authority when `WorkspaceClient::Http` is available. + + ---