Claude Action Bootstrap

---
name: claude-action-bootstrap
description: Policy-enforcing installer that deploys hardened Claude Code Action workflows (`@claude` manual mention + dependency-bot auto-fix) into a personal GitHub repository the user administers. Use when asked to introduce Claude Code Action, apply `@claude` mention support, or set up automated CI auto-fix for dependency bot PRs, using the security-hardened templates shipped with this skill.
---

# Claude Code Action Bootstrap

本 skill は、berlysia が管理する個人 repo に、このリポジトリで確立された **Claude Code Action 運用** を展開する policy-enforcing installer。以下 2 本の workflow を **プレースホルダー置換 + ハードコード部の改変禁止** を機械検証つきで配置する:

- `claude.yml`: `@claude` メンションによる手動起動
- `auto-fix-dependencies.yml`: 依存 bot PR の CI 失敗自動修正（強化版 — SHA pin / environment scope / allowed_bots / fine-grained tool 制約 / fork 除外）

## Threat Model（設計の前提）

- **対象**: berlysia 自身が admin を持つ個人 repo のみ。他者への配布 / 公開ツール化は想定しない
- **攻撃者モデル**: なし（自己適用）。prompt injection のリスクは「自分の repo に自分で誤設定を書き込む」程度に限定
- **担保**: `actionlint` + `zizmor` を **hard prerequisite** とし、展開後の workflow に構文違反 / GitHub Actions SAST 違反がないことを機械検証する。owner id ピン留め / bot type 二重判定 / drift hash 比較等の追加防御は採用しない

## Prerequisites

**skill は同梱の自己検証スクリプトを最初に実行する。exit code が 0 でなければ Step 1 に進まない。**

```bash
bash ~/.claude/skills/claude-action-bootstrap/scripts/verify-prerequisites.sh
```

検証対象（スクリプトが内部で実施）:

| 項目       | 判定                                       | fail 時の remediation                    |
| ---------- | ------------------------------------------ | ---------------------------------------- |
| gh CLI     | `command -v gh`                            | `mise use -g gh@latest`                  |
| gh auth    | `gh auth status`                           | `gh auth login`                          |
| repository | `gh repo view --json nameWithOwner` が通る | target repo のルートで再実行             |
| admin 権限 | `.permissions.admin == true`               | admin を取得するか別 repo で再実行       |
| actionlint | `command -v actionlint`                    | `mise use -g actionlint@latest`          |
| zizmor     | `command -v zizmor`                        | `mise use -g zizmor@latest` または cargo |

**informational（スクリプトは表示するが判定しない）**:

- `allow_auto_merge`: Step 5 で auto-fix workflow を導入する場合に有効化する

**OAuth token は検証対象外**: skill 実行時には secret が未登録でも skill 本体の展開はできるため、スクリプトは token を検証しない。Step 5 で `gh secret set` により登録する（`/install-github-app` が最も簡単）。

## Quick Start

```bash
# 1. ターゲット repo のルートに移動
cd /path/to/target-repo

# 2. 自己検証スクリプトを実行（全 pass で exit 0）
bash ~/.claude/skills/claude-action-bootstrap/scripts/verify-prerequisites.sh
```

skill はこの結果を見て:

- exit 0 → Step 1 へ進む
- exit 1 → スクリプト出力の remediation を提示して中断（ユーザーが修正後に再実行）

## Workflow

```
Bootstrap Progress:
- [ ] Prerequisites: verify-prerequisites.sh が exit 0
- [ ] Step 1: 既存ファイル衝突確認
- [ ] Step 2: パラメータ収集（allowed senders / env / CI / bots）
- [ ] Step 3: claude.yml 展開（mandatory）
- [ ] Step 4: auto-fix-dependencies.yml 展開（optional）
- [ ] Step 5: Environments + Secrets 設定 → verify-secrets.sh が exit 0
- [ ] Step 6: actionlint + zizmor 検証
- [ ] Step 7: 動作確認
```

### Step 1: 既存ファイル衝突確認

admin 権限 / auto-merge / ツール一式は Prerequisites スクリプトで検証済み。Step 1 では workflow ファイルの衝突のみ確認する。

```bash
OWNER_REPO=$(gh repo view --json nameWithOwner --jq '.nameWithOwner')
```

**既存 workflow 衝突確認:**

```bash
for f in .github/workflows/claude.yml .github/workflows/auto-fix-dependencies.yml; do
  [ -f "$f" ] && echo "EXISTS: $f（Step 3/4 で diff 提示 + 上書き確認）"
done
```

**renovate skill 由来の汎用 `auto-fix-dependencies.yml` が既にある場合**:
過渡期の重複として容認。Step 4 の diff 提示で強化版に置き換えることを確認する。

### Step 2: パラメータ収集

skill は対話的に以下を収集する。デフォルト値を提示し、Enter で確定。

| パラメータ               | プレースホルダー        | デフォルト                                        |
| ------------------------ | ----------------------- | ------------------------------------------------- |
| Allowed senders          | `{{ALLOWED_SENDERS}}`   | `github.event.sender.login == 'berlysia'`         |
| Manual env name          | `{{MANUAL_ENV_NAME}}`   | `claude-manual`                                   |
| Autofix env name         | `{{AUTOFIX_ENV_NAME}}`  | `claude-autofix`                                  |
| CI workflow names (YAML) | `{{CI_WORKFLOW_NAMES}}` | `      - "CI Status Check"` （インデント 6 空白） |
| Allowed bots             | `{{ALLOWED_BOTS}}`      | `renovate[bot],dependabot[bot],app/renovate`      |

**CI workflow 名の候補列挙:**

```bash
gh api repos/$OWNER_REPO/actions/workflows | jq -r '.workflows[] | select(.state=="active") | .name'
```

複数 CI を監視する場合は YAML list として連結:

```yaml
- "CI Status Check"
- "Another CI"
```

**Allowed senders に複数ユーザーを含める場合** (`||` 連結):

```yaml
github.event.sender.login == 'berlysia' || github.event.sender.login == 'another'
```

### Step 3: `claude.yml` 展開（mandatory）

1. `assets/workflows/claude.yml` を読み込み、Step 2 のパラメータで `{{ALLOWED_SENDERS}}` / `{{MANUAL_ENV_NAME}}` を置換
2. 既存 `.github/workflows/claude.yml` があれば diff 提示 → ユーザーに上書き確認
3. 書き込み

**ハードコード部（skill 実行時でも改変しない）**:

- `anthropics/claude-code-action@b47fd721da662d48c5680e154ad16a73ed74d2e0 # v1.0.93` — 供給チェーン攻撃対策。更新はターゲット repo の renovate に委ねる
- `persist-credentials: false`
- `fetch-depth: 1`

### Step 4: `auto-fix-dependencies.yml` 展開（optional）

導入可否をユーザーに確認してから進める。auto-merge が無効な repo では Step 5 で有効化する。

1. `assets/workflows/auto-fix-dependencies.yml` を読み込み、`{{CI_WORKFLOW_NAMES}}` / `{{AUTOFIX_ENV_NAME}}` / `{{ALLOWED_BOTS}}` を置換
2. 既存ファイルがあれば diff 提示 → 上書き確認
3. 書き込み

**ハードコード部（skill 実行時でも改変しない）**:

- `anthropics/claude-code-action@b47fd721da662d48c5680e154ad16a73ed74d2e0 # v1.0.93`
- `fetch-depth: 0`（自動修正のため commit push 権限が必要）
- `persist-credentials: false`
- `sameRepo && !isFork` の fork 除外ロジック — コード内に `SECURITY-CRITICAL: do not edit` コメント明示
- GitHub Script による bot 判定（`allowedBots.includes(author)` の `login` 文字列一致）
- `concurrency: auto-fix-${{ github.event.workflow_run.head_sha }}`（重複抑止）
- プロンプト内の tool constraints（Read/Glob/Grep 強制、single-line git commit、`git add` と `git commit` 分離）

### Step 5: Environments + Secrets 設定

**Environment を作成（deployment_branch_policy で保護）:**

```bash
for ENV_NAME in "${MANUAL_ENV:-claude-manual}" "${AUTOFIX_ENV:-claude-autofix}"; do
  gh api -X PUT repos/$OWNER_REPO/environments/$ENV_NAME \
    --input - <<'EOF'
{"deployment_branch_policy": {"protected_branches": false, "custom_branch_policies": true}}
EOF
done
```

**OAuth トークンを各 env に登録:**

**IMPORTANT**: OAuth トークンを LLM プロンプトや conversation に貼り付けないこと。skill は以下のコマンド **例** を提示するに留め、実際の値はユーザー自身がターミナルで入力する。

```bash
# 対話的に値を入力（履歴に残さない）
gh secret set CLAUDE_CODE_OAUTH_TOKEN --env $MANUAL_ENV
gh secret set CLAUDE_CODE_OAUTH_TOKEN --env $AUTOFIX_ENV
```

**OAuth トークンの取得方法**: Claude Code CLI で `/install-github-app` を実行、または手動で https://claude.ai/settings から発行。

**auto-fix を導入する場合は `allow_auto_merge=true` を有効化:**

```bash
gh api -X PATCH repos/$OWNER_REPO -f allow_auto_merge=true
```

**確認（自己検証スクリプト）:**

skill は env 作成 + secret 登録が終わったら、以下のスクリプトで pass/fail を機械判定する。exit 0 でなければ Step 6 に進まない。

```bash
# デフォルト env 名を使う場合
MANUAL_ENV=claude-manual AUTOFIX_ENV=claude-autofix \
  bash ~/.claude/skills/claude-action-bootstrap/scripts/verify-secrets.sh

# auto-fix を入れない場合は AUTOFIX_ENV を空で skip
AUTOFIX_ENV= \
  bash ~/.claude/skills/claude-action-bootstrap/scripts/verify-secrets.sh
```

スクリプトが判定する項目:

| 項目                                | 判定                                                    | fail 時の remediation                                   |
| ----------------------------------- | ------------------------------------------------------- | ------------------------------------------------------- |
| 各 env の存在                       | `gh api repos/.../environments/<ENV>` が 200            | `gh api -X PUT` で env を作成                           |
| 各 env に `CLAUDE_CODE_OAUTH_TOKEN` | env secrets 一覧に含まれる                              | `gh secret set CLAUDE_CODE_OAUTH_TOKEN --env <ENV>`     |
| repo-level の誤登録（warning）      | `actions/secrets` に同名 secret がある場合 `[!]` で警告 | 不要であれば `gh secret delete CLAUDE_CODE_OAUTH_TOKEN` |

repo-level の警告は fail 扱いではない（env-scoped secret が優先されるため）。

### Step 6: 展開後検証（`actionlint` + `zizmor`）

**actionlint は finding 0 件を必須要件とする。zizmor は下記の既知 finding を除いて 0 件を必須要件とする。**

```bash
# 1. actionlint で構文検証（0 件必須）
actionlint .github/workflows/claude.yml .github/workflows/auto-fix-dependencies.yml

# 2. zizmor で GitHub Actions SAST
zizmor .github/workflows/claude.yml .github/workflows/auto-fix-dependencies.yml
```

**既知で許容する zizmor finding**:

| Finding                     | 対象ファイル                          | 許容根拠                                                                                                                                                                                                                                                                                     |
| --------------------------- | ------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `dangerous-triggers` (high) | `auto-fix-dependencies.yml` L13 `on:` | `workflow_run` は CI 完了後の失敗時起動と secret アクセスの両立に必須。Asset は `sameRepo && !isFork` による fork 除外、`allowed_bots` による author allowlist、checkout `persist-credentials: false` による credentials 混入防止を**すべて内包**しており、この trade-off を前提に受け入れる |

**これら以外に high/critical finding が出た場合**:

```bash
# 変更を revert
git checkout -- .github/workflows/claude.yml .github/workflows/auto-fix-dependencies.yml
# または新規ファイルのみ作成した場合
rm .github/workflows/claude.yml .github/workflows/auto-fix-dependencies.yml
```

finding を診断してからユーザーに再実行を促す。

### Step 7: 動作確認

**`@claude` メンションの確認:**

1. テスト issue を作成: `gh issue create --title "test: @claude mention" --body "@claude hello, can you confirm you are listening?"`
2. Actions タブで `Claude Code` workflow が `claude-manual` environment で起動していることを確認
3. issue にコメントが返ってくるか観察

**auto-fix の確認**（auto-fix を導入した場合）:

1. 既存の依存 bot PR の CI を失敗させる（あるいは次の renovate PR を待つ）
2. CI 完了後、`Auto-fix Dependencies` workflow が `claude-autofix` environment で起動
3. commit が push されて CI が再実行され、auto-merge に引き継がれることを観察

## PM-specific prompt customization

**`auto-fix-dependencies.yml` のプロンプトは pnpm 前提で固定**。他 PM（yarn / bun / npm のみ等）の repo に適用する場合は、書き込み後に人間が `sed` 等で書き換える。

**yarn の場合（例）**:

```bash
sed -i 's/Bash(pnpm \*)/Bash(yarn *)/g; s/pnpm, npm/yarn, npm/g; s/update lockfile/update yarn.lock/g' \
  .github/workflows/auto-fix-dependencies.yml
```

**bun の場合**:

```bash
sed -i 's/Bash(pnpm \*)/Bash(bun *)/g; s/pnpm, npm/bun, npm/g; s/update lockfile/update bun.lock/g' \
  .github/workflows/auto-fix-dependencies.yml
```

書き換え後は **Step 6 の `actionlint` + `zizmor` を再実行** して構文・SAST を再確認する。

## Decision Notes

- **auto-merge 前提**: `auto-fix-dependencies.yml` のプロンプトは「merge するな、auto-merge に任せろ」と指示する。ターゲット repo で `allow_auto_merge=false` の場合、Step 5 で有効化する。無効のまま運用する場合はプロンプトの該当文言を人間が書き換える
- **fork 除外は固定 ON**: 個人 public repo でも fork PR は存在し得るため、`sameRepo && !isFork` の除外はハードコード。改変禁止コメント付き
- **SHA pin は renovate に委ねる**: asset 内の `anthropics/claude-code-action@<SHA>` は本 skill 側の renovate で更新される。ターゲット repo に renovate が入っていない場合は、本 skill を再適用する運用か、ターゲット repo 側にも renovate を導入する
- **脅威モデルは自己適用のみ**: 他者への配布・公開ツール化を想定しない。owner id ピン留め、bot `user.type` 二重判定、sender id workflow 埋込、drift hash 比較等は採用しない。将来 public / team 配布に拡張する場合は threat model を再評価する
- **`zizmor` を hard prerequisite に維持する理由**: 現時点の自己適用脅威モデル範囲外（script injection / pull_request_target の危険パターン等）も SAST で機械的に担保する前倒し投資
- **`workflow_run` の `dangerous-triggers` 許容**: `workflow_run` は「CI 失敗時に secret つきで auto-fix を起動する」設計に必須（fork PR 由来の workflow では secret が取れない / `pull_request` では CI 完了待ちができない）。この trigger の本質的リスク（PR head HEAD からの任意コード実行導線）は Asset 側で (1) `sameRepo && !isFork` による fork 除外、(2) `allowed_bots` による author allowlist、(3) checkout `persist-credentials: false` を**ハードコードとして内包**することで閉じる。この 3 防御ラインを前提に zizmor の `dangerous-triggers` finding は Step 6 で既知許容する

## Assets

- `scripts/verify-prerequisites.sh`: 起動前の自己検証スクリプト。Prerequisites の全項目を機械判定し、fail 時に remediation を提示して exit 1 で中断させる
- `scripts/verify-secrets.sh`: Step 5 後の自己検証スクリプト。env 存在 + env-scoped secret 存在を機械判定し、repo-level 誤登録を warning 表示する
- `assets/workflows/claude.yml`: `@claude` メンションテンプレ（プレースホルダー: `{{ALLOWED_SENDERS}}`, `{{MANUAL_ENV_NAME}}`）
- `assets/workflows/auto-fix-dependencies.yml`: 強化版 auto-fix テンプレ（プレースホルダー: `{{CI_WORKFLOW_NAMES}}`, `{{AUTOFIX_ENV_NAME}}`, `{{ALLOWED_BOTS}}`）

両 asset はハードコード部（SHA / fork 除外 / `persist-credentials` / `fetch-depth` / bot 判定ロジック）をコメントで明示している。`install time` に編集しない。