汎用的な参考Markdownファイルを基に、プロジェクト固有のファイルを拡張・更新するスキル
外部の汎用的な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
| パラメータ | 説明 | 例 |
|---|---|---|
target | 更新対象のファイル（基準） | .claude/agents/code-reviewer.md |
type | ファイルの種類 | agent / skill / rule |
references | 参考にするファイル（複数可） | generic-reviewer.md |
1. target（基準ファイル）を読み込む
- プロジェクト固有の設定・パターンを把握
- 維持すべき構造・セクションを特定
2. references（参考ファイル群）を順番に読み込む
- 各ファイルから追加すべき観点・チェック項目を特定
- 汎用的なベストプラクティスを抽出
維持するもの:
- target のフロントマター
- target のプロジェクト固有パターン
- target の参照ドキュメントリスト
- target の連携エージェント情報
追加・拡張するもの:
- references から抽出した汎用的なチェック項目
- 定量的な基準（閾値、計測指標）
- 追加のセキュリティ/パフォーマンス観点
高 ← target（プロジェクト固有）
← references[0]（1番目の参考ファイル）
← references[1]（2番目の参考ファイル）
低 ← ...以降同様
- フロントマターが正しいか確認
- Markdownの構文エラーがないか確認
- 内部リンク・参照が有効か確認
| セクション | マージルール |
|---|---|
| フロントマター | target を維持 |
| ワークフロー | reference から追加可 |
| 専門領域 | reference から追加可 |
| 参照ドキュメント | target を維持 |
| チェックリスト | 両方をマージ（target優先） |
| 連携エージェント | target を維持 |
| セクション | マージルール |
|---|---|
| フロントマター | target を維持 |
| 使用例 | 両方をマージ（target優先） |
| 重要なルール | reference から追加可 |
| コード例 | target を維持 |
| セクション | マージルール |
|---|---|
| 適用条件 | target を維持 |
| パターン例 | 両方をマージ（target優先） |
| チェック項目 | reference から追加可 |
| 例外ケース | target を維持 |
入力:
- 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番目 | target | 更新対象（基準ファイル） |
| 2番目〜 | references | 参考にするファイル（複数可） |
/merge-reference-docs @{target} @{ref1} @{ref2} type={agent|skill|rule}