GitHub運用マニュアル
（uriage-automationプラグイン配布用）

01全体の流れ

1. GitHub上のファイルを修正（2章）
2. 修正内容をpush／PRをマージ（2章）
3. 配布（同期）する（3章）
4. メンバー全員に反映次回セッションから

02修正のやり方（3パターン）

パターンA：ちょっとした文言修正（1ファイルだけ）

1. リポジトリを開くgithub.com/nanaBOS/borderless-keiri-plugins
2. 対象ファイルを開くplugins/uriage-automation/skills/◯◯/SKILL.md
3. 右上の鉛筆アイコン（Edit this file）をクリック
4. 内容を書き換える
5. コミットする画面下部で「Commit changes directly to the main branch」を選び、コミットメッセージを入れて「Commit changes」。

パターンB：Claudeにやってもらう（現在の主な手段）

複数ファイル・スクリプト変更・仕訳ロジック追加など、まとまった修正はClaudeに依頼する。2026-08-05以降、Claudeからこのリポジトリを直接更新できる状態になっています（READMEにも「本リポジトリはClaudeからPRで更新できます」と注記済み。PR#1がその実績）。

1. Claudeに修正内容を伝える「uriage-automationの◯◯スキルを△△に直して、リポジトリに反映して」。
2. Claudeが作業する該当スキルを編集 → plugin.json の version を上げる（例：0.3.2→0.3.3）→ READMEに変更点を追記 → コミット。直接pushかPR作成かは、依頼時に指定する（記録を残したいならPR推奨）。
3. PRの場合はマージするブラウザでMerge。

パターンC：PATを発行して作業する（代替手段）

パターンBが使えない環境（別PC・別アカウント）向けの手順。原本v1の方法です。

1. Fine-grained PATを発行する github.com/settings/personal-access-tokens/new を開く。
   ・Repository access＝「Only select repositories」→ nanaBOS/borderless-keiri-plugins を選択
   ・Permissions欄で「+ Add permissions」を押してから「Contents」を検索し、「Read and write」を選択
   　（※権限リストは初期状態では非表示。Ctrl+Fでは見つからないので、必ず「+ Add permissions」を押してから検索する）
   ・Metadata：Read-onlyは自動付与される
   ・「Generate token」でトークンを発行する
2. 発行したトークンをチャットに貼ってClaudeに渡す
3. Claudeが実行するgit clone https://x-access-token:<PAT>@github.com/nanaBOS/borderless-keiri-plugins → 該当ファイルを編集 → plugin.json の version を上げる → READMEに変更点を追記 → commit → push
4. 後片付け作業用cloneを削除し、GitHub側でトークンをRevoke（Settings→Personal access tokens→該当トークン→Revoke）。

03配布（同期）のやり方

経路①：組織の管理コンソールで「Update」（原本v1の運用）

1. 管理コンソールを開くclaude.ai/admin-settings/plugins
2. 「uriage-automation」のマーケットプレイス（nanaBOS/borderless-keiri-plugins）を探す
3. 「Update」ボタンを押すここだけはブラウザ操作のため、なな自身が押す必要がある（Claudeのツールからは操作できない）。
4. 同期完了後は自動各メンバーの次回セッションから最新版が反映される。

経路②：メンバー側で marketplace update（READMEの案内）

リポジトリのREADMEには、メンバー向けに次のコマンドが書かれています。

補足：今後PRベースの運用に統一し、マーケットプレイス設定で「Sync automatically」をONにすれば、PRがmainにマージされた時点で自動同期されます（直接pushでは動きません）。8/5にPR運用の実績ができたので、この切り替えは現実的な選択肢です。

04版数・変更履歴のルール（必須）

• 修正のたびに、必ず同じコミットの中で plugin.json の version を上げ、READMEに変更点（何を直したか・何を追加したか）を書く。
• 理由：版数を上げないと、どの環境が新版かを判別できない（2026-07-29に旧版のまま配布され、修正が消えた事故があったため）。
• スキル修正（save_skillでの個人版更新）とプラグイン再ビルドは必ずセットで行う。片方だけ直すと「先祖返り」が起きる。

05アクセス権限の管理

現状

• リポジトリ nanaBOS/borderless-keiri-plugins のOwner／Admin権限：なな
• 公開設定：private（2026-08-25 確認済み）

後任・メンバーへの権限付与手順

1. リポジトリの Settings → Collaborators and teams
2. 「Add people」招待したい相手のGitHubユーザー名／メールを入力する。
3. 権限レベルを選ぶ更新作業をしてもらうなら「Write」以上、閲覧のみなら「Read」。
4. 相手が招待を承諾すればアクセス可能

組織配布（Claude管理コンソール）側の権限

• claude.ai/admin-settings/plugins の操作には、Claude組織のオーナー権限が別途必要（GitHubの権限とは別枠）。
• 後任にはGitHub側の権限とClaude組織のオーナー権限の両方を引き継ぐ必要がある。

PAT発行時の注意点（パターンCを使う場合）

• PATは作業のたびに新しく発行し、使い終わったら必ずRevoke（トークンを使い回さない）。
• Repository accessは対象リポジトリのみに絞る（全リポジトリへのアクセスを許可しない）。
• PATをチャット以外の場所（メモ・Slack等）に保存しない。

06トラブルシューティング