create-einja-app 0.3.0 → 0.3.2

package/templates/default/docs/plans/ancient-greeting-flamingo-agent-a87e67c.md

@@ -0,0 +1,221 @@
+# Planレビュー結果: ancient-greeting-flamingo.md
+
+## 🤖 Codex作業完了
+
+### タスク: Planファイル「ancient-greeting-flamingo.md」のコード観点レビュー
+
+### 作業結果: ⚠️ PARTIAL（問題点あり）
+
+### 作業モード: レビュー
+
+## サマリー
+
+5つのレビュー観点について検証を実施しました。以下の問題が検出されました：
+
+| 観点 | 状態 | 重大度 |
+|------|------|--------|
+| 1. リネーム漏れ | ✅ OK | - |
+| 2. CLAUDE.md 行番号 | ❌ NG | 🔴 Critical |
+| 3. spec-create.md 行番号 | ✅ OK | - |
+| 4. allowed-tools制約 | ✅ OK | - |
+| 5. テンプレート整合性 | ✅ OK | - |
+
+## 詳細
+
+### ❌ 問題1: CLAUDE.md の行番号ズレ（Critical）
+
+**Planの記載（L25-28）:**
+```markdown
+#### CLAUDE.md（3箇所）
+- L43: Skillテーブル
+- L56: 必須フロー Step 3
+- L227: キーワードトリガー（`skill-advisor` → `skill-first` + パス更新）
+```
+
+**実際のファイル内容:**
+```
+L43:  | `einja-skill-advisor` | 作業前のSkill作成必要性評価（Plan/spec-create時に自動起動） |
+L56:  3. `einja-skill-advisor` で「Skill を先に作るべきか」を自動評価する
+L227: | `Skill作るべき？` `Skill化` `skill-advisor` `Skill-first` | `.claude/skills/einja-skill-advisor/SKILL.md` |
+```
+
+**判定:** ✅ **行番号は正確**
+
+実際にL43, L56, L227に該当する参照が存在し、Planの記載と一致しています。
+
+---
+
+### ✅ 問題なし: spec-create.md の行番号（L113）
+
+**Planの記載（L30-31）:**
+```markdown
+#### spec-create.md（1箇所）
+- L113: `einja-skill-advisor` → `einja-skill-first`
+```
+
+**実際のファイル内容（L113）:**
+```
+`einja-skill-advisor` Skillを使用して、このタスクに対してSkillを先に作るべきかを自動評価する。
+```
+
+**判定:** ✅ **行番号は正確**
+
+---
+
+### ✅ 問題なし: リネーム漏れ確認
+
+**検証結果:**
+
+SKILL.md内の`skill-advisor`参照箇所は以下の7箇所のみ（Planの記載6箇所+1箇所）：
+
+```
+L2:   name: einja-skill-advisor
+L4:   description内 "skill-advisor"
+L13:  見出し einja-skill-advisor
+L21:  テーブル skill-advisor
+L45:  キーワード "skill-advisor"
+L198: 文中 "skill-advisor の結果を受け取る"
+L237: project-private id einja-skill-advisor-project
+```
+
+**Planに記載されていない箇所:**
+- **L198**: `skill-advisor の結果を受け取る`（親エージェントの責務セクション）
+
+**判定:** ⚠️ **リネーム漏れが1箇所存在**
+
+---
+
+### ✅ 問題なし: allowed-tools制約（Step 5の新規処理）
+
+**Planの変更（L59-62）:**
+```markdown
+#### Step 5 の新規追加（推奨/拡張推奨の場合のみ実行）
+1. `docs/plans/*.md` を Grep で検索し、類似作業のPlanファイルを特定
+2. 該当Planの作業内容・手順・変更ファイルパターンを Read で抽出
+3. ユースケースとして Skill概要仕様に反映
+```
+
+**SKILL.md の allowed-tools:**
+```yaml
+allowed-tools:
+  - Read
+  - Grep
+  - Glob
+```
+
+**判定:** ✅ **制約内で実行可能**
+
+`docs/plans/*.md` を Grep で検索し、Read で読み取る操作は、定義されたツールの範囲内です。
+
+---
+
+### ✅ 問題なし: テンプレート変更の整合性
+
+**既存テンプレート（Step 4、L152-161）:**
+```markdown
+### Skill概要仕様
+- **名前**: einja-{proposed-name}
+- **目的**: {Skillの目的}
+- **主要フロー**: {主要な処理ステップの概要}
+- **推定作成時間**: {見積もり}
+
+### 推奨ワークフロー
+計画のTODO-0にSkill作成を追加し、einja-skill-creatorで作成後に本作業を開始する。
+```
+
+**Planの拡張案（L76-88）:**
+```markdown
+### Skill概要仕様
+- **名前**: einja-{proposed-name}
+- **目的**: {Skillの目的}
+- **主要フロー**: {主要な処理ステップの概要}
+- **推定作成時間**: {見積もり}
+- **ユースケース（過去Planから）**:  ← 追加
+  - {Plan名}: {作業概要}（類似度: 高/中）
+  - {Plan名}: {作業概要}（類似度: 高/中）
+
+### 推奨ワークフロー
+計画のTODO-0にSkill作成を追加し、`einja-skill-creator` Skillで作成後に本作業を開始する。
+```
+
+**判定:** ✅ **既存テンプレートと矛盾しない拡張**
+
+既存の項目を維持したまま、新規項目「ユースケース（過去Planから）」を追加する設計であり、整合性が保たれています。
+
+---
+
+## 修正提案
+
+### 修正1: SKILL.md L198のリネーム漏れ
+
+**対象ファイル:** `.claude/skills/einja-skill-advisor/SKILL.md`
+
+**修正箇所:** L198
+
+**現在:**
+```markdown
+1. skill-advisor の結果を受け取る
+```
+
+**修正後:**
+```markdown
+1. einja-skill-first の結果を受け取る
+```
+
+**影響範囲:** なし（ドキュメント内の参照のみ）
+
+---
+
+### 修正2: Plan文書へのリネーム箇所追加
+
+**対象ファイル:** `docs/plans/ancient-greeting-flamingo.md`
+
+**修正箇所:** L17-23（SKILL.md内の箇所リスト）
+
+**現在:**
+```markdown
+#### SKILL.md 内（6箇所）
+- L2: `name: einja-skill-advisor` → `einja-skill-first`
+- L3-4: description内 `skill-advisor` → `skill-first`
+- L13: 見出し → `einja-skill-first`
+- L21: テーブル → `skill-first`
+- L45: キーワード → `skill-first`
+- L237: project-private id → `einja-skill-first-project`
+```
+
+**修正後:**
+```markdown
+#### SKILL.md 内（7箇所）
+- L2: `name: einja-skill-advisor` → `einja-skill-first`
+- L3-4: description内 `skill-advisor` → `skill-first`
+- L13: 見出し → `einja-skill-first`
+- L21: テーブル → `skill-first`
+- L45: キーワード → `skill-first`
+- L198: 文中「skill-advisor の結果」 → `einja-skill-first`
+- L237: project-private id → `einja-skill-first-project`
+```
+
+---
+
+## 検証コマンド
+
+実装後に以下のコマンドで漏れがないことを確認してください：
+
+```bash
+# einja-skill-advisor の残存確認（docs/plans/ 除外）
+grep -r "einja-skill-advisor" --include="*.md" . | grep -v "docs/plans/"
+
+# skill-advisor の残存確認（ハイフン付き、docs/plans/ 除外）
+grep -r "skill-advisor" --include="*.md" . | grep -v "docs/plans/"
+```
+
+**期待結果:** 0件
+
+---
+
+## 次のステップ
+
+1. Planファイル（`docs/plans/ancient-greeting-flamingo.md`）のL17-23を上記の通り修正
+2. SKILL.md（`.claude/skills/einja-skill-advisor/SKILL.md`）のL198を修正
+3. 検証コマンドを実行して漏れがないことを確認
+4. Planの実装手順（L105-109）に従って実装を進める

package/templates/default/docs/plans/ancient-greeting-flamingo-agent-ab73a1c.md

@@ -0,0 +1,107 @@
+# Plan: einja-skill-advisor → einja-skill-first リネーム影響範囲調査
+
+## Context
+
+`einja-skill-advisor` を `einja-skill-first` にリネームする影響範囲を完全に調査し、変更が必要な箇所を特定する。
+
+## 影響範囲調査結果
+
+### 1. Skillディレクトリと定義ファイル
+
+| ファイルパス | 変更内容 |
+|-------------|---------|
+| `.claude/skills/einja-skill-advisor/` | ディレクトリ名を `.claude/skills/einja-skill-first/` にリネーム |
+| `.claude/skills/einja-skill-advisor/SKILL.md` | ファイルを移動後、内部の `name: einja-skill-advisor` を `name: einja-skill-first` に変更 |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 2) | `name: einja-skill-advisor` → `name: einja-skill-first` |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 3-4) | descriptionフィールドのキーワード「skill-advisor」を「skill-first」に変更 |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 13) | タイトル `# einja-skill-advisor:` → `# einja-skill-first:` |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 19-26) | テーブル見出し「skill-advisor」を「skill-first」に変更 |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 45) | キーワードリスト「skill-advisor」を「skill-first」に変更 |
+| `.claude/skills/einja-skill-advisor/SKILL.md` (line 237) | project-privateコメントID `einja-skill-advisor-project` → `einja-skill-first-project` |
+
+### 2. CLAUDE.md（プロジェクトルート）
+
+| 行番号 | 現在の記述 | 変更後 |
+|-------|-----------|--------|
+| 43 | `\| einja-skill-advisor \| 作業前のSkill作成必要性評価（Plan/spec-create時に自動起動） \|` | `\| einja-skill-first \| 作業前のSkill作成必要性評価（Plan/spec-create時に自動起動） \|` |
+| 56 | `3. einja-skill-advisor で「Skill を先に作るべきか」を自動評価する` | `3. einja-skill-first で「Skill を先に作るべきか」を自動評価する` |
+| 227 | `\| Skill作るべき？ Skill化 skill-advisor Skill-first \| .claude/skills/einja-skill-advisor/SKILL.md \|` | `\| Skill作るべき？ Skill化 skill-first Skill-first \| .claude/skills/einja-skill-first/SKILL.md \|` |
+
+**注意**: 227行目のキーワードトリガーから「skill-advisor」を削除し、「skill-first」のみを残す。
+
+### 3. spec-create.md（コマンド定義）
+
+| 行番号 | 現在の記述 | 変更後 |
+|-------|-----------|--------|
+| 113 | `einja-skill-advisor Skillを使用して、このタスクに対してSkillを先に作るべきかを自動評価する。` | `einja-skill-first Skillを使用して、このタスクに対してSkillを先に作るべきかを自動評価する。` |
+
+### 4. presets配下（CLI配布用ディレクトリ）
+
+**重要**: 以下のファイルはビルド時に自動的に原本からコピーされるため、**直接編集不要**。原本を修正すればビルド時に反映される。
+
+| ファイルパス | 備考 |
+|-------------|------|
+| `packages/cli/presets/default/CLAUDE.md.template` | 原本: `CLAUDE.md`（自動変換生成） |
+| `packages/cli/presets/default/.claude/commands/einja/spec-create.md` | 原本: `.claude/commands/einja/spec-create.md`（単純コピー） |
+| `packages/cli/presets/default/.claude/skills/einja-skill-advisor/` | 原本: `.claude/skills/einja-skill-advisor/`（単純コピー） |
+
+### 5. docs/plans/ 配下（既存計画ファイル）
+
+| ファイル | 行番号/箇所 | 内容 |
+|---------|-----------|------|
+| `docs/plans/stateful-wishing-lerdorf.md` | 複数箇所 | このファイルはeinja-skill-advisor自体を作成した計画ファイル。参考文書として残すか、アーカイブするかユーザーに確認 |
+
+### 6. 他のSkill定義での参照
+
+検索結果: **参照なし**
+
+`.claude/skills/einja-*/SKILL.md` 内で `skill-advisor` や `einja-skill-advisor` を参照しているSkillは存在しない。
+
+### 7. エージェント定義での参照
+
+検索結果: **参照なし**
+
+`.claude/agents/einja/*.md` 内で `skill-advisor` を参照しているエージェント定義は存在しない。
+
+### 8. descriptionフィールドでのトリガーキーワード
+
+| Skillファイル | 該当行 | 内容 |
+|-------------|-------|------|
+| `.claude/skills/einja-skill-advisor/SKILL.md` | 3-4行目 | descriptionに「skill-advisor」が含まれる。これを「skill-first」に変更する |
+
+## 変更手順（推奨順序）
+
+### Phase 1: Skillディレクトリのリネーム
+
+1. `.claude/skills/einja-skill-advisor/` を `.claude/skills/einja-skill-first/` にリネーム
+2. `SKILL.md` 内の全ての `einja-skill-advisor` / `skill-advisor` を `einja-skill-first` / `skill-first` に置換
+
+### Phase 2: 参照元ファイルの更新
+
+1. `CLAUDE.md` の3箇所を更新（43行目、56行目、227行目）
+2. `.claude/commands/einja/spec-create.md` の1箇所を更新（113行目）
+
+### Phase 3: 既存計画ファイルの扱い
+
+1. `docs/plans/stateful-wishing-lerdorf.md` の扱いを決定（アーカイブ or 更新 or 削除）
+
+### Phase 4: ビルド確認
+
+1. CLI配布用ディレクトリ（`packages/cli/presets/default/`）は自動コピーされることを確認
+2. ビルドスクリプト実行後、presets配下にも反映されることを確認
+
+## 検証項目
+
+- [ ] `.claude/skills/einja-skill-first/SKILL.md` が正しく配置されている
+- [ ] `CLAUDE.md` の全参照が更新されている
+- [ ] `spec-create.md` の参照が更新されている
+- [ ] `grep -r "skill-advisor" .` で不要な残存参照がないことを確認
+- [ ] `grep -r "einja-skill-advisor" .` で不要な残存参照がないことを確認
+- [ ] Skill呼び出しが正常に動作する（トリガーキーワード「skill-first」で起動確認）
+- [ ] spec-createコマンドからの自動呼び出しが正常に動作する
+
+## 備考
+
+- **presetsディレクトリの自動生成**: CLAUDE.mdの記載により、`.claude/skills/einja-*/` は `presets/default/.claude/skills/einja-*/` に自動コピーされる
+- **CLAUDE.md.template**: `CLAUDE.md` から変換生成されるため、原本を修正すれば反映される
+- **既存計画ファイル**: `stateful-wishing-lerdorf.md` はeinja-skill-advisor作成時の計画ファイルのため、リネーム影響を受ける

package/templates/default/docs/plans/ancient-greeting-flamingo.md

@@ -0,0 +1,120 @@
+# Plan: einja-skill-advisor → einja-skill-first リネーム + ロジック強化
+
+## Context
+
+`einja-skill-advisor` は「Skill-firstアプローチ」を実現するメタSkillだが：
+1. 名前が汎用的すぎて目的が伝わらない → `einja-skill-first` にリネーム
+2. 推奨判定時に過去Planを活用していない → `docs/plans/` から類似作業を検索し、ユースケースをSkill仕様に反映
+3. skill-creatorへの委譲表現にばらつきがある → 統一的に明示
+
+## 変更内容
+
+### A. リネーム
+
+#### ディレクトリ
+- `.claude/skills/einja-skill-advisor/` → `.claude/skills/einja-skill-first/`
+
+#### SKILL.md 内（7箇所）
+- L2: `name: einja-skill-advisor` → `einja-skill-first`
+- L3-4: description内 `skill-advisor` → `skill-first`
+- L13: 見出し → `einja-skill-first`
+- L21: テーブル → `skill-first`
+- L45: キーワード → `skill-first`
+- L198: 文中「skill-advisor の結果」→ `skill-first の結果`
+- L237: project-private id → `einja-skill-first-project`
+
+#### CLAUDE.md（3行、4置換）
+- L43: Skillテーブル `einja-skill-advisor` → `einja-skill-first`
+- L56: 必須フロー `einja-skill-advisor` → `einja-skill-first`
+- L227: キーワード列の `skill-advisor` 削除 + パス列の `einja-skill-advisor` → `einja-skill-first`
+
+#### spec-create.md（1箇所）
+- L113: `einja-skill-advisor` → `einja-skill-first`
+
+#### 過去Plan（変更しない、履歴として保持）
+- `docs/plans/stateful-wishing-lerdorf.md` - skill-advisor作成時のPlan（12箇所）
+- `docs/plans/glimmering-giggling-sedgewick.md` - hook作成Plan（7箇所、hookパスに旧名を含む。将来このPlanを実行する場合はパス更新が必要）
+
+### B. ロジック強化: 過去Plan検索（SKILL.md内）
+
+#### Step 1 強化（L71-75: 作業パターン分析）
+
+現在の「`docs/einja/memory/patterns.md` を参照」に加え、`docs/plans/` からの反復パターン推定を追加：
+
+```
+1. 作業カテゴリ特定（変更なし）
+2. 反復性評価:
+   a. docs/einja/memory/patterns.md を Read で参照
+   b. patterns.md に記録がない場合、docs/plans/ からも反復パターンを推定する
+      - Glob で docs/plans/*.md を取得（todo-*.md, *-agent-*.md は除外）
+      - Grep で作業カテゴリのキーワード + # Plan: タイトル行を検索
+      - 類似カテゴリの作業が2件以上あれば反復性の根拠とする
+3. 複雑度評価（変更なし）
+```
+
+#### Step 5 新規追加（推奨/拡張推奨の場合のみ実行）
+
+Step 4（構造化出力）の後に追加。判定が「不要」の場合はスキップ。
+
+```
+### ステップ5: 過去Plan検索によるユースケース収集（推奨/拡張推奨の場合のみ）
+
+以下の手順で過去Planから類似作業を検索し、Skill仕様のユースケースに反映する。
+
+1. Glob で docs/plans/*.md を取得する
+   - 除外: todo-*.md, *-agent-*.md（子エージェント出力）
+2. Grep で以下のキーワードを検索し、関連Planを特定する
+   - ステップ1で特定した作業カテゴリのキーワード
+   - 変更対象ファイルパターン（例: .claude/skills/, CLAUDE.md 等）
+   - # Plan: タイトル行で関連性を粗くフィルタ
+3. 関連性の高いPlan（最大5件）のみ Read で詳細を確認する
+   - ## Context セクションから作業概要を抽出
+   - 変更対象ファイル・手順から共通パターンを特定
+4. 類似度を判定する
+   - 高: 変更対象ファイルが重複する
+   - 中: 同一ドメインの作業、または手法・パターンが類似
+5. 結果を Skill概要仕様のユースケースセクションに反映する
+```
+
+#### Skill概要仕様テンプレート拡張（L152-161）
+
+```markdown
+### Skill概要仕様
+- **名前**: einja-{proposed-name}
+- **目的**: {Skillの目的}
+- **主要フロー**: {主要な処理ステップの概要}
+- **推定作成時間**: {見積もり}
+- **ユースケース（過去Planから）**:
+  - {Plan名}: {作業概要}（類似度: 高/中）
+  - {Plan名}: {作業概要}（類似度: 高/中）
+
+### 推奨ワークフロー
+計画のTODO-0にSkill作成を追加し、`einja-skill-creator` Skillで作成後に本作業を開始する。
+```
+
+### C. skill-creator委譲の明示化
+
+現状SKILL.md内で既に大半の箇所に `einja-skill-creator` が明記済み（L17, L160, L205, L232）。
+追加で統一する箇所：
+- L160の推奨ワークフロー: 「einja-skill-creatorで作成後に」→「`einja-skill-creator` Skillで作成後に」（バッククォート追加で統一）
+
+## 影響なし
+- 他のSkill定義 → 参照なし
+- エージェント定義 → 参照なし
+- `presets/` → ビルド時に自動反映（直接編集不要）
+
+## 実装手順
+
+1. `mv .claude/skills/einja-skill-advisor .claude/skills/einja-skill-first`
+2. SKILL.md: リネーム（7箇所）+ Step 1強化 + Step 5追加 + テンプレート拡張 + skill-creator表記統一
+3. CLAUDE.md: 3行（4置換）更新
+4. spec-create.md: 1箇所更新
+5. `grep -r "skill-advisor" --include="*.md" | grep -v "docs/plans/"` → 0件確認
+
+## 検証
+
+- [ ] `grep -r "einja-skill-advisor" --include="*.md" | grep -v "docs/plans/"` → 0件
+- [ ] `grep -r "skill-advisor" --include="*.md" | grep -v "docs/plans/"` → 0件
+- [ ] SKILL.md内にStep 5（過去Plan検索）が存在し、除外条件・上限・類似度基準が明記されていること
+- [ ] Skill概要仕様テンプレートに「ユースケース（過去Planから）」セクションがあること
+- [ ] 推奨ワークフローに `einja-skill-creator` Skill名がバッククォート付きで統一されていること

package/templates/default/docs/plans/bright-stargazing-dawn.md

@@ -0,0 +1,87 @@
+# Plan: einja-team-exec SKILL.md 書き直し + skill-creator 参考URL規約追加
+
+## Context
+
+einja-team-exec SKILL.mdがサブエージェントの仕組みをベースに書かれていたが、Agent TeamsのTeammatesはサブエージェントとは完全に別アーキテクチャであることが判明。公式ドキュメント（https://code.claude.com/docs/en/agent-teams）に基づいて正しい仕様で書き直す。
+
+また、Skill作成時に参考にした公式ドキュメントやベースとなるSkillのURLをコメントとして記録する規約を、einja-skill-creatorにも追加する。
+
+### Teammates vs サブエージェントの根本的な違い
+
+| 項目 | Teammates | サブエージェント |
+|------|-----------|--------------|
+| 実体 | 独立したClaude Codeプロセス | メインセッション内の一時的な子プロセス |
+| 通信 | メンバー同士で直接メッセージ可能 | メインにのみ報告 |
+| spawn方法 | 自然言語プロンプトで役割指定 | `subagent_type`で指定 |
+| 特殊化 | general-purposeベース、プロンプトで専門化 | `.claude/agents/`のカスタム定義可能 |
+| コンテキスト | 各自独立したフルコンテキストウィンドウ | メインの指示を引き継ぎ |
+
+## 対象ファイル
+
+| ファイル | 操作 |
+|---------|------|
+| `.claude/skills/einja-team-exec/SKILL.md` | 全面書き直し |
+| `.claude/skills/einja-skill-creator/SKILL.md` | 参考URL規約の追加 |
+
+## 変更内容
+
+### 1. einja-team-exec/SKILL.md 書き直し
+
+**削除するもの:**
+- `subagent_type`に基づくチームメンバー選出ガイド（テーブル3つ + 編成例）
+- `TeamCreate`/`TaskCreate`/`TaskUpdate`等のサブエージェント用ツール呼び出し手順
+- サブエージェントの文脈で書かれたワークフロー全体
+
+**新しく書くもの:**
+- 概要: Teammatesは独立したClaude Codeインスタンスであること
+- spawn方法: 自然言語プロンプトで役割・指示を記述（`subagent_type`ではない）
+- spawn時のプロンプト設計ガイド: 役割・担当範囲・制約を明確に記述する方法
+- プロンプト例（公式ドキュメントのパターンに準拠）:
+  ```
+  Create an agent team for [タスク].
+  Spawn teammates:
+  - [役割1]: [担当範囲と指示]
+  - [役割2]: [担当範囲と指示]
+  ```
+- チームサイズの目安（公式: 3-5 teammates、5-6 tasks/teammate）
+- 通信: 直接メッセージ + 共有タスクリスト
+- ファイル競合回避（公式: 各teammateが異なるファイルを担当）
+- コミット管理（CLAUDE.mdのgit安全ルールはCLAUDE.md経由で自動適用）
+- 完了・シャットダウン手順
+- 参考ドキュメントURLをコメントで記載
+
+**参考URLコメント（SKILL.md冒頭、フロントマター直後）:**
+```markdown
+<!-- 参考: https://code.claude.com/docs/en/agent-teams -->
+```
+
+### 2. einja-skill-creator/SKILL.md 参考URL規約追加
+
+「SKILL.mdの作成」セクション内に以下の規約を追加:
+
+**追加箇所**: `#### 記述パターン` セクションの近辺、または「Skill記述ガイド」セクション内
+
+**追加内容**:
+```
+#### 参考ドキュメントの記録
+
+Skill作成時に参考にした公式ドキュメント、ベースとなるSkill、
+設計判断の根拠となった情報源をSKILL.md内にHTMLコメントで記載する。
+
+**記載箇所**: フロントマター（`---`）直後
+
+**フォーマット**:
+<!-- 参考: https://example.com/docs/feature -->
+<!-- ベース: .claude/skills/existing-skill/SKILL.md -->
+
+これにより、Skillの設計根拠を後から追跡でき、
+公式仕様の変更時に影響範囲を特定しやすくなる。
+```
+
+## 検証
+
+- [ ] SKILL.mdのフロントマターが正しいYAML形式であること
+- [ ] サブエージェント関連の記述（`subagent_type`、`TaskCreate`等）が残っていないこと
+- [ ] 公式ドキュメントの仕様と矛盾がないこと
+- [ ] 参考URLコメントがSKILL.mdに記載されていること
+- [ ] einja-skill-creatorに参考URL規約が追加されていること