ticket: record current skills support

.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-15T19:45:40Z'
+updated_at: '2026-07-15T19:56:41Z'
 assignee: null
 ---
 

.yoi/tickets/00001KXKMX0QM/thread.md

@@ -4,4 +4,84 @@
 
 LocalTicketBackend によって作成されました。
 
+---
+
+<!-- event: comment author: hare at: 2026-07-15T19:56:41Z -->
+
+## Comment
+
+## Current implementation check: Skills support
+
+現行の Skills support は存在するが、first-class Skill ではなく **Workflow ingestion の一部**として実装されている。
+
+### 既にあるもの
+
+- `crates/workflow/src/skill.rs` に `SKILL.md` parser がある。
+  - `<skills-root>/<name>/SKILL.md` を読む。
+  - YAML frontmatter + Markdown body を要求する。
+  - `name` / `description` は required。
+  - `name` は parent directory name と一致する必要がある。
+  - `name` は既存 `Slug` validation を通る必要がある。
+  - `description` は non-empty かつ `WORKFLOW_DESCRIPTION_HARD_CAP` 以内。
+  - `license` / `compatibility` / `metadata` / `allowed-tools` は parse 上は受理する。
+  - unknown frontmatter fields は warning で無視する。
+  - `allowed-tools` は warning を出すだけで enforcement しない。
+- `load_skills_from_dir(root)` がある。
+  - root 直下の directory だけを見て、各 `<name>/SKILL.md` を読む。
+  - broken skill は warning で skip し、siblings は読み続ける。
+  - missing root は empty 扱い。
+  - deterministic order で読み込む。
+- `manifest` に `[skills] directories = [...]` がある。
+  - path は manifest/profile base から resolve される。
+  - validation 後は absolute path required。
+  - profile/manifest merge で directories は extend される。
+- Worker startup で `[skills].directories` が scope read allow に追加される。
+  - skill root は recursive read allow になる。
+  - `SKILL.md` / `scripts/` / `references/` / `assets/` 全体を通常 Read できる。
+- Worker startup で Skills が workflow registry に取り込まれる。
+  - `SkillRecord::into_workflow_record()` により Skill が `WorkflowRecord` に変換される。
+  - `model_invokation = true`、`user_invocable = true`。
+  - つまり Skill は `/<slug>` で呼べる Workflow として扱われる。
+- shadowing support がある。
+  - internal/builtin/workspace Workflow が同 slug を持つ Skill より優先される。
+  - 複数 skill directories 間では first-fed wins。
+  - shadowed Skill は Worker notification に `[Skill shadowed] ...` として流れる。
+- tests は parser / directory loading / Workflow projection / scope allow / ingest_skills をある程度カバーしている。
+
+### 現行の限界
+
+- Skill は first-class ではなく、WorkflowRecord へ projection されている。
+  - Skill catalog / Skill activation / Skill provenance は Workflow registry に埋もれる。
+  - Workflow 削除 Ticket と衝突する構造になっている。
+- `.yoi/skills/` は implicit workspace Skill root ではない。
+  - 現在は `[skills].directories` に明示された root だけを読む。
+  - default workspace path として `.yoi/skills` を probe しない。
+- builtin skills はない。
+  - `resources/skills/<name>/SKILL.md` のような bundled layout は未定義。
+- Progressive disclosure は不完全。
+  - metadata は resident workflow entry として出るが、Skill catalog と full body activation が分離されていない。
+  - full `SKILL.md` body は workflow invocation body として扱われるだけ。
+  - `references/` / `scripts/` / `assets/` はただ read-scope に入るだけで、Skill-aware access/tooling はない。
+- `allowed-tools` は authority に反映されない。
+  - parser は認識するが warning のみ。
+  - feature/tool permission と合成しない。
+- frontmatter optional fields は保持されない。
+  - `license` / `compatibility` / `metadata` は parse acceptance のみで、SkillRecord / catalog には残らない。
+- lint surface が独立していない。
+  - parser tests はあるが、`yoi skill lint` のような user-facing lint/check はない。
+- Skill resource safety は最小限。
+  - skill root を recursive read allow にしているだけ。
+  - relative references / nested reference chain / script execution policy は未実装。
+- Web Workspace UI / backend API はない。
+  - `.yoi/skills` の list / validation / edit surface は未実装。
+- current docs/comments は Skill を Workflow ingestion として説明しており、今後の方針と逆。
+  - `crates/workflow/src/skill.rs` の module docs も「ingests it as a Workflow」と明記している。
+
+### 現在地まとめ
+
+現在の Skills support は **Agent Skills parser + manifest-configured directory ingest + Workflow compatibility projection** まで。Agent Skills 標準の directory shape と basic frontmatter validation は部分的にあるが、Yoi の Skill としての lifecycle / catalog / activation / provenance / lint / UI / authority boundary は未実装。
+
+この Ticket の実装では、まず Workflow projection から切り離して、`.yoi/skills/<skill-name>/SKILL.md` を workspace Skill authority として扱う first-class Skill loader/catalog へ移す必要がある。
+
+
 ---