Git Skill Manager

Git Skill Manager

Gitリポジトリ経由でエージェントスキルの取得（pull）と共有（push）を行う管理システム。

skill-creator との使い分け

外部URLからスキルを安全に取り込みたい場合は skill-creator（モードD）を使ってください。 skill-creator がライセンス・セキュリティ・ネットワーク通信を事前に検証し、 確認後にこのスキル（git-skill-manager）を自動で呼び出してインストールします。

このスキル（git-skill-manager）は以下の用途に特化しています:

利用者

• ユーザー直接呼び出しの場合、対話的に確認しながら進める
• サブエージェント経由の場合、プロンプトに必要な情報（対象スキル・リポジトリ名・操作）が含まれるため、確認なしで実行する

動作環境

• GitHub Copilot Chat（Windows / macOS / Linux）および Claude Code で動作する
• git はインストール・認証設定済み（SSH鍵 or credential manager）
• シェルは実行環境に依存する（PowerShell、bash、zsh など）

アーキテクチャ・パス定義

詳細 → references/architecture.md

レジストリ

パス: {agent_home}/skill-registry.json（agent_home は install.py 実行時のエージェント種別で決まる。実際のパスは skill-registry.json の skill_home フィールドで確認できる）

スキルの登録情報（リポジトリ・インストール済みスキル・プロファイル・フィードバック履歴）を管理するJSONファイル。初回操作時に自動作成する。

詳細なスキーマとフィールド説明 → references/registry-schema.md

スクリプトパス

{SCRIPTS_DIR} = <skill_home>/git-skill-manager/scripts（skill_home は skill-registry.json の skill_home フィールド）

操作一覧

repo add

# 接続確認
git ls-remote $REPO_URL HEAD

# 成功したらレジストリに追加
cd {SKILL_HOME}/../..   # skill-registry.json があるディレクトリ
python {SCRIPTS_DIR}/repo.py add <name> <url>
python {SCRIPTS_DIR}/repo.py add <name> <url> --readonly
python {SCRIPTS_DIR}/repo.py add <name> <url> --priority 1 --skill-root .github/skills
python {SCRIPTS_DIR}/repo.py list
python {SCRIPTS_DIR}/repo.py remove <name>

→ 実装: scripts/repo.py — add_repo(), list_repos(), remove_repo()

pull

python {SCRIPTS_DIR}/pull.py                          # 全リポジトリから全スキルをpull
python {SCRIPTS_DIR}/pull.py --skill <name>           # 特定スキルのみpull
python {SCRIPTS_DIR}/pull.py --repo <repo-name>       # 特定リポジトリからpull
python {SCRIPTS_DIR}/pull.py --no-interactive         # 非対話モード（サブエージェント経由）

→ 実装: scripts/pull.py — pull_skills()

競合解決・ロジック詳細 → references/examples.md

push

python {SCRIPTS_DIR}/manage.py push                                     # 全スキルを全書き込み可能リポジトリへpush
python {SCRIPTS_DIR}/manage.py push --skills skill-a,skill-b            # 特定スキルをpush
python {SCRIPTS_DIR}/manage.py push --repos team-skills                 # 特定リポジトリへpush
python {SCRIPTS_DIR}/manage.py push --skills my-skill --msg "feat: ..." # コミットメッセージ指定

→ 実装: scripts/push.py — push_skill(), push_all_skills() → scripts/manage.py — push_to_main()

デフォルトは main ブランチへの直接 push。ユーザーが「ブランチを切って」「PR を作って」と要求した場合のみ add-skill/<name> ブランチを作成して push し、PR/MR 作成を促す。

list

python {SCRIPTS_DIR}/manage.py list

→ 実装: scripts/manage.py — list_skills()

インストール済みスキルの一覧を表示。有効/無効、ソースリポジトリ、コミットハッシュ、pin状態、バージョンを表示する。

• v1.2.3 — ローカルのバージョン
• v1.2.3 ⬆️ — ローカルが中央より新しい（version_ahead）
• v1.2.3 (central: v1.2.4) — 中央に新しいバージョンがある（pull 推奨）

search

python {SCRIPTS_DIR}/manage.py search                             # 全スキルを一覧（インデックスキャッシュ使用）
python {SCRIPTS_DIR}/manage.py search --keyword converter         # キーワード検索
python {SCRIPTS_DIR}/manage.py search --repo team-skills          # リポジトリ絞り込み
python {SCRIPTS_DIR}/manage.py search --refresh                   # リモートから最新インデックスを取得して検索

デフォルトではレジストリ内の remote_index を検索する（ネットワーク不要、即座に結果を返す）。 --refresh 指定時はリモートから最新情報を取得してインデックスを更新してから検索する。 インデックスが空の場合（初回）は自動的に --refresh と同様の動作をする。

→ 実装: scripts/manage.py — search_skills()

enable / disable

python {SCRIPTS_DIR}/manage.py enable <skill-name>
python {SCRIPTS_DIR}/manage.py disable <skill-name>

スキルの有効・無効を切り替える。無効化されたスキルはディスク上に残るが、discover_skills.py のメタデータ収集から除外される（コンテキストウィンドウを節約）。

→ 実装: scripts/manage.py — enable_skill(), disable_skill()

pin / unpin

python {SCRIPTS_DIR}/manage.py pin <skill-name>                   # 現在のコミットに固定
python {SCRIPTS_DIR}/manage.py pin <skill-name> --commit abc1234  # 指定コミットに固定
python {SCRIPTS_DIR}/manage.py unpin <skill-name>

スキルを特定のコミットハッシュに固定する。pin されたスキルは pull 時にそのコミットの内容を取得し、新しいバージョンには更新されない。

→ 実装: scripts/manage.py — pin_skill(), unpin_skill()

lock / unlock

python {SCRIPTS_DIR}/manage.py lock
python {SCRIPTS_DIR}/manage.py unlock

全インストール済みスキルのバージョンを一括で固定・解除する。チームで同じバージョンのスキルセットを共有するときに使う。

→ 実装: scripts/manage.py — lock_all(), unlock_all()

promote

python {SCRIPTS_DIR}/manage.py promote .github/skills
python {SCRIPTS_DIR}/manage.py promote <workspace-skill-dir>

ワークスペースのスキルディレクトリ（<workspace-skill-dir>）のスキルをユーザー領域（<AGENT_HOME>/skills/）にコピーし、リポジトリにも push する。プロジェクト固有でないスキルを他のプロジェクトでも再利用可能にする。

→ 実装: scripts/manage.py — promote_skills()

ワークスペーストライアルフロー

VSCode チャット経由で作成されたスキルはワークスペースのスキルディレクトリ（<workspace-skill-dir>）に置かれ、試用してから昇格する。

ライフサイクル・評価フロー詳細 → references/workspace-trial.md

feedback

python {SCRIPTS_DIR}/record_feedback.py <skill-name> ok
python {SCRIPTS_DIR}/record_feedback.py <skill-name> needs-improvement --note "改善点のメモ"
python {SCRIPTS_DIR}/record_feedback.py <skill-name> broken --note "エラー内容"

直前に実行したスキルの満足度をユーザーに確認し、レジストリに記録する。 スキル単体起動後に copilot-instructions.md の指示で自動的に呼ばれる。

→ 実装: scripts/record_feedback.py

フィードバック記録の詳細フロー・しきい値 → references/feedback-loop.md

evaluate

skill-evaluator スキルを呼び出してワークスペース・インストール済みスキルを評価する。評価フロー詳細 → references/feedback-loop.md

refine

python {SCRIPTS_DIR}/manage.py refine <skill-name>
# 改良完了後:
python {SCRIPTS_DIR}/manage.py mark-refined <skill-name>

蓄積されたフィードバックをもとに、スキルの改良フローを開始する。ワークスペーススキルとインストール済みスキル（user-space / リポジトリ管理）の両方に対応する。

→ 実装: scripts/manage.py — refine_skill(), mark_refined()

スクリプト出力の REFINE_COMPLETE_CMD: 行に示されたコマンドを必ず実行する（pending_refinement フラグの解除）。

diff / sync / merge

python {SCRIPTS_DIR}/manage.py diff <skill-name>
python {SCRIPTS_DIR}/manage.py diff <skill-name> --repos team-skills,personal

python {SCRIPTS_DIR}/manage.py sync <skill-name>
python {SCRIPTS_DIR}/manage.py sync <skill-name> --repos team-skills,personal

python {SCRIPTS_DIR}/manage.py merge <skill-name>

複数リポジトリに分岐した同名スキルを比較・統合・配信するクロスリポジトリ操作。

詳細な処理フローと出力例 → references/cross-repo-ops.md

changelog / bump

python {SCRIPTS_DIR}/manage.py changelog <skill-name>
python {SCRIPTS_DIR}/manage.py changelog <skill-name> --dry-run

python {SCRIPTS_DIR}/manage.py bump <skill-name>               # patch (デフォルト)
python {SCRIPTS_DIR}/manage.py bump <skill-name> --type minor
python {SCRIPTS_DIR}/manage.py bump <skill-name> --type major

スキルのバージョン管理操作。

• changelog: コミット履歴とフロントマターのバージョン変更から CHANGELOG.md を自動生成する
• bump: SKILL.md の metadata.version をセマンティックバージョニングに従ってインクリメントする（X.Y.Z 形式）

コマンド例・バージョン指針・処理フロー・タイミング → references/version-management.md

discover

skill-creator（モードC）を起動し、直近のチャット履歴から新しいスキル候補を発見する。スクリプト呼び出しなし — エージェントが skill-creator を直接起動する。

処理フロー詳細 → references/version-management.md

metrics

python {SCRIPTS_DIR}/metrics_report.py
python {SCRIPTS_DIR}/metrics_report.py --skill <skill-name>   # 特定スキルの詳細
python {SCRIPTS_DIR}/metrics_report.py --co                   # 共起分析
python {SCRIPTS_DIR}/metrics_collector.py                     # ログを再集計

→ 実装: scripts/metrics_report.py, scripts/metrics_collector.py | 詳細 → references/metrics.md

profile

python {SCRIPTS_DIR}/manage.py profile list
python {SCRIPTS_DIR}/manage.py profile create <name> <skill1,skill2,...>
python {SCRIPTS_DIR}/manage.py profile use <name>
python {SCRIPTS_DIR}/manage.py profile delete <name>

プロファイルはスキルの有効・無効を一括で切り替えるショートカット。プロファイルをアクティブにすると、そのプロファイルに含まれるスキルのみがコンテキストにロードされる。

→ 実装: scripts/manage.py — profile_create(), profile_use(), profile_list(), profile_delete()

auto-update

python {SCRIPTS_DIR}/auto_update.py check         # 更新チェック
python {SCRIPTS_DIR}/auto_update.py run           # 自動更新を実行
python {SCRIPTS_DIR}/auto_update.py configure     # 設定を表示・変更

セッション開始時やユーザーの指示で、リポジトリの更新を自動チェックする機能。デフォルトは無効。 セッション開始時のトリガーは .github/copilot-instructions.md で定義されている。

→ 実装: scripts/auto_update.py

動作モード・設定操作・チェック操作の詳細 → references/auto-update.md

snapshot / rollback

python {SCRIPTS_DIR}/snapshot.py save
python {SCRIPTS_DIR}/snapshot.py save --label "リリース前"
python {SCRIPTS_DIR}/snapshot.py list
python {SCRIPTS_DIR}/snapshot.py restore --latest
python {SCRIPTS_DIR}/snapshot.py restore <snap-id>
python {SCRIPTS_DIR}/snapshot.py clean --keep 5

pull 実行時に自動でスナップショットを保存し、問題が発生した場合に元の状態へ復元する。「元に戻して」「pullを取り消して」でロールバックを発動する。

詳細 → references/snapshot-rollback.md

deps

python {SCRIPTS_DIR}/manage.py deps                # 全スキルの依存関係を検証
python {SCRIPTS_DIR}/manage.py deps <skill-name>   # 特定スキルの依存関係を検証
python {SCRIPTS_DIR}/manage.py deps-graph          # 全スキルの依存グラフ（Mermaid）
python {SCRIPTS_DIR}/manage.py deps-graph <skill-name>

スキルの depends_on（必須依存）・recommends（推奨依存）を SKILL.md フロントマターから解析し、充足状況の検証と Mermaid 依存グラフの出力を行う。

→ 実装: scripts/deps.py — check_deps(), show_graph()

フロントマタースキーマ・エージェントの動作・出力例 → references/deps.md

deprecate

スキルを非推奨化し、代替スキルへの移行を促す。

ライフサイクル: Active → Deprecated（2スプリント）→ Archived → Removed

SKILL.md フロントマターに tier: deprecated / deprecated_by: <代替> / deprecated_since: <ver> を追記し、skill-registry.json の deprecated_skills に登録する。

詳細 → references/deprecation.md

archive

Deprecated 期間（2スプリント）終了後にスキルを .github/skills/_archived/ へ移動し、レジストリの archived_skills へ移す。

詳細 → references/deprecation.md

エラーハンドリング

→ references/errors.md

使用例

操作ごとのエージェント対話例 → references/examples.md