Setup

---
name: setup
description: Reqordプラグインの環境セットアップと前提条件チェック。CLIツール・GitHub認証・プロジェクト初期化状態を確認し、証憑を記録する。
argument-hint: "[--check] (省略時はフルセットアップ、--checkは確認のみ)"
allowed-tools: Read, Glob, Write, Bash(reqord:*), Bash(gh --version), Bash(gh auth status), Bash(git --version)
disable-model-invocation: true
---

## Scope

- **Do**: CLIツール・GitHub認証・プロジェクト初期化状態の確認、証憑記録
- **Don't**: ツールのインストール実行（インストール手順の案内のみ）。reqordデータの変更は行わない

---

> **ユーザー確認必須**: このスキルは環境設定の変更を伴います。自律実行時はセットアップ内容をユーザーに提示し、承認を得てから実行してください。

# Reqordプラグイン環境セットアップ

モード: $ARGUMENTS（デフォルト: フルセットアップ）

プラグインの動作に必要な環境を確認し、未セットアップの項目があればガイドする。
完了後、`.reqord/settings/plugin-config.yaml` にセットアップ証憑を記録する。

---

## 引数解析

| $ARGUMENTS | モード           | 処理                                          |
| ---------- | ---------------- | --------------------------------------------- |
| 空         | フルセットアップ | Step 1〜6を順に実行                           |
| `--check`  | 確認のみ         | Step 1〜4を実行し結果表示のみ（証憑更新なし） |

---

## Step 1: 必須ツールの可用性チェック

以下のコマンドを**並列実行**し、各ツールの可用性を確認する:

```bash
reqord --version        # Reqord CLI
gh --version            # GitHub CLI
git --version           # Git
```

### 判定基準

| ツール       | 必須度       | 用途                             | 不在時の影響                                        |
| ------------ | ------------ | -------------------------------- | --------------------------------------------------- |
| `reqord` CLI | **必須**     | 全スキルのデータ操作             | フォールバック可（直接ファイル読み取り）だが非推奨  |
| `gh` CLI     | **強く推奨** | feedback sync、issue検索、PR作成 | `/reqord:feedback` が使用不可 |
| `git`        | **必須**     | ブランチ操作、コミット、履歴検索 | `/reqord:verify trace` が使用不可 |

### 結果表示

```
## 環境チェック結果

| ツール | Status | Version |
|--------|--------|---------|
| reqord | ✅ | v0.5.0 |
| gh     | ✅ | 2.45.0 |
| git    | ✅ | 2.43.0 |
```

**reqord CLI が見つからない場合**:

```
❌ reqord CLI が見つかりません。
インストール方法: npm install -g @reqord/cli
```

**gh CLI が見つからない場合**:

```
⚠ gh CLI が見つかりません。
以下の機能が制限されます:
- /reqord:feedback（GitHub Issue同期）
- PR作成（gh pr create）
- /reqord:verify trace（PR検索）

インストール: https://cli.github.com/
```

---

## Step 2: GitHub CLI 認証チェック

gh CLI が存在する場合、認証状態を確認する:

```bash
gh auth status
```

### 認証済みの場合

```
✅ GitHub認証: <username> (<hostname>)
```

### 未認証の場合

```
⚠ GitHub CLIが未認証です。
`gh auth login` を実行して認証してください。

認証なしでも以下は使用可能です:
- /reqord:status, /reqord:edit, /reqord:brief, /reqord:verify validate
```

---

## Step 3: Reqordプロジェクト初期化チェック

`.reqord/` ディレクトリの存在と構造を確認する:

### 確認項目

Readツール / Globツールで以下を確認:

| パス                           | 必須度   | 用途                 |
| ------------------------------ | -------- | -------------------- |
| `.reqord/`                     | **必須** | プロジェクトルート   |
| `.reqord/context/context.yaml` | **必須** | ProjectContext       |
| `.reqord/requirements/`        | **必須** | 要件データ           |
| `.reqord/specifications/`      | **必須** | 仕様データ           |
| `.reqord/feedback/`            | 推奨     | フィードバックデータ |
| `.reqord/settings/`            | 推奨     | 設定                 |

### 未初期化の場合

```
❌ .reqord/ ディレクトリが見つかりません。
このプロジェクトはReqordで初期化されていません。

`reqord init` を実行してプロジェクトを初期化してください。
```

### 部分的に存在する場合

不足しているディレクトリ・ファイルを報告し、`reqord init` または手動作成を案内する。

---

## Step 4: ProjectContext読み込みチェック

`.reqord/context/context.yaml` が存在する場合、`files` フィールドが参照するファイルの存在を確認する:

```bash
reqord context show --json
```

または直接Readツールで `.reqord/context/context.yaml` を読み取る。

### 確認項目

| 参照先                             | 必須度       | 影響するスキル                                  |
| ---------------------------------- | ------------ | ----------------------------------------------- |
| `files.product` (product.yaml)     | 推奨         | edit, brief, new                                |
| `files.technical` (technical.yaml) | **強く推奨** | edit, brief, verify（テストコマンド特定に使用）   |
| `files.structure` (structure.yaml) | 推奨         | edit, brief（命名規則・構造ルール）               |
| `files.domain` (domain/\*.md)      | 任意         | edit（ドメイン知識）                             |

### 未設定のファイルがある場合

```
⚠ ProjectContextの以下のファイルが未設定/未作成です:
- technical.yaml: 未作成（/reqord:edit, /reqord:brief のテスト・ビルドコマンド特定に影響）
- domain/*.md: 未設定（任意）

`reqord context update` でProjectContextを更新できます。
```

---

## Step 5: セットアップ結果サマリー

全チェック結果を集約して表示する:

```
## Reqordプラグイン セットアップ結果

### 環境
| 項目 | Status |
|------|--------|
| reqord CLI | ✅ v0.5.0 |
| gh CLI | ✅ 2.45.0 (認証済み: username) |
| git | ✅ 2.43.0 |

### プロジェクト
| 項目 | Status |
|------|--------|
| .reqord/ | ✅ 初期化済み |
| context.yaml | ✅ |
| product.yaml | ✅ |
| technical.yaml | ✅ |
| structure.yaml | ⚠ 未作成 |
| domain/*.md | - (任意) |

```

---

## Step 6: 証憑記録

`--check` モードでない場合、セットアップ結果を `.reqord/settings/plugin-config.yaml` に記録する。

### 記録内容

```yaml
plugin:
  name: reqord
  setupCompletedAt: "2026-02-17T10:30:00+09:00"
  setupVersion: "0.1.0"
environment:
  reqord:
    available: true
    version: "0.5.0"
  gh:
    available: true
    version: "2.45.0"
    authenticated: true
    user: "username"
  git:
    available: true
    version: "2.43.0"
project:
  initialized: true
  context:
    product: true
    technical: true
    structure: false
    domain: []
```

### 書き込み手順

1. `.reqord/settings/` ディレクトリの存在を確認（なければ報告）
2. 既存の `plugin-config.yaml` があればReadツールで読み取り
3. Writeツールで新しい内容を書き込み

### セットアップ完了メッセージ

```
✅ セットアップが完了しました。証憑を .reqord/settings/plugin-config.yaml に記録しました。
```

---

## エラーハンドリング

### .reqord/settings/ ディレクトリが存在しない場合

```
⚠ .reqord/settings/ ディレクトリが存在しません。
証憑の記録をスキップします。
`reqord init` でプロジェクトを再初期化するか、手動でディレクトリを作成してください。
```

### 必須ツールが全て不在の場合

```
❌ 必須ツール（reqord CLI, git）が見つかりません。
プラグインの機能を使用するには、少なくとも以下のインストールが必要です:

1. reqord CLI: npm install -g @reqord/cli
2. git: https://git-scm.com/

セットアップを中止します。
```