【保存版】Git/GitHub入門：バージョン管理・ブランチ戦略・レビュー・自動化を“実務の型”で最短習得

# あなたの名前とメール（コミット作者として記録されます）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
#新規リポジトリのデフォルトブランチ名をmainにする
git config --global init.defaultBranch main
# 改行コードの自動変換設定（Windows混乱の軽減）
# Windows: autocrlf=true でもOK。Mac/Linuxは基本 input で十分。
git config --global core.autocrlf input
# 差分やログをカラー表示で見やすく
git config --global color.ui auto

project/
  ├─ data/
  │   ├─ raw/          # 受領データ（非追跡にすることが多い）
  │   └─ warehouse/    # SQLiteなど（非追跡）
  ├─ notebooks/
  ├─ src/
  ├─ reports/          # 図/Excel/PDF（必要に応じ非追跡）
  ├─ tests/
  ├─ .gitignore
  ├─ requirements.txt
  └─ README.md

# Python
__pycache__/
*.pyc
.venv/
.env
# Data / Outputs
/data/*
!/data/README.md
/reports/*
!/reports/README.md
*.sqlite
# Jupyter
.ipynb_checkpoints/
# OS/editor
.DS_Store
Thumbs.db

cd project
git init
echo "# プロジェクト名" > README.md
git add .
git commit -m "feat: 初期雛形を追加 (構成/ignore/README)"

# GitHubで空のリポジトリ（project名）を作成後に接続
git remote add origin https://github.com/yourname/project.git
git branch -M main
git push -u origin main

# 新機能用のブランチを切る
git switch -c feat/monthly-report
# 変更→テスト→コミット
git add -p
git commit -m "feat: 月次集計のSQLとNotebookを追加"
# GitHubへプッシュ
git push -u origin feat/monthly-report

git status # 今の状態を確認
git diff # 差分（変更点）を確認
git add -p # 変更を対話的に選んで追加
git commit --amend # 直前コミットを上書き（未push時のみ）
git stash && git switch main # 作業を一時退避してmainへ
git log --oneline --graph --decorate --all # 履歴を図で把握

# 自分のブランチにmainの変更を取り込みたいとき
git switch feat/monthly-report
git fetch origin
git rebase origin/main
# コンフリクト解消→テスト後に、リモート履歴を置き換える（自分のブランチだけ！）
git push --force-with-lease

# .git/hooks/pre-commit（chmod +x で実行権限を付与）
#!/usr/bin/env bash
find . -name "*.ipynb" -print0 | \
xargs -0 -I {} jupyter nbconvert \
--ClearOutputPreprocessor.enabled=True --inplace {}

## 目的
- 例：月次集計と図を追加し、Excel出力まで自動化

## 変更点（Before/After）

* SQL: WITH monthly を追加
* report.py: ExcelWriter で Summary タブ出力

## 動作確認

* `python src/report.py` で report.xlsx が生成される

## 影響範囲

* なし（新規追加のみ）

### 概要
### ゴール（受け入れ条件）
### 参考

# mainを最新化
git switch main && git pull
# 意味のある節目にタグを打つ
git tag -a v0.1.0 -m "初回リリース: 月次集計+Excel出力"
git push origin v0.1.0

name: ci
on:
  pull_request:
  push:
    branches: [main]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with: { python-version: '3.11' }
      - run: pip install -r requirements.txt || true
      - run: python -m pip install pytest
      - run: pytest -q || echo "tests not found; skipping"

# ブランチ
git switch -c feat/foo     # 作成+切替
git switch main            # 切替
# 差分/取り消し
git diff                    # 差分
git restore --staged file   # ステージ解除
git restore file            # 変更取り消し
# 追跡をやめる（ファイルは残す）
git rm --cached path/to/file

# プロジェクト名
目的：誰の、どの意思決定を支援するか（1文）
再現手順：
1) python -m venv .venv && source .venv/bin/activate
2) pip install -r requirements.txt
3) python src/report.py  # Excel/図を出力
データ：data/raw/ 以下に配置（入手方法を記載）