# bonus_kit — ガチ運用おまけ（ルール・スキル一式）

**AI品質安定化調査パック**の実運用キット。調査 HTML（第0〜19章）を読んだうえで、**その日から PoC / レビュー / ゲートに使える**ルールとスキルです。

| 同梱物 | 位置づけ |
| --- | --- |
| `bonus_kit/`（本フォルダ） | **おまけ・本番級** — Cursor ルール + フルスキル + PR/KPI 様式 |
| `starter_kit/` | PoC試行のたたき台（軽量） |
| `dev_docs_guide` | 定着後の正本 SSOT 運用（別フォルダ） |

## 15分で使い始める

1. 本フォルダを **試行用リポジトリ or サンドボックスブランチ** にコピー
2. **`docs/sop/ai-usage.md`** の「AI向け品質定義」をプロジェクト向けに埋める（第17章 17.0c）
3. Cursor: `.cursor/rules/` が有効か確認（`ai-quality-*.mdc`）
4. `AGENTS.md` の Commands / Rules / Done をプロジェクトに合わせる
5. 設計レビュー PoC → `$requirements-definition-gate` または `$dev-docs-gate-lite`
6. PR 前レビュー PoC → `$ai-quality-pr-review`
7. 週次 → `$ai-poc-weekly-kpi` + `docs/templates/POC_KPI_WEEKLY.md`
8. Human Gate理由 → `docs/templates/AI-OPS-LOG-TEMPLATE.md`

## 含まれるスキル

| スキル | 級 | 用途 |
| --- | --- | --- |
| `requirements-definition-gate` | 本番 | 要件ゲート MODE A–D（第17章 B-1 相当） |
| `requirements-semantic-drift-audit` | 本番 | 版間・資料間の意味逸脱（B-2） |
| `dev-docs-gate-lite` | 軽量 | 着手前 GO/NO-GO |
| `semantic-drift-lite` | 軽量 | 2資料の drift チェック |
| `ai-quality-pr-review` | **本パック専用** | PR前セルフレビュー・別モデル監査（第6章） |
| `ai-poc-weekly-kpi` | **本パック専用** | 週次 KPI・中止条件チェック（第12・19章） |
| `doc-pr-gate` | 軽量 | docs 同梱 PR チェック |
| `test-traceability-gate` | 軽量 | トレーサビリティ |

## ディレクトリ

| パス | 内容 |
| --- | --- |
| `AGENTS.md` | エージェント入口（品質副操縦士前提） |
| `.cursor/rules/` | 常時ルール（ガバナンス・コピロット） |
| `.agents/skills/` | 上記スキル一式 |
| `docs/sop/` | AI利用（品質定義テンプレ付き）· PoCガバナンス |
| `docs/templates/` | KPI週報・AI利用ログ |
| `references/` | 役割設計 · CI/CD×AI 協調ガイド（正本 MD） |
| `.github/pull_request_template.md` | AI 利用証跡欄付き |
| `scripts/` | 曖昧語スキャン・トレーサ検証 |
| `reference/` | open-items・PoCテーマ登録 |
| `../knowledge/` | **パック索引**（施策・KPI・スキル — `notes/` 正本の YAML 索引） |

PoC テーマは `reference/poc-theme-register.md` と `../knowledge/poc_themes.yaml` を同期する。


## 研修演習（期待結果）

正式な採点観点は [notes/22_研修計画.md](../notes/22_研修計画.md) · [training_index.html](../training_index.html)。

### 演習1: PR前レビュー（開発者・TL）

| 観点 | 合格条件 |
| --- | --- |
| 採否分類 | AI指摘が採用/保留/不採用の3分類されている |
| 人間判断 | 仕様・顧客影響・本番影響をAI任せにしていない |
| 証跡 | PRテンプレにAI利用と採否理由が残っている |

**期待結果:** AI指摘をそのまま全採用しない。仕様判断が要る指摘は人間レビューへ回す。

### 演習2: 要件・設計ゲート（SE・QA・PM）

**期待結果:** AIが仕様を勝手に確定していない。顧客確認と内部修正が分離。未決は推測で埋めない。

### 演習3: 週次 KPI（PM・品質担当）

**期待結果:** レビュー時間・採用率・手戻り等を数値記録。感想のみで継続判断しない。

### 演習4（任意）: リスト・権限ミニ監査

| 観点 | 合格条件 |
| --- | --- |
| permissions.json | リポジトリに存在し、破壊コマンドが block されている |
| スコープ | ドライブ直下ではなくリポジトリルートで作業 |
| 依頼文 | 「ブランチ整理」依頼に dry-run 手順が AGENTS または SOP にある |

**期待結果:** denylist のみに依存していない（allowlist または承認フローあり）。

## 調査本編との対応

- マスタ判断: 調査 HTML **第19章** · 索引: `../knowledge/`
- 役割設計: **第17章 17.0c** · CI/CD×AI: **第7章 7.0d**
- PoC設計: **第11章** · KPI: **第12章** · 禁止事項: **第13章**
- 読み方: `../index.html または ../ai_quality_research_html/index.html`

## 注意

- 公開スキル（skills.sh 等）は**本キットに含まない**。採用前に第13章・第19章のチェックを通すこと。
- 個人情報・接続情報・秘密鍵をプロンプトに入れない（`ai-quality-governance.mdc`）。