setup-repo について
リポジトリの調査、課題トラッカーとエージェントスキルの設定、コーディング規約の導入をまとめて進めるスキルです。エンジニアリングスキル用の環境を整えるユーザー向けで、書き込み前に設定案をまとめて確認します。
主な機能
- 01リポジトリの状態と規約を調査
- 02リモートがない場合にGitHubの非公開リポジトリを作成
- 03トラッカーとエージェントスキルを設定
- 04コーディング規約を導入
- 05書き込み前に統合案を確認
活用シーン
- 01エンジニアリングスキル用に新規リポジトリを準備
- 02標準のGitHub設定でリポジトリを構成
- 03エージェント文書とコーディング規約をまとめて追加
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ hu3rror/ my-skills --skill setup-repoインストール後、Claude Code で/setup-repoを入力して読み込まれたか確認します。
詳細
このリポジトリを一度の実行でセットアップする
エンジニアリングスキルでリポジトリを使えるようにするための、一度で実行できるエントリーポイントです。薄いオーケストレーターとして、2 つのセットアッププリミティブを順番に実行し、順序とルーティングに関する情報だけを扱います。各手順を言い換えたり、内容をコピーしたりすることはありません。
標準回答(編集可能 — このユーザーのリポジトリでは常にこれを選択します)
- イシュートラッカー:GitHub
- 空のリポジトリ(リモートがなく、Git リポジトリでさえない場合があります):GitHub のデフォルトを適用するため、まず現在のディレクトリから GitHub のプライベートリポジトリを作成します(ステップ 2)。
- トリアージラベル:デフォルトの用語(
needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix) - エージェントファイル:存在するものを編集します。
CLAUDE.mdがあればそれを、なければAGENTS.mdを使います。もう一方は決して作成しません。 - ドメインドキュメント:モノレポの兆候から別の構成が妥当と判断できない限り、単一コンテキスト(ルートに
GLOSSARY.mdとdocs/adr/)を使います。
プロセス
1. 調査
ディレクトリに .git がない場合は git init を実行します。リポジトリ外では git remote -v がエラーになるためです。その後、調査ステップを実行します。調査対象は、git remote -v、ルートにある AGENTS.md/CLAUDE.md、GLOSSARY.md/GLOSSARY-MAP.md、docs/adr/、docs/agents/、.scratch/、モノレポの兆候、および triage スキルがインストールされているかどうかです。
2. リポジトリにリモートがない場合は設定する
調査でリモートがまったく見つからなかった場合は、トラッカーのセットアップ前にリモートを作成します。
- ディレクトリがすでに Git リポジトリになっていること(ステップ 1)。
- まだコミットがない場合は、最小限の初回コミット(
README.mdまたは.gitignore)を作成します。空のプッシュは失敗します(src refspec HEAD does not match any)。 gh repo create <dir-name> --private --source=. --push(Issue はデフォルトで有効、リモート名はディレクトリ名)。- 失敗した場合(
ghの未認証/ネットワーク障害/名前の競合)は、選択肢を提示して確認します(GitHub/GitLab/ローカルの Markdown/その他)。
プリミティブを実行する前にリモートが存在している必要があります。GitHub のリモートがあれば、セクション A では GitHub が提案され、ローカルの Markdown へのフォールバックは発生しません。
3. デフォルトを事前入力して setup-matt-pocock-skills を実行する
そのプロセスに従いますが、各セクションで質問する代わりに、上記の標準回答を適用します。調査でデフォルトと矛盾する根拠が見つかった場合、または根拠が不足している場合に限り質問し、質問する各セクションでは推奨回答を最初に提示します。
- リモートが GitLab の場合 → GitLab を提案します。リモートがまったくない場合 → ステップ 2 ですでに GitHub のプライベートリポジトリを作成しているため、GitHub のデフォルトが適用されます。
CLAUDE.mdだけが存在する場合、またはいずれのエージェントファイルも存在しない場合 → エージェントファイルの選択についてユーザーに確認します。- モノレポの兆候がある場合 → 複数コンテキストの構成を提示します。
triageがインストールされていない場合 → そのセクションを黙ってスキップします。- 以前の出力がすでに
docs/agents/にある場合 → 再実行の前に確認します(再実行が必要なのはトラッカーを切り替える場合のみです)。
CLAUDE.md がすでに存在する場合(またはその逆の場合)に AGENTS.md を作成してはならないという、このプリミティブ独自のルールは引き続き適用されます。
4. 続いて setup-coding-standards を実行する
リポジトリのルートに CODING_STANDARDS.md を作成します(ベースラインをそのまま記載し、確認済みのリポジトリ規約を追加します)。ガードレールは変更されずに引き継がれます。リポジトリにすでに規約ファイルがある場合は処理を停止して報告し、何も書き込みません。
5. 全体をまとめて一度に確認してから書き込む
## Agent skills ブロック、docs/agents/* ファイル、および CODING_STANDARDS.md の内容をすべて含む単一のドラフトを提示します。書き込む前にユーザーが編集できるようにします。その後、すべてを書き込みます。
6. 完了
何を書き込んだか、どこに書き込んだかを報告します。セットアップの一部だけが必要な場合(例:一時的なリポジトリで setup-matt-pocock-skills だけを実行する場合)には、各プリミティブを単独でも引き続き利用できます。
対象外
## Agent skillsブロックの形式を拡張したり、プリミティブが書き込まないセクションを追加したりすること。出力の管理元は、それぞれのプリミティブに一本化します。- 既存の規約ファイルですでに扱われている内容。変更するかどうかは人間が判断します。