# Setup Project

> 指定プロジェクトに dot-claude-dev の共通設定をセットアップする

- Skill: `ryryo/setup-project` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add ryryo/setup-project`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryryo/setup-project/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ryryo (https://skillmd.com/u/ryryo)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ryryo/setup-project

---


# setup-project

指定したプロジェクトに対して、setup-guide.md の手順に従い Claude Code 共通設定をセットアップする。

## トリガー

`/setup-project` または「セットアップ」「プロジェクトにセットアップ」「setup-project」

## Step 0: プロジェクトパスの確認

スキル起動時の引数にパスが含まれていればそれを使う（例: `/setup-project ~/my-project`）。

パスが指定されていない場合のみ、AskUserQuestion で確認する:

```
「どのプロジェクトにセットアップしますか？（絶対パスまたは ~/... 形式で入力）」
```

パスが `~` で始まる場合は `$HOME` に展開して使う。

## Step 1: 事前確認

```bash
# プロジェクトディレクトリの存在確認
ls "{PROJECT_PATH}"

# 現在のリンク状態を確認
bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts/check-claude-setup.sh" "{PROJECT_PATH}"
```

出力の `セットアップ種別` を見て、以降の見出しを選ぶ。

- **新規** → 「新規セットアップ」へ進む。
- **更新（既存セットアップ正常・再適用可能）** → 「既存セットアップ更新」へ進む。
- **更新/修復（不足または別パスあり）** → 「既存セットアップ更新」へ進む。再リンクで修復する。

## 新規セットアップ

初回セットアップでは Step 2 から Step 7 まで順に実行する。

## 既存セットアップ更新

既存プロジェクトの更新では Step 2 を必ず実行する。`setup-claude.sh` は idempotent なので、既存リンクを維持しつつ不足分だけ反映する。

Step 3 以降は必要に応じて確認として実行する。ただし `scripts/setup-claude-remote.sh` / `scripts/setup-local.sh` を上書きしたくない場合は Step 3 をスキップする。

## Step 2: setup-claude.sh 実行（新規・更新共通）

```bash
cd "{PROJECT_PATH}" && bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/scripts/setup-claude.sh"
```

`setup-claude.sh` は `.claude/{rules/workflow, skills/dev, commands/dev, hooks/dev}` と `.codex/{skills/dev, hooks/dev}` にシンボリックリンクを作成し、`.gitignore` を差分反映する。また、過去のセットアップで登録された Codex `commit-check` Stop hook があれば解除する。

`.codex/hooks/dev` のスクリプトは再登録しやすいよう共有リンクとして保持するが、通常のセットアップでは実行フックに登録しない。

実行後、リンクが正しく作成されたか再確認:

```bash
bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts/check-claude-setup.sh" "{PROJECT_PATH}"
```

終了コードが 1 の場合はエラー内容をユーザーに報告して停止する。

## Step 3: リモートセットアップスクリプトのコピー

```bash
mkdir -p "{PROJECT_PATH}/scripts"
TEMPLATE_DIR="${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts"
cp "$TEMPLATE_DIR/setup-claude-remote.sh" "{PROJECT_PATH}/scripts/"
cp "$TEMPLATE_DIR/setup-local.sh" "{PROJECT_PATH}/scripts/"
```

## Step 4: .gitignore の確認

```bash
bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts/update-gitignore.sh" "{PROJECT_PATH}"
```

`setup-claude.sh` 内でも実行される。ここでは再確認として idempotent に実行する。

## Step 5: 旧 Codex Stop hook 登録の解除確認

```bash
bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts/create-codex-hooks.sh" "{PROJECT_PATH}"
```

`setup-claude.sh` 内でも実行される。新しい hooks 設定は作成せず、既存の `.codex/hooks.json` に旧 `.codex/hooks/dev/commit-check.sh` の登録がある場合だけ削除する。ほかの hooks は維持する。

## Step 6: settings.json の作成

```bash
bash "${CLAUDE_SHARED_DIR:-$HOME/dot-claude-dev}/.claude/skills/setup-project/scripts/create-settings-json.sh" "{PROJECT_PATH}"
```

新規の `settings.json` には commit-check Stop hook を含めない。既存設定に旧 `.claude/hooks/dev/commit-check.sh` の登録がある場合は、その登録だけ削除してほかの hooks を維持する。

## Step 7: 結果サマリー表示

```
## セットアップ完了: {PROJECT_PATH}

| 項目 | 状態 |
|------|------|
| .claude シンボリックリンク（rules/skills/commands/hooks） | ✓ |
| .codex シンボリックリンク（skills/hooks） | ✓ |
| scripts/setup-claude-remote.sh | ✓ |
| scripts/setup-local.sh | ✓ |
| .gitignore 更新 | ✓ |
| .claude/settings.json | ✓ 新規作成・旧 Stop hook 解除 |
| .codex/hooks.json | ✓ 旧 Stop hook 未登録・解除済み |
```