peintangos/init-repo

Init Repo

Arguments: $ARGUMENTS

Goal

対話を通じてユーザーの意図を汲み取り、新しい git リポジトリを作成して開発をすぐに始められる状態にする。

Workflow

1. ヒアリング

以下の情報を対話で集める。$ARGUMENTS に含まれている情報は再度聞かない。 推測できるものは推測して確認を取る形にし、質問攻めにしない。 関連する項目はまとめて聞く。

必須

| 項目 | 例 | |---|---| | プロジェクト名 | my-app | | 一行の説明 | "家計簿管理のCLIツール" | | 主要言語 / スタック | TypeScript + Node.js, Python, Rust, Go など |

任意（デフォルト提案つき）

| 項目 | デフォルト | 補足 | |---|---|---| | ディレクトリの場所 | カレントディレクトリ直下に {プロジェクト名}/ | 既存ディレクトリでも可 | | .gitignore テンプレート | 言語から自動判定 | GitHub の gitignore テンプレートを使用 | | ライセンス | MIT | なしも選択可 | | パッケージマネージャ初期化 | 言語から自動判定（npm, pip, cargo など） | スキップも可 | | 初期ディレクトリ構造 | 言語の慣例に従う | 例: src/, tests/ | | GitHub リモート作成 | 作成する | gh repo create を使用 | | リポジトリの公開範囲 | private | public / private / internal |

ヒアリングのコツ：

• 最初の1ターンで必須項目をまとめて聞く
• 任意項目はデフォルト値を提示して「これでいい？変えたいところある？」と確認する
• ユーザーが急いでいる雰囲気なら、デフォルトをそのまま適用して進める

2. リポジトリ作成

ヒアリング結果に基づいて以下を実行する。

2.1 ディレクトリと git init

mkdir -p {path}
cd {path}
git init

既存ディレクトリを指定された場合は mkdir をスキップ。 既に .git/ がある場合はユーザーに確認を取ってから続行する。

2.2 .gitignore

言語・スタックに適した .gitignore を生成する。 GitHub の公式テンプレート（https://github.com/github/gitignore）の内容をベースにする。 よく使われる追加パターン（.env, .DS_Store, エディタ設定など）も含める。

2.3 README.md

最小限の README を生成する：

# {プロジェクト名}

{説明}

## Getting Started

TODO

## License

{ライセンス名}

凝った README は不要。あとからユーザーが育てる前提。

2.4 LICENSE

ユーザーが選択したライセンスのフルテキストを生成する。 年号とコピーライトホルダーは git config の user.name から取得する。 「なし」を選択した場合はスキップ。

2.5 パッケージマネージャ初期化

言語に応じて適切な初期化コマンドを実行する：

| 言語 | コマンド | |---|---| | Node.js / TypeScript | npm init -y → description と name を上書き | | Python | pyproject.toml を生成（PEP 621 準拠） | | Rust | cargo init （既に Cargo.toml がなければ） | | Go | go mod init {module-path} | | その他 | スキップし、ユーザーに手動セットアップを促す |

TypeScript を選択した場合は tsconfig.json も生成する。

2.6 ディレクトリ構造

言語の慣例に沿った最小限のディレクトリを作成する。 空ディレクトリには .gitkeep を置く。

例（TypeScript）：

src/
tests/

例（Python）：

src/{package_name}/
  __init__.py
tests/

必要以上にディレクトリを作らない。ユーザーが成長させる前提。

3. 初期コミット

git add -A
git commit -m "Initial commit"

4. GitHub リモート作成

ユーザーがリモート作成を希望した場合のみ実行する。

gh repo create {name} --{visibility} --source=. --push

gh コマンドが使えない場合はインストール手順を案内する。 認証が通っていない場合は gh auth login の実行を促す。

作成後、リポジトリ URL を表示する。

5. 結果報告

完了後、以下を簡潔に報告する：

• 作成したディレクトリとファイル一覧
• git リポジトリの状態（ブランチ名、初期コミット済み）
• GitHub リポジトリ URL（作成した場合）
• 次にやるべきこと（コードを書き始める、CI を設定するなど）

Notes

• このスキルはリポジトリの初期化に特化する。CI/CD 設定やフレームワーク固有のスキャフォールディングは範囲外
• create-react-app や next init のようなフレームワーク固有の scaffolding ツールがある場合は、そちらを使うことを提案してもよい。ただしユーザーが明示的にシンプルなセットアップを望んでいる場合はこのスキルで進める
• 既にファイルが存在するディレクトリで実行する場合、既存ファイルを上書きしない