GitHub Copilot / Copilot Agent Mode / Copilot Cloud Agent および Claude Code と連携し、安全かつ一貫したデータ分析作業を行うためのリポジトリテンプレートです。
- Python 3.11
- uv がインストール済みであること
uv syncuv sync # 依存関係のインストール・同期
uv run pytest # テスト実行
uv run ruff check . # リント
uv run ruff format . # フォーマット
uv run mypy src # 型チェック
uv run python scripts/check_no_raw_data_commit.py # rawデータのコミットチェック
uv run python scripts/check_no_sensitive_patterns.py # 秘密情報パターンの検出
uv run python scripts/validate_agent_docs.py # エージェント文書の検証
bash scripts/run_quality_checks.sh # 全品質チェック一括実行.
├── AGENTS.md # Copilot エージェント用ルーター
├── CLAUDE.md # Claude Code 用指示（ハードルール・スキルルーター）
├── .github/
│ ├── copilot-instructions.md # Copilot共通指示（薄いファイル）
│ ├── workflows/ci.yml # GitHub Actions CI
│ ├── instructions/ # パス別補助指示（Copilot）
│ ├── prompts/ # 再利用プロンプト（Copilot）
│ └── skills/ # 作業別スキル（Copilot）
├── .claude/
│ └── skills/ # 作業別スキル（Claude Code、旧スラッシュコマンドを含む）
├── docs/agent/ # プロジェクト固有ドキュメント（共通）
├── data/
│ ├── raw/ # 元データ（不変・gitignore対象）
│ ├── external/ # 外部データ（不変・gitignore対象）
│ ├── interim/ # 中間加工データ
│ └── processed/ # 最終加工データ
├── notebooks/ # 分析用Notebook
├── outputs/
│ ├── figures/ # グラフ・図
│ ├── tables/ # 集計テーブル
│ └── reports/ # レポート
├── scripts/ # CI・検証スクリプト
├── src/analysis_project/ # 再利用可能なPythonモジュール
└── tests/ # テスト
このリポジトリは GitHub Copilot と Claude Code の両方に対応しています。
共通の docs/agent/ ドキュメントとスキル体系を持ちながら、エージェントごとに専用の指示ファイルを用意しています。
| ファイル | 役割 |
|---|---|
.github/copilot-instructions.md |
薄い共通指示。全タスクで必要な最小限のルールと詳細指示への案内 |
AGENTS.md |
タスク種別に応じて適切なスキルファイルへ誘導するルーター |
.github/skills/*/SKILL.md |
作業別の詳細手順（Python・SQL・データ処理・可視化など） |
.github/instructions/*.instructions.md |
パス別の補助指示。ファイル種別に応じた自動適用ルール |
.github/prompts/*.prompt.md |
再利用可能なプロンプト（分析計画・SQLレビュー・レポートなど） |
| ファイル | 役割 |
|---|---|
CLAUDE.md |
ハードルール・パッケージ管理・スキルルーティングを一元管理 |
.claude/skills/*/SKILL.md |
作業別の詳細手順（Copilot の skills と同内容）。 |
| ディレクトリ | 役割 |
|---|---|
docs/agent/ |
プロジェクト固有の知識（データカタログ・指標定義・分析ワークフローなど） |
この設計により、全部入りの巨大な指示ファイルを避け、トークン効率よく必要な情報だけを参照できます。
| スキル | 用途 |
|---|---|
python-project-ops |
依存関係、テスト、リント、型チェック |
safe-data-handling |
データの安全な取り扱い |
sql-analysis |
SQLの作成・レビュー |
python-style |
Pythonコーディングスタイル |
dataframe-polars |
DataFrameの操作（polars優先） |
visualization |
グラフ・可視化 |
path-and-io |
ファイルパスとI/O |
notebook-workflow |
Notebook作業 |
statistical-ml-review |
統計・ML分析 |
analysis-reporting |
分析結果の報告 |
Claude Code では .claude/skills/*/SKILL.md として（/plan-analysis のようにスラッシュでも起動可能）、Copilot では引き続き .github/prompts/*.prompt.md として提供されるタスク実行用スキル。
| スキル | Claude Code | Copilot | 用途 |
|---|---|---|---|
plan-analysis |
/plan-analysis |
prompt | 分析計画の作成 |
review-sql |
/review-sql |
prompt | SQLのレビュー |
summarize-analysis |
/summarize-analysis |
prompt | 分析結果の要約 |
prepare-pr |
/prepare-pr |
prompt | PR概要の作成 |
update-agent-docs |
/update-agent-docs |
prompt | エージェント文書の更新 |
sync-agent-docs |
/sync-agent-docs |
prompt | Claude/Copilot間のスキル差分の同期 |
run-eda |
/run-eda |
— | EDAの実装・実行 |
run-modeling |
/run-modeling |
— | 予測モデリングの実装・評価 |
Claude Code と GitHub Copilot のスキルは2種類の対応関係を持ちます。
- 通常スキル:
.claude/skills/<name>/SKILL.md⇔.github/skills/<name>/SKILL.md。スキル内リンクの相対パス表記を除いて同一内容。 - タスク実行スキル（frontmatter に
disable-model-invocation: true）:.claude/skills/<name>/SKILL.md⇔.github/prompts/<name>.prompt.md。frontmatter 形式を変換し、Copilot の${input:...}プレースホルダやCLAUDE.md⇔AGENTS.mdの相互参照を保持・変換しながら同期。
片方を編集すると差分が生じるため、以下の仕組みで検出・解消します。
uv run python scripts/sync_agent_docs.py --check— 書き込みせず差分の有無だけを判定する（run_quality_checks.sh/ CIに組み込み済み。通常スキルの差分のみ終了コード1）。uv run python scripts/sync_agent_docs.py --from claude（または--from github） — 編集した側を明示してもう一方へ反映する。方向は必須（mtime による自動判定はしない）。/sync-agent-docs（Claude Code）・prompt（Copilot） — 上記スクリプトを実行した上で、片側にしか存在しないスキルなど、判断が必要な差分をエージェントが解消する。- ロジックのテスト:
uv run pytest tests/test_sync_agent_docs.py。
data/raw/とdata/external/は不変として扱い、直接変更しない。- rawデータ、認証情報、APIキー、トークン、顧客レベルのレコードをコミットしない。
- 加工データは
data/interim/やdata/processed/に出力する。 - 図表やレポートは
outputs/に出力する。 .envファイルは.gitignoreでコミット対象外。
- uv のみを使用する。pip、conda、poetry は使わない。
- 依存関係の追加:
uv add <package> - 開発依存の追加:
uv add --group dev <package>