本ページは印刷・社内配布用の総合シート。詳細手順・プロンプト全文は各章を参照。
本章をマスタとして扱う。 KPI、スキル採否、導入順、ガバナンス判断は本章を正本にし、各章は詳細説明として参照する。数値・公開リポジトリ情報は提案前に確認日を更新する。
19.0 ファクトチェック・更新管理
| 項目 | 現在の扱い | 更新頻度 | 担当 | 注意 |
|---|---|---|---|---|
| 公開スキルのStars / Installs | 人気・活発度の参考値 | 提案前 | PoC担当 | 品質根拠として単独利用しない |
| DORA等の調査レポート | 背景仮説の補強 | 年次または提案前 | 品質担当 | 年度、調査対象、指標定義を確認する |
| PoC KPI | 導入判断の主根拠 | 週次 | PoC担当 | 母数、除外条件、測定方法を固定する |
| ガバナンスルール | 利用可否の判断基準 | ルール変更時 | 責任者 | 顧客・契約・社内規程と矛盾させない |
19.x Knowledge 索引 — マスタとの対応
本章(HTML)と ../notes/19_総評一覧.md を正本とし、以下の YAML 索引を半自動更新+人間レビューで維持する。PoC テーマは bonus_kit/reference/poc-theme-register.md と ID を同期。
| 本章の表 | 索引ファイル | 更新タイミング |
|---|---|---|
| 19.2 スキル一覧 | skills.yaml | 採否・導入指示変更時 |
| 19.3 活用施策 | practices.yaml · traceability.yaml | PoC テーマ追加時 |
| 19.4 PoC KPI | metrics.yaml | 週次実測(第12章) |
| 19.5 ガバナンス | risks.yaml · open_questions.yaml | ルール変更 · 未決発生時 |
索引だけ更新し
notes/ を更新しない運用は禁止。推測情報は confidence: low、未決は open_questions.yaml に残す。AI運用ログをPoC改善へ戻す
AI品質の良否を感想で終わらせず、Human Gateで止めた理由を週次KPIの補助ログとして記録する。 着想元は Qiita: AI運用ログを週次レビューし、FAQ・CRM・承認ルールへ戻すGAS実装。GASは必須ではなく、PoC初期は手動記録でよい。
Human Gate / AI利用 → 理由を4項目で記録 → 週次で分類・件数確認 → 改善候補を人間が選択 → Git正本 / ADR / rules / FAQ / 承認ルールへ反映 → 次週のログで効果確認
| 項目 | 用途 | 例 |
|---|---|---|
gate | どの確認点で止まったか | requirements / PR / release |
human_review_reason | 人間へ戻した理由の分類 | missing_context / low_confidence / approval_rule |
blocked_reason | 止まった事実を短く記録 | 対象外範囲が未確定 |
improvement_target | 改善候補 | REQ / FAQ / CRM / ADR / rule / template |
正本境界: ログと確定した改善はGit上のMarkdown/YAMLへ置く。スプレッドシートは一時集計に限り、顧客名・問い合わせ本文・機密情報を保存しない。
自動化条件: 最初の1〜2週間は手動。分類が安定してから集計だけを自動化する。改善チケットの自動起票や未入力による強制ブロックはPoC段階では行わない。
研修 — 判断マスタと NIST / ISO 対応(要約)
第19章の施策・KPI・中止条件は、次の外部枠組みにトレース可能であることを研修で確認する(詳細表は 第02章)。
| 本章の柱 | NIST 特性 | 測定の正本 |
|---|---|---|
| 19.3 活用施策 | Valid & Reliable | metrics.yaml · 第12章 |
| 19.4 PoC KPI | Valid & Reliable · Accountable | 週次テンプレ · $ai-poc-weekly-kpi |
| 19.5 ガバナンス | Secure · Accountable | risks.yaml · 第13章 |
| 19.5b 中止条件 | Valid(効果実証) | 効果不明 → 中止または再設計 |
19.1 総評
向いているレビュー・テスト・差分影響・設定確認・障害一次切り分け・事務照合など「提出前チェック」。人間が最終承認する副操縦士としての位置づけ。
向いていない完全自動開発、法務・給与・評価の自動判断、本番無承認変更、機密・個人情報の無マスク外部投入、電話の完全自動応答。
成功条件第12章指標+第13章ガバナンスをセット。効果が測れない用途は中止。公開スキルは監査・改変後に採用。
提案の3本柱(要約)
| 柱 | 内容 | 参照章 |
|---|---|---|
| 品質アンカー(Gram Anchoring的) | ADR/REQで判断構造を固定 · 5層運用 · 劣化防止 | 第2章 2.0b · 第7章 · dev_docs 第2章 |
| AI役割設計(ワークフロー) | 知識蒸留 · 10例 · 品質定義テンプレ · BTS記録 | 第17章 17.0c · 第1章 · dev_docs 第4章 |
| CI/CD × AI 協調 | 既存CIにAIを差し込み · BTS判断履歴 · 16事例 | 第7章 7.0d · 第6章 · dev_docs 第4章 |
| AIチケット起点開発ループ | 起票・品質確認・Handoff まで入口標準化 | 第3章 3.0c · 第10章 10.8 · dev_docs 第4章 |
| コーディング品質ツール選定 | SonarQube + Linter + Semgrep + CI品質ゲート(多層防御) | 第3章 3.8 · 第6章 · 第7章 · dev_docs_guide |
| PMO AIPC | ノウハウ蓄積 MCP Server(Hermes+Ollama)· 開発PC直置き非推奨 | 第20章 · 第17章 17.0a · 第9章 |
| Agent-native CI/CD | スキル/プロンプト bundle · eval ゲート | 第17章 17.0b · 第7章 |
| 品質ゲート向けAI役割分担 | PoC検証例(実装≠レビュー) | 第17章 17.0 · 第11章 |
| 柱1:工程内品質ゲート | 設計・実装・テスト・レビュー・インフラ手順の提出前にAIチェック | 第2章、第3〜9章 |
| 柱2:標準プロンプト+スキル | 都度プロンプトからGit管理スキルへ。導入は指示プロンプトまで(本資料) | 第10章、第17章、本シート19.2 |
| 柱3:測定とガバナンス | KPIで継続判断。禁止事項・マスキング・承認フローを先に定義 | 第12章、第13章、19.4 |
一言で社内説明:「AIで書かせる」より「AIで抜け漏れを減らす」。生成物は必ず人間が採否・承認する。
19.2 スキル一覧マスタ(公開+社内)
導入コマンドと導入用指示プロンプトのみ記載。SKILL.mdの作成・改変手順はPoC成功後に別途。
19.2.1 開発・品質(公開)
| スキル | 分類 | Installs | 主用途 | メリット | デメリット・注意 | 導入コマンド | 導入用指示(PoC担当者へ) |
|---|---|---|---|---|---|---|---|
| test-driven-development | 開発 | 127K | テスト先行実装 | AIの動きそう実装をテストで縛れる | レガシー初期コスト、手順が厳格 | npx skills add https://github.com/obra/superpowers --skill test-driven-development | 保守チケット1件に限定。実装前に失敗テスト→人間採否。第3章P-1 KPI計測。テストなしコードは削除ルールをチーム合意 |
| requesting-code-review | レビュー | 128K | PR前一次レビュー | 人間レビュー前の品質向上 | ドメイン判断は人間必須、トークン増 | npx skills add https://github.com/obra/superpowers --skill requesting-code-review | PRテンプレにAI利用欄追加。Critical/Important採否を記録。第6章R-1指標と連動 |
| systematic-debugging | 障害 | 143K | 根本原因調査 | 症状パッチ抑制、再発テストまで | 緊急復旧時は手順短縮要、ログ必須 | npx skills add https://github.com/obra/superpowers --skill systematic-debugging | 再現環境+ログを投入。3回失敗で設計見直し。本番は復旧優先を別途明文化 |
| webapp-testing | QA | 95K | Playwright E2E | E2E下書き、公式メンテ | Python前提、CI組込は人間 | npx skills add https://github.com/anthropics/skills --skill webapp-testing | 中機能1件でE2E下書き→QA採否→CI追加可否判断。第5章Q-1と併用 |
| supabase-postgres-best-practices | DB | 231K | SQL・RLSレビュー | 誤SQL対比例、設計観点表 | Postgres特化、社内命名は追記要 | npx skills add https://github.com/supabase/agent-skills --skill supabase-postgres-best-practices | 設計書1章+DDLを投入。性能はEXPLAIN人間確認。Oracle/SQL Server案件は別ルール |
| incremental-implementation | 開発 | — | 増分実装 | 本番品質の切り方が明文化 | スキル多、PoCは2〜3本に絞る | npx skills add https://github.com/addyosmani/agent-skills --skill incremental-implementation | 新機能1本をスライス分割。各スライスでレビュー・テスト完了をゲート化 |
| vercel-react-best-practices | フロント | 301K | React性能69ルール | 再レンダー・バンドル観点 | React/Next特化 | skills.shで vercel-labs から選択 | 性能チケット1件に適用。計測結果(Lighthouse等)とセットで採否 |
| skill-creator | 運用 | 高 | 社内スキル作成 | 標準スキルのテスト・配布 | 最初から全工程SKILL化は不要 | npx skills add https://github.com/anthropics/skills --skill skill-creator | PoC成功したプロンプト1本のみSKILL化候補に。第17章B系と併用 |
19.2.2 インフラ(公開)
| スキル | Installs | 主用途 | メリット | デメリット | 導入用指示 |
|---|---|---|---|---|---|
| terraform-best-practices | 203+ | IaCレビュー | 37ルールで観点標準化 | Stars少、Terramate視点 | IaC PR1件+checkov/tflint必須。planレビュー時間記録(I-1)。本番applyは変更管理 |
| azure-validate / azure-deploy | 387K/388K | Azureデプロイ前後 | validate→deploy順序固定 | Azure特化、計画書必須 | 非本番環境のみPoC。deployment-plan作成→validate通過→人間承認→deploy |
| systematic-debugging | 143K | 障害切り分け | ログ調査の型 | 緊急時は短縮 | 第9章9.9プロンプトと併用。模擬障害1回(I-3 KPI) |
インフラスキルは監査官・レビュアー限定。VMware-AIops等の操作系は読取・下書きのみ(第9.15)。
19.2.3 事務・エンゲージメント
| スキル | 分類 | Installs | 主用途 | メリット | デメリット・注意 | 導入 | 導入用指示 |
|---|---|---|---|---|---|---|---|
| xlsx | 公開 | 110K | 勤怠・台帳 | 式エラー検出 | 機密は閉域・マスク | npx skills add https://github.com/anthropics/skills --skill xlsx | マスク済CSV×Excelで第18.4照合。給与判断・客先自動送信禁止 |
| pdf / docx | 公開 | 134K/125K | 契約・稟議 | 抽出・編集の標準実装 | 法判断不可 | anthropics/skills から各skill | テンプレ1種。抽出結果は人間確認。外部送信前に必須チェック |
| copywriting | 公開 | — | 社内周知 | トーン統一 | 禁句は社内ルール追記 | skills.sh検索 | 経費・周知文案。禁句表(18.11)でセルフチェック後に人間確定 |
| summarize-meeting | 公開 | — | 議事録構造化 | 決定・宿題抽出 | 内容は人間確認 | skills.sh検索 | 会議後トランスクリプト→決定/宿題/未決分離。顧客向けは必ず編集 |
| attendance-worklog-reconciliation | 社内PoC | — | 勤怠照合 | 締め前不整合検出 | マスク必須 | プロンプト+xlsx | 第18.2.3指示。A-1 KPI(差戻し8→3件/月等) |
| phone-intake-assistant | 社内PoC | — | 電話取次 | 聞き漏れ・文案 | 自動発信禁止 | プロンプトのみ | 第18.5.3指示。層1(受付支援)から。PH-1 KPI |
| engagement-initiative-drafter | 社内PoC | — | 意識調査施策 | 能動性を促す言い回し | 人事が最終決定 | プロンプトのみ | 匿名サーベイサマリー→施策3案→禁句チェック→1案確定。E-1 KPI |
19.2.4 社内PoCスキル(受託・品質ゲート)
| 名称 | 向く工程 | メリット | デメリット | 導入用指示 |
|---|---|---|---|---|
| 要件定義ゲート | 要件レビュー・見積前 | 曖昧語・BLOCKER抽出、MODE別レビュー | 合意索引・用語集が無いと推測リスク | 要件1章をMODE-Bでレビュー。顧客確認事項と内部修正を分離記録。S-1 KPI |
| 意味逸脱監査 | 版間・AI要約検証 | 勝手な確定・条件消失を検出 | 比較元2版以上必要 | 旧版+新版を投入。主張強度・責任主体・スコープ差分を一覧→人間判定 |
| 議事録・可読化 | PM/資料管理 | 議事録・Markdown同期の再現性 | パス・機密ルール要整備 | 1会議分でPREP→FINALIZE試行。客先資料は変換ルール+マスク確認 |
19.3 活用施策一覧(職種×章)
| 領域 | 施策 | 主スキル/手段 | 参照章 | PoC事例ID |
|---|---|---|---|---|
| プログラマ | PR前セルフレビュー+TDD | TDD, requesting-code-review | 第3章 | P-1 |
| SE | 要件章単位AIレビュー | 要件定義ゲート | 第4章 | S-1 |
| QA | テスト観点生成+E2E下書き | webapp-testing, 第10章 | 第5章 | Q-1 |
| コードレビュー | AI一次+人間仕様確認 | requesting-code-review | 第6章 | R-1 |
| DevSecOps | SAST説明+修正案+再スキャン | 第7章プロンプト | 第7章 | D-1 |
| PM/PL | 週次品質会議たたき台 | 議事録スキル, 第8章 | 第8章 | M-1 |
| インフラ | IaC PR+手順書+障害切り分け | terraform-best-practices, systematic-debugging | 第9章, 11.3 | I-1〜I-3 |
| 事務 | 勤怠照合・電話取次・経費・議事録 | xlsx, docx, 社内プロンプト | 第18章 | A-1, PH-1, X-1 |
| 人事 | パルス連動施策文案 | engagement-initiative-drafter | 第18章 | E-1 |
19.4 PoC KPI一覧(Before → After 統合)
数値はすべてPoC想定・匿名。実測後に差し替え。
| ID | 領域 | 指標 | Before | After | 出典 |
|---|---|---|---|---|---|
| P-1 | 開発 | 人間レビュー重大指摘/PR | 2.1件 | 0.8件 | 第3章 |
| P-1 | 開発 | 単体テスト追加/チケット | 0.5本 | 2.3本 | 第3章 |
| S-1 | SE | 顧客追加指摘/章 | 18件 | 9件 | 第4章 |
| S-1 | SE | 製造後仕様確認チケット/月 | 12件 | 5件 | 第4章 |
| Q-1 | QA | テスト観点数(中機能) | 28件 | 47件 | 第5章 |
| Q-1 | QA | 観点漏れ系バグ/四半期 | 4件 | 1件 | 第5章 |
| R-1 | レビュー | 人間レビュー時間/PR | 45分 | 28分 | 第6章 |
| R-1 | レビュー | AI指摘採用率 | — | 54% | 第6章 |
| D-1 | Sec | High修正リードタイム中央値 | 4.2日 | 2.1日 | 第7章 |
| M-1 | PM | 週次品質資料作成 | 3h/週 | 1.5h/週 | 第8章 |
| I-1 | インフラ | 本番前設定ミス/月 | 2件 | 0件 | 第9章, 11.3 |
| I-1 | インフラ | planレビュー時間/PR | 45分 | 25分 | 第9章, 11.3 |
| I-2 | インフラ | 手順漏れ/四半期 | 3件 | 0件 | 第9章, 11.3 |
| I-3 | インフラ | 障害一次切り分け中央値 | 90分 | 45分 | 第9章, 11.3 |
| A-1 | 事務 | 勤怠締め後差戻し/月 | 8件 | 3件 | 第18章 |
| A-1 | 事務 | 照合工数/月 | 6h | 2.5h | 第18章 |
| PH-1 | 事務 | 電話伝言不備折返し/週 | 5件 | 1件 | 第18章 |
| X-1 | 事務 | 経費差戻し率 | 18% | 7% | 第18章 |
| E-1 | 人事 | 「参加したい」5段階 | 2.8 | 3.1 | 第18章 |
19.4b KPI測定定義
| 指標 | 測定方法 | 母数 | 達成判定 | 信頼度 |
|---|---|---|---|---|
| レビュー時間 | PRまたは文書レビュー開始から完了までの実作業時間を記録 | PoC対象PR / 文書 | 中央値で20%以上短縮 | 高 |
| AI指摘採用率 | AI指摘のうち、人間が妥当として修正・確認に使った件数 | AI指摘全件 | 40%以上を目安 | 中 |
| 手戻り件数 | レビュー後の再修正、差戻し、障害起因の修正を分類 | PoC対象成果物 | ベースライン比で減少 | 中 |
| 設定ミス / 手順漏れ | レビューで検出した本番影響候補と実発生を分けて記録 | 対象作業・IaC PR | 実発生0、検出記録あり | 高 |
| 利用者負担 | 週次アンケートと自由記述で「役に立った / 邪魔だった」を記録 | PoC参加者 | 継続利用可が過半 | 中 |
19.5 導入優先順位(推奨)
| 段階 | 対象 | スキル/施策 | 期間目安 |
|---|---|---|---|
| 0 | 全員 | AI利用ガイド、第10章プロンプト、採否記録 | Week 1-2 |
| 1 | 開発 | requesting-code-review または PRセルフレビュー | Week 3-4 |
| 2 | 開発 | test-driven-development(1機能限定) | Month 2 |
| 2 | SE/PM | 要件定義ゲート、意味逸脱監査 | Month 2 |
| 2 | インフラ | terraform-best-practices + checkov + I-1 KPI | Month 2 |
| 3 | 事務 | xlsx + 勤怠照合(A-1) | Month 2-3 |
| 3 | QA | webapp-testing + 観点生成 | Month 2-3 |
| 4 | 人事 | engagement文案(E-1、禁句必須) | Month 3 |
| 判定 | 全PoC | 第11.5報告、継続/限定/中止(第15章反映) | Month 3末 |
19.5b PoC中止・縮小条件
| 条件 | 判断 | 次アクション |
|---|---|---|
| AI指摘採用率が2週間連続で20%未満 | 対象または使い方が不適合 | 対象を絞る、プロンプトを修正、または停止 |
| 品質指標が悪化する | 導入リスクが効果を上回る | AI出力の利用範囲をセルフチェックに限定 |
| 機密・個人情報の投入統制ができない | ガバナンス不成立 | 当該テーマを停止し、第13章ルールを整備 |
| KPIの母数が取れない | 評価不能 | ログ・記録様式を先に整備 |
19.6 ガバナンス要点
19.6b RACI / 承認マトリクス
| 判断対象 | 実行 | 承認責任 | 相談 | 共有 |
|---|---|---|---|---|
| PoCテーマ採用 | PoC担当 | 部門責任者 | 品質・セキュリティ担当 | 参加者 |
| 公開スキル採用 | 技術リード | PoC責任者 | セキュリティ担当 | 利用チーム |
| 顧客提出物へのAI利用 | 担当者 | 案件責任者 | レビューア | 顧客窓口 |
| 人事・エンゲージメント利用 | 担当部門 | 部門責任者 | 人事・法務・情報システム | 対象者 |
19.6c 公開スキル採用前チェック
- 実行内容、外部通信、ファイル操作、認証情報参照を確認する。
- ライセンス、更新日、依存ツール、メンテナ状況を記録する。
- Stars / Installsは人気指標として扱い、品質・安全性の根拠にしない。
- PoC中はバージョンを固定し、戻し方を決める。
- 公開スキルは監査・社内レビュー後に採用。インストール数≠安全。
- 機密・個人情報はマスク・閉域。勤怠・評価・給与の自動判断禁止。
- インフラ・本番変更は人間承認+既存変更管理。AIはplan/手順レビューまで。
- 電話は層1(メモ・聞き漏れチェック)から。折返し約束の自動確定禁止。
- 効果測定(19.4)が取れないスキルは限定継続または中止。
- 詳細:第13章、事務:第18章 18.13