KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#typescript #ai-agents #developer-tools #cli #codex #claude-code #react #dsh-plugin #mcp #open-source #dsh #deepseek-harness

ds-ai-coding-skills

★ 75 Open GitHub ↗

A collection of AGENTS.md configurations, skills, and prompts tailored for Data Scientists to maximize productivity with AI coding assistants.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# データサイエンス分析プロジェクトテンプレート

GitHub Copilot / Copilot Agent Mode / Copilot Cloud Agent および Claude Code と連携し、安全かつ一貫したデータ分析作業を行うためのリポジトリテンプレートです。

## セットアップ

### 前提条件

- Python 3.11
- [uv](https://docs.astral.sh/uv/) がインストール済みであること

### インストール

```bash
uv sync
```

### 主要コマンド

```bash
uv 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 の構成

| ファイル | 役割 |
|----------|------|
| `.github/copilot-instructions.md` | 薄い共通指示。全タスクで必要な最小限のルールと詳細指示への案内 |
| `AGENTS.md` | タスク種別に応じて適切なスキルファイルへ誘導するルーター |
| `.github/skills/*/SKILL.md` | 作業別の詳細手順（Python・SQL・データ処理・可視化など） |
| `.github/instructions/*.instructions.md` | パス別の補助指示。ファイル種別に応じた自動適用ルール |
| `.github/prompts/*.prompt.md` | 再利用可能なプロンプト（分析計画・SQLレビュー・レポートなど） |

### Claude Code の構成

| ファイル | 役割 |
|----------|------|
| `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/Copilot間のスキル同期

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>`

ds-ai-coding-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README