メニュー
ドキュメント・技術文書を、知識プロファイル (~/.claude/knowledge-profile.md) を参照・更新しながら「ユーザが作業を進められるレベル」まで対話的に読解支援する。「このドキュメントを解説して」「この設計書を理解したい」「読むのを手伝って」「前提知識が足りない」など、単発の Q&A で済まない規模のドキュメント理解で起動。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
| name | utility-doc-reading |
| description | ドキュメント・技術文書を、知識プロファイル (~/.claude/knowledge-profile.md) を参照・更新しながら「ユーザが作業を進められるレベル」まで対話的に読解支援する。「このドキュメントを解説して」「この設計書を理解したい」「読むのを手伝って」「前提知識が足りない」など、単発の Q&A で済まない規模のドキュメント理解で起動。 |
| argument-hint | <ドキュメントのパスまたは URL> |
| user-invocable | true |
大量・高密度なドキュメントを、ユーザの知識レベルと目的に合わせた深度で理解できるように導く。ゴールは「ドキュメントの完全理解」ではなく「ユーザが次の作業を進められる状態」。この違いが本スキルの深度調整のすべてを決める。
~/.claude/knowledge-profile.md がユーザの知識の永続記録。毎回の知識確認を減らし、回を重ねるごとに解説がユーザに最適化されていくための仕組み。
claude/knowledge-profile.md (mkOutOfStoreSymlink で ~/.claude/ に配置され、複数マシン間で git 同期される)drs / hms 未適用のためプロファイルを更新できない」と報告する (勝手に実ファイルを作ると home-manager の symlink 配置と衝突する)# Knowledge Profile
## 既知 (ユーザが知っていると申告した概念)
<!-- - 概念名 — 一言メモ (YYYY-MM-DD) -->
## 解説済み (本スキルで解説した概念)
<!-- - 概念名 — 解説した要点の一行要約 (YYYY-MM-DD) -->
引数のパス / URL を読む。引数がなければ対象を尋ねる。複数ファイルの場合はすべて読み、相互参照関係を把握する。
AskUserQuestion で「このドキュメントを読んで何ができればよいか」を確認する:
このゴールが解説深度の上限になる。以降のすべての解説で「この深さはゴールに必要か?」を自問し、超える詳細はユーザが追加で聞いたときだけ提供する。技術の内部実装を知らなくても、役割と挙動が分かれば作業を進められることが多い — その線で止める。
ドキュメントを理解する上で土台になる概念だけを抽出する (登場する専門用語の網羅ではない。それを知らないと本文の議論が追えないもの、の基準で選ぶ)。ゴールが浅いほど抽出も絞る。
各概念を知識プロファイルと突き合わせて 3 分類する:
| 分類 | 判定 | 扱い |
|---|---|---|
| 既知 | プロファイルの「既知」に記載あり | 確認せず解説もスキップ |
| 解説済み | プロファイルの「解説済み」に記載あり | 「以前解説しましたが復習しますか?」と軽く確認 (陳腐化対策) |
| 未知候補 | プロファイルに記載なし | ステップ 4 で確認 |
未知候補を AskUserQuestion (multiSelect) で提示し、ユーザに「知っているもの」を選んでもらう。概念が 5 個を超える場合は、本文理解への影響が大きい順に絞るかグループ化して、確認の往復が 1〜2 回で済むようにする。
ユーザが「知っている」と答えたものはプロファイルの「既知」へ、それ以外が解説対象になる。
(a) 未知概念の解説 — 役割・挙動レベルで解説する:
例: 「mkOutOfStoreSymlink」なら — ✅「Nix 管理のファイルをコピーではなく元リポジトリへの symlink として配置する仕組み。これがあるので設定を編集すると再ビルドなしで即反映される。この設計書では live edit を実現する手段として登場する」 ❌ Nix store の内部構造、derivation の仕組み、他の symlink 手法との比較表
(b) 本文ウォークスルー — セクション単位で進める:
セッション末尾に、今回解説した概念を「解説済み」セクションへ、ユーザが既知と申告した概念を「既知」セクションへ追記する (日付は date +%F で取得)。既存エントリと重複させない。更新したことを一行で報告する。
ウォークスルー中にユーザが特定の概念を深く聞いてきたら、それは深度上限の一時解除。その質問に限り詳細に答え、答え終わったら元の深度に戻る。深掘りした内容もプロファイルの「解説済み」に反映する。
実装ループ。承認済みの DESIGN.md + DESIGN_DETAIL_APP.md + DESIGN_DETAIL_INFRA.md + TODO.md を入力に、TODO.md の全フェーズをレビュー・コミット込みで自律実装するオーケストレーター。人間の介入はエスカレ条件 (概要設計の破綻 P3 等) のみ。dev-spec の承認ゲート通過後にユーザーが直接起動する。エスカレーション回答後の再開も本スキルの再実行で行う。「実装ループを開始」「設計済み TODO で実装を自律実行」「残りタスクを自動で実装」などで起動。
設計ループ。ユーザーストーリー → UI スケッチ → ユースケース → 実現可能性検証 → PoC 検証 → DDD モデリング → 概要/詳細設計 (DESIGN.md / DESIGN_DETAIL_APP.md / DESIGN_DETAIL_INFRA.md) → 深掘りインタビュー → 検証手順補完 → TODO.md 生成までを対話的に実行し、承認ゲートで実装ループ (/dev-impl) へ引き渡す。 「設計フェーズを開始」「要件を整理したい」「計画を立てたい」「ユーザーストーリーを書きたい」 「技術的に実現できるか確認したい」「TODO.md を作りたい」「DESIGN.md を深掘りしたい」などで起動。 docs/ の状態から途中再開・特定フェーズの部分実行も可能。
ローカルの git 差分を 3 観点 (TDD / コード品質+ルール準拠+構造 / プロダクト readiness) で並列レビュー。本体ロジックは review-tdd / review-quality / review-product-readiness subagent に委譲し、本 skill はメインセッション向けの薄い orchestrator として「差分検出 → PHASE_CONTEXT 組み立て → subagent 並列起動 → 結果集約・整形表示 → 修正アクション選択」を担当する。セキュリティレビューは security-guidance プラグイン (Stop hook の LLM diff review + Edit 時の pattern 検知) に委譲しており本 skill の対象外。fatal 判定は本 skill では行わず、呼び出し側に任せる。
React 19 + Vite+ + TypeScript + Tailwind v4 のモバイル向け静的 SPA デモサイトを TDD で構築し、Cloudflare Workers へデプロイするワークフロー。localStorage でフロントのみ完結するデモに特化。「デモサイトを作りたい」「モバイル向け静的デモ」「SPA を作って Cloudflare にデプロイ」「静的プロトタイプを公開」「localStorage でフロントだけ完結」などで起動。
複数サブエージェントに異なる立場を与えて議論を反復し、相違が収束するまで議題を検証して結論を提示する。設計妥当性検証・実装方針比較・原因分析のセカンドオピニオン・アイデアの壁打ちに使用。「議論したい」「壁打ちしたい」「セカンドオピニオン」「複数視点で検証したい」などで起動。
ローカルのコミット履歴と差分からDraft PRを作成する。ブランチ未作成・コミット未作成の状態でも、必要に応じてブランチ作成とコミットを行ってからPRを作成する。`.github/` にPRテンプレートがあれば内容を埋めて、なければ作業内容から本文を生成し、`AskUserQuestion`で作成可否を確認してから `gh pr create --draft` を実行する。「PRを出したい」「draft PRを作成」「プルリクを作って」「PR本文を生成」などのリクエストで起動。