[tkc310]

変更内容

スキルの一覧を追加し、エージェント向けの文書を 必要なときだけ読み込む 構成にしました（ADR-0018）。

スキルの一覧

• docs/skills.md を追加しました。スキルごとに、使う場面・主な成果物・段階ごとに読む文書と、呼び出し方・スキルの足し方をまとめています
• README（特長・ドキュメント・ディレクトリ構成）、AGENTS.md、CONTRIBUTING.md、docs/ai-agents.md からリンクしました。ai-agents.md と CONTRIBUTING.md に別々にあった表は、一覧へのリンクに置き換えています（ds-slides を足したとき片方だけが更新されていた問題の再発防止）

必要なときだけ読み込む仕組み

段階	いつ	何を置くか
0. 常に	会話の始め	AGENTS.md と各スキルの name・description（索引だけ）
1. スキルを使うとき	頼みごとが当てはまったとき	SKILL.md の本体（手順の骨組みだけ）
2. その段階に入ったとき	手順の中でその段階に来たとき	スキルのディレクトリの段階ごとの文書、docs/ の該当する節

• 大きいスキルを本体と段階ごとの文書に分けました（本体の字数は空白を除く）
  • design-principles: 4,565 → 1,901 字（mode-1-init.md・mode-2-adjust.md・mode-3-review.md・feedback.md）
  • ds-factory: 3,758 → 1,269 字（hearing.md・finish.md）
  • ds-slides: 3,550 → 1,395 字（authoring.md・verify.md）
  • ds-storybook-preview: 3,126 → 1,305 字（pr-body.md・setup.md）
• design-init / design-adjust / design-review は、design-principles のモードの文書を指すだけにして重複をなくしました
• ds-build-ui は、33KB の DESIGN.md の全文ではなく、必要な節だけを読む手順にしました
• AGENTS.md に「読み込みの方針」を足しました

再発防止

scripts/check-skills.ts を make check に追加しました。name とディレクトリ名の一致、description、一覧への掲載、本体 2,000 字以内、リンク切れ、どこからも参照されない文書を検査します。わざと壊したスキルで 5 種類とも検出できること、ファクトリーで生成したリポジトリでも通ること（ds-factory は一覧ごと除かれる）を確認しました。

内容の変更はなく、文書の置き場所を分けただけです（ds-storybook-preview の jq の例だけ、ADR-0016 後のディレクトリ名 /Button/ に合わせました）。

Storybook プレビュー

なし（文書とスクリプトのみ）

完了の定義

• PR のタイトルが Conventional Commits の形式
• make check と make test が通る（作業環境から npm に届かないため CI で確認。node scripts/check-skills.ts と node scripts/slides/check.ts は手元で通過）
• changeset を追加した（公開パッケージは変更なしのため不要）
• ライト / ダークの両方で見た目を確認した（見た目の変更なし）
• キーボードで操作でき、フォーカス表示が見える（該当なし）
• 新しい semantic カラーを足した場合 → 追加なし
• 値や方針を変えた場合、docs/decisions/ に ADR を足した（0018）

改善ループ

• docs/improvement/log.md に 1 行追記した
• 再発防止として追加したもの: scripts/check-skills.ts（make check）

---

Generated by Claude Code