mcpField
C
compound-docs

compound-docs

github.com/oliver-kriska開発57140 回インストール1 週間前に更新
リポジトリ

compound-docs について

デバッグで得た解決策を記録し、再利用するための検索可能なドキュメントスキルです。カテゴリ別に整理し、問題ごとのファイル、必須の YAML メタデータ、再発防止策を定め、記載された Phoenix ワークフローと連携します。

主な機能

  1. 01解決策ドキュメントのカテゴリ整理
  2. 02症状、タグ、コンポーネントで検索
  3. 03必須の YAML フロントマター形式
  4. 04問題ごとに1ファイルで記録
  5. 05修正ごとの再発防止策

活用シーン

  1. 01デバッグ前に既知の解決策を確認
  2. 02解決した問題を再利用できる形で記録
  3. 03計画時に既知のリスクを参照

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/oliver-kriska/claude-elixir-phoenix --skill compound-docs

インストール後、Claude Code で/compound-docsを入力して読み込まれたか確認します。

同梱ファイルreferences/resolution-template.mdreferences/schema.md

詳細

Compound Docs — 組織のナレッジベース

検索可能なカテゴリ別の解決策ドキュメントにより、デバッグセッションを重ねるごとに効率を高めます。

ディレクトリ構造

.claude/solutions/
├── ecto-issues/
├── liveview-issues/
├── oban-issues/
├── otp-issues/
├── security-issues/
├── testing-issues/
├── phoenix-issues/
├── deployment-issues/
├── performance-issues/
└── build-issues/

厳守事項

  1. 調査の前に必ず解決策を検索する — デバッグを始める前に、.claude/solutions/ に既存の修正方法がないか確認します
  2. YAML フロントマターは必須です — すべての解決策に、${CLAUDE_SKILL_DIR}/references/schema.md に準拠した検証済みのメタデータが必要です
  3. 1 ファイルにつき問題は 1 つ — 複数の解決策をまとめてはいけません
  4. 再発防止策を含める — すべての解決策に、再発を防ぐ方法を記載します

解決策ファイルの形式

---
module: "Accounts"
date: "2025-12-01"
problem_type: runtime_error
component: ecto_schema
symptoms:
  - "Ecto.Association.NotLoaded on user.posts"
root_cause: missing_preload
severity: medium
tags: [preload, association, n-plus-one]
---

# Association NotLoaded on User Posts

## Symptoms
Ecto.Association.NotLoaded raised when accessing user.posts
in UserListLive after filtering.

## Root Cause
Query in Accounts context missing preload for :posts.

## Solution
Added `Repo.preload(:posts)` to `list_users/1`.

## Prevention
Use n1-check skill before shipping list views.

解決策の検索

Grep を使用して、.claude/solutions/ を症状（例：NotLoaded）、タグ（例：tags:.*preload）、またはコンポーネント（例：component: ecto）で検索します。

統合

  • /phx:compound はここに解決策ドキュメントを作成します
  • /phx:investigate はデバッグの前にここを検索します
  • /phx:plan は既知のリスクを確認するために参照します
  • learn-from-fix はこのシステムに情報を取り込みます

参考資料

  • ${CLAUDE_SKILL_DIR}/references/schema.md — YAML フロントマターの検証スキーマ
  • ${CLAUDE_SKILL_DIR}/references/resolution-template.md — 解決策テンプレートの全文

コメント

Markdown 対応