AgentSkillsCN

merge-reference-docs

基于通用参考 Markdown 文件，扩展并更新项目专属文件的技能。

SKILL.md
--- frontmatter
name: merge-reference-docs
description: 汎用的な参考Markdownファイルを基に、プロジェクト固有のファイルを拡張・更新するスキル
invocable: true

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

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

使用タイミング

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

呼び出し方法

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

例

bash
# 単一リファレンス
/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. ファイルの読み込みと分析

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

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

2. マージ方針

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

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

3. 優先順位

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

4. 検証

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

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

Agent（エージェント）

セクションマージルール
フロントマターtarget を維持
ワークフローreference から追加可
専門領域reference から追加可
参照ドキュメントtarget を維持
チェックリスト両方をマージ（target優先）
連携エージェントtarget を維持

Skill（スキル）

セクションマージルール
フロントマターtarget を維持
使用例両方をマージ（target優先）
重要なルールreference から追加可
コード例target を維持

Rule（ルール）

セクションマージルール
適用条件target を維持
パターン例両方をマージ（target優先）
チェック項目reference から追加可
例外ケースtarget を維持

使用例

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

code
入力:
- 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ファイル程度を推奨

@記法の順序

順序役割説明
1番目target更新対象（基準ファイル）
2番目〜references参考にするファイル（複数可）
code
/merge-reference-docs @{target} @{ref1} @{ref2} type={agent|skill|rule}

関連スキル

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