参考ドキュメントマージスキル

外部の汎用的なMarkdownファイル（ベストプラクティス、パターン集など）を参考に、プロジェクト固有のエージェント・スキル・ルールファイルを拡張・更新するスキルです。

使用タイミング

• 汎用的なガイドラインをプロジェクト固有の基準に統合したい
• 外部のベストプラクティス文書をプロジェクトルールに反映したい
• 他のプロジェクトで作成したエージェント定義を現プロジェクトに適合させたい

呼び出し方法

/merge-reference-docs @{基準ファイル} @{参考ファイル1} [@{参考ファイル2}...] type={agent|skill|rule}

例

# 単一リファレンス
/merge-reference-docs @.claude/agents/code-reviewer.md @.claude/agents/generic-reviewer.md type=agent

# 複数リファレンス
/merge-reference-docs @.claude/agents/code-reviewer.md @security-checklist.md @performance-guide.md type=agent

必要な入力

実行手順

1. ファイルの読み込みと分析

1. target（基準ファイル）を読み込む
   - プロジェクト固有の設定・パターンを把握
   - 維持すべき構造・セクションを特定

2. references（参考ファイル群）を順番に読み込む
   - 各ファイルから追加すべき観点・チェック項目を特定
   - 汎用的なベストプラクティスを抽出

2. マージ方針

維持するもの:
- target のフロントマター
- target のプロジェクト固有パターン
- target の参照ドキュメントリスト
- target の連携エージェント情報

追加・拡張するもの:
- references から抽出した汎用的なチェック項目
- 定量的な基準（閾値、計測指標）
- 追加のセキュリティ/パフォーマンス観点

3. 優先順位

高 ← target（プロジェクト固有）
   ← references[0]（1番目の参考ファイル）
   ← references[1]（2番目の参考ファイル）
低 ← ...以降同様

4. 検証

- フロントマターが正しいか確認
- Markdownの構文エラーがないか確認
- 内部リンク・参照が有効か確認

ファイル種別ごとのマージルール

Agent（エージェント）

Skill（スキル）

Rule（ルール）

使用例

コードレビューエージェントの拡張

入力:
- target: .claude/agents/code-reviewer.md
- type: agent
- references:
  - security-checklist.md（セキュリティ観点）
  - performance-guide.md（パフォーマンス観点）

実行:
1. code-reviewer.md のプロジェクト固有パターンを維持
2. security-checklist.md からセキュリティチェック項目を追加
3. performance-guide.md からパフォーマンス観点を追加
4. 重複する内容は優先度の高いファイルを採用

注意事項

1. プロジェクト固有性を維持: references の内容がプロジェクトに適合しない場合はスキップ
2. 重複の回避: 同じ内容が複数ファイルにある場合は優先順位に従う
3. 一貫性の確保: マージ後の文書全体で用語・スタイルが統一されているか確認
4. リファレンス数の目安: 3〜5ファイル程度を推奨

@記法の順序

/merge-reference-docs @{target} @{ref1} @{ref2} type={agent|skill|rule}

関連スキル

• adapt-external-docs: 汎用ドキュメントをプロジェクト形式に適合