name	verify-docs
description	ドキュメント（docs/）の内容がコードの実装と一致しているかを検証します。「ドキュメントを検証」「ドキュメントとコードの整合性をチェック」「docsを確認」と言われたときに使用します。
allowed-tools	Read, Glob, Grep, Edit, TodoWrite, Task

ドキュメント・コード整合性検証スキル

ドキュメント（docs/）の内容がコードの実装と一致しているかを検証するスキルです。

概要

このスキルは以下を自動的に実行します：

既存のチェックリストファイル（doc-review-checklist.md）を確認
なければ新規作成、あれば未完了ファイルから再開
各ファイルを doc-verifier サブエージェントで1つずつ検証
1ファイル完了ごとにチェックリストを即座に更新

再開可能: 途中で中断しても、次回実行時は未チェックのファイルから自動的に再開します。

確認観点

各ドキュメントについて以下を確認します：

コマンド・スクリプトが package.json と一致しているか
ファイルパス・コンポーネント名が実在するか
API・IPCチャンネル名が正しいか
機能説明が実装と一致しているか
廃止された機能・コードが残っていないか

実行手順

1. 既存チェックリストの確認

まず doc-review-checklist.md が存在するか確認します。

存在する場合（再開モード）:

チェックリストを読み込む
- [ ]（未チェック）のファイルを抽出
未チェックファイルから検証を再開

存在しない場合（新規モード）:

次のステップでドキュメント一覧を取得
新規チェックリストを作成

2. 対象ドキュメントの取得

Glob: docs/**/*.md

以下のファイルは除外します：

TEMPLATE.md
WRITING-GUIDE.md
その他のテンプレートファイル

3. チェックリストファイルの作成（新規の場合のみ）

検証実行前に、プロジェクトルートに doc-review-checklist.md を作成します。

# ドキュメント検証チェックリスト

実行日時: {現在日時}

## 確認観点
- コマンド・スクリプトが package.json と一致しているか
- ファイルパス・コンポーネント名が実在するか
- API・IPCチャンネル名が正しいか
- 機能説明が実装と一致しているか
- 廃止された機能・コードが残っていないか

---

## 1. セットアップ・開発 (setup/)

- [ ] docs/setup/getting-started.md
- [ ] docs/setup/development.md
- [ ] docs/setup/build-deploy.md

**不整合メモ:**

(確認後に記載)


---

## 2. 機能ドキュメント (features/)

- [ ] docs/features/icons.md
...（取得したファイルをすべてリスト）

**不整合メモ:**

(確認後に記載)


---

（以下、カテゴリごとに同様の形式）

---

## サマリー

| カテゴリ | ファイル数 | 確認完了 | 不整合あり |
|---------|-----------|---------|-----------|
| setup/ | X | 0 | 0 |
| features/ | X | 0 | 0 |
| ... | ... | ... | ... |

### 要修正リスト

| ファイル | 問題内容 | 優先度 |
|---------|---------|--------|
| (確認後に記載) | | |

4. カテゴリ分類

取得したファイルを以下のカテゴリに分類：

カテゴリ	パス	検証内容
setup/	docs/setup/*.md	package.jsonスクリプト、環境変数
features/	docs/features/*.md	サービス・ハンドラー、IPCチャンネル
architecture/	docs/architecture/*.md	ディレクトリ構造、データ形式
screens/	docs/screens/*.md	コンポーネント存在確認
testing/	docs/testing/*.md	テストコマンド、テストファイル
その他	docs/*.md	リンク切れ確認

5. 1ファイルずつ順次検証

重要: 各ドキュメントファイルを doc-verifier サブエージェントで1つずつ検証します。

各ファイルについて以下を繰り返します：

5-1. サブエージェントで検証

Task tool:
  subagent_type: doc-verifier
  prompt: |
    以下のドキュメントファイルを検証してください：
    ファイル: {file_path}

    検証観点に従い、コードとの整合性を確認し、
    不整合があれば報告してください。

5-2. チェックリストを即座に更新

検証完了後、すぐに doc-review-checklist.md を更新します：

検証完了したファイルのチェックボックスを [x] に更新
不整合があった場合は ⚠️ マークを追加
「不整合メモ」セクションに発見した問題を記載

例:

## 2. 機能ドキュメント (features/)

- [x] docs/features/icons.md ⚠️
- [x] docs/features/group-launch.md
- [ ] docs/features/folder-import.md  ← 次はこのファイル

**不整合メモ:**

icons.md: パス誤り（%APPDATA%/quickdashlauncher/ → %APPDATA%/quick-dash-launcher/）

5-3. 次のファイルへ

未チェックのファイルがあれば 5-1 に戻る。

6. 最終レポート

すべての検証完了後、チェックリストのサマリーセクションを最終更新：

各カテゴリの確認完了数・不整合数を集計
要修正リストに全ての問題を優先度順に記載

優先度の基準

高: 誤ったコマンド、存在しないファイルパス、間違ったAPI名、コンフリクトマーカー
中: 古い情報、不完全な説明、軽微な不一致
低: 表現の改善、細かな修正提案

実行タイミング

リリース前の最終確認
大きな機能追加・変更後
定期メンテナンス（月1回程度）

注意事項

検証のみを行い、自動修正は行いません
修正が必要な場合は、ユーザーに確認してから実施してください
修正完了後、チェックリストファイル（doc-review-checklist.md）は削除してください

verify-docs

Install Skill

SKILL.md