AI品質安定化を運用に落とすには、テンプレート化が重要である。ここでは、PRテンプレート、インフラ変更申請、PoC報告テンプレートをまとめる。
14.0b 同梱キット(フォルダ配布)
| フォルダ | 内容 | 使いどころ |
|---|---|---|
| bonus_kit | Cursor ルール2本 + スキル8本(本番級ゲート含む)+ PR/KPI 様式 | おまけ・その日から使える |
| starter_kit | PoC試行のたたき台(軽量) | 第11章の初期試行 |
bonus_kit スキル一覧
| スキル | 呼び出し |
|---|---|
| PR前品質レビュー | $ai-quality-pr-review |
| 週次 PoC KPI | $ai-poc-weekly-kpi |
| 要件定義ゲート(本番) | $requirements-definition-gate |
| 意味逸脱監査(本番) | $requirements-semantic-drift-audit |
| 軽量ゲート / drift / PR / トレーサ | $dev-docs-gate-lite 他 |
bonus_kit は PoC・レビュー用。正本 SSOT の全社展開は PoC 継続判定後に dev_docs_guide を参照。
14.4 AIチケット起点開発ループ — テンプレート
14.4.1 起票用チケット本文
## 背景 / 目的 / 現状 / 期待する状態 ## 対象ユーザー / 対象画面・機能 / 対応内容 ## 受入条件(チェックリスト) ## 非対象範囲 / 影響範囲 / テスト観点 / リスク ## 関連資料 / 実装前に確認すべきこと
14.4.2 チケット品質判定
判定: A / B / C / D 判定理由 / 不足情報 / 実装前の質問 / 推奨アクション
14.4.3 実装 Handoff
対象チケット / 目的 / 採用方針 変更対象 / 変更してよい範囲 / 変更してはいけない範囲 受入条件 / 実装手順 / テスト方針 / 参考実装 / 禁止事項 / 完了報告形式
PRテンプレ(14.1)の「関連チケット」「AI利用」と併用。Handoff は別セッション・別エージェントへ渡す圧縮版。
14.1 PRテンプレート
## 概要
このPRで対応した内容を記載する。
## 関連チケット
- #xxxx
## 変更内容
-
## 影響範囲
- 画面:
- API:
- DB:
- バッチ:
- 帳票:
- 外部IF:
## AI利用
- なし / あり
### AIを利用した内容
- 仕様要約
- 実装案比較
- コード生成
- テスト生成
- セルフレビュー
- その他:
## AI出力に対して人間が確認した内容
- [ ] 仕様との整合
- [ ] 既存処理への影響
- [ ] 例外処理
- [ ] 権限・認可
- [ ] セキュリティ
- [ ] 単体テスト
- [ ] 回帰影響
- [ ] ログ・運用
## テスト結果
- [ ] 単体テスト
- [ ] 結合テスト
- [ ] 回帰テスト
- [ ] 手動確認
## レビュアーに見てほしい点
-
14.2 インフラ変更申請テンプレート
## 変更概要
- 対象環境:
- 対象サーバ / リソース:
- 変更目的:
## 変更内容
-
## 影響範囲
- 利用者影響:
- 停止有無:
- 関連システム:
- 通信影響:
- 監視影響:
## AI利用
- なし / あり
### AIを利用した範囲
- [ ] 手順書作成
- [ ] 設定レビュー
- [ ] IaC生成
- [ ] IaCレビュー
- [ ] ログ調査
- [ ] 障害原因候補整理
- [ ] 報告書作成
## 人間が確認した内容
- [ ] 設定値
- [ ] 権限
- [ ] FW / SG
- [ ] バックアップ
- [ ] 切り戻し手順
- [ ] 監視
- [ ] セキュリティ
- [ ] コスト
- [ ] terraform plan / dry-run
- [ ] 検証環境での確認
## 事前確認
- [ ] バックアップ取得
- [ ] スナップショット取得
- [ ] 空き容量確認
- [ ] 接続確認
- [ ] 監視抑止確認
- [ ] 関係者通知
## 作業手順
1.
2.
## 確認手順
1.
2.
## 切り戻し手順
1.
2.
## 完了条件
-
14.3 AI利用チェックシート
| 確認項目 | チェック |
|---|---|
| AI利用範囲を明記したか | □ |
| 機密情報を投入していないか | □ |
| AI出力を人間が確認したか | □ |
| テスト・スキャンを実行したか | □ |
| AI指摘の採否を記録したか | □ |
| リスクがある変更は承認を得たか | □ |
| 切り戻し手順を用意したか | □ |
| 作業証跡を残したか | □ |