本文へスキップ

Business Technology02

Updated 2026.09.11

Guide

AIの「完成しました」を、何で確かめるか

CIは緑でした。ところが、そのテストが確認していたのは一つ前のコードでした。「成功」という表示は正しい。それでも今回の変更が正しい証拠にはなりません。

報告として申告された線と、実測された線が途中で食い違っていることを示す図版。

まず押さえること

完了は、AIの発言や一つのテスト結果では決まりません。何を変更したか、その証拠がどの版を確認したか、どの環境で実行したか、どの受入条件を満たしたかを結び付けます。証拠が古い、対象が違う、現場条件を見ていない場合は、成功表示があっても完了へ進めません。

緑のCIが、今回のコードを見ていなかった

AIから「修正完了。テストも成功しました」と報告が来る。画面には緑の印が並んでいる。普通なら、次は公開だと考えます。

しかし並行して変更が進む環境では、テストを開始した後に対象のブランチが更新されることがあります。成功した処理が見ていた版と、いま公開しようとしている版が違う。テスト結果は偽物ではありません。ただ、質問への答えがずれていました。

ここで問題は「AIが嘘をついたか」から、「その証拠は何を確認したのか」へ変わりました。

報告を、受入条件までたどり直す

報告を、受入条件へ照合する

発言から証拠へ戻り、その対象と環境を確認します。最後に条件ごとの成立を判断します。

  1. 1Claim何を完了したという報告か
  2. 2Evidence何を実行・観測した記録か
  3. 3Revisionいま判断する版と一致するか
  4. 4Environment必要な環境・経路を確認したか
  5. 5Acceptance受入条件がすべて成立したか
作業報告から確認根拠へ戻り、対象の版、環境、受入条件がつながっているかを確認します。

作業報告は、証拠ではなく索引として読む

「完成しました」は、AIの作業報告(Claim)です。役に立たないわけではありません。何を変え、何を試したつもりかを探す入口になります。ただし、その文章だけではコードも本番も変わりません。

確認根拠(Evidence)には、実行したテスト、対象のコミット、画面の観測、本番の応答、利用者による受入などがあります。大事なのは量ではなく対応関係です。別の版で成功した百件のテストより、今回の版と明示的につながった必要十分な証拠の方が強いことがあります。

同じ「成功」が答えている別の問い

確認分かることまだ分からないこと
コードレビュー・単体テスト処理や部品が意図どおりか本番構成で動くか
共有CI同じ手順で検証を再現できるか見た目や外部経路が正しいか
画面確認実際の表示と操作が成立するか本番データ・権限で成立するか
本番実証公開環境が今回の版を返すか現場の仕事を置き換えたか
現場受入実条件で業務を終えられるか将来も無故障であるか

表は横にスクロールできます。

証拠には賞味期限がある

コードが変われば、古いテスト結果はそのまま使えません。環境設定が変われば、本番確認も取り直す必要があります。受入条件が増えれば、以前の画面確認では不足します。証拠が古くなる条件を決めておかないと、記録が増えるほど誤認しやすくなります。

Developer Hubでは、作業報告と確認根拠を分け、根拠がどの対象へ結び付くかから状態を計算する考え方を採っています。これは「ダッシュボードが完了と言えば正しい」という意味ではありません。入力された根拠が古ければ、計算結果も古いままです。

独立した確認役は、同じ報告を言い換えない

確認役へ「問題ないですよね」と聞けば、元の結論を追認しやすくなります。変更の目的、差分、受入条件を渡し、作業者の自己評価とは別に、壊れ得る場所を探してもらいます。UIなら実際の画面、公開なら配信された版、業務なら代表例と例外を見ます。

軽い文言修正に全社受入は不要です。反対に、データ統合や権限変更を単体テストだけで受け入れることもできません。確認の重さは、AIを信用する度合いではなく、変更の影響と戻しやすさに比例させます。

完了を決める短い問い

完了を決める短い問い

「何が終わったのか」「どの版を確認したのか」「どの環境で見たのか」「誰の受入条件を満たしたのか」。四つがつながらないとき、足りないのは報告の丁寧さではなく、完了を支える根拠です。

テストは、成功したかではなく、何を見たかを読む

CIの緑は便利です。ただ、緑という一色の表示には多くの違いが隠れます。単体テストが通ったのか、公開用の成果物を作れたのか、実際の画面が狭い幅でも読めるのか、公開先が今回の版を返したのか。それぞれは別の問いに答えています。全部を一つの成功表示として受け取ると、どこまで確認できたかが逆に見えなくなります。

特にAIが複数の変更を並行で作ると、確認結果と対象の版がずれやすくなります。テストを開始した後に別の変更が入り、結果だけを見ると成功している。あるいは、ローカルでは正しく見えたが、公開環境では設定やデータの違いで成り立たない。これはAI固有の失敗ではなく、変更と確認の対応を曖昧にしたときに起きる問題です。

そのため作業報告は、完了宣言ではなく確認への入口として扱います。何を変えたのか、どの版に対する結果か、どの環境で見たか、何がまだ未確認かをたどれるなら、報告は役に立ちます。たどれないなら、文章が丁寧でも証拠にはなりません。

確認を重くするのは、不信感ではなく影響の大きさ

文言を一行直す変更と、顧客データの統合や公開経路を変える変更を、同じ確認で受け入れる必要はありません。前者は差分、画面、リンクを確認できれば足りる場合があります。後者は、戻した場合に何が残るか、既存の記録を壊さないか、実際の利用条件で次の仕事まで進むかを見なければなりません。

ピース・ビズ グループでは、実装、テスト、本番確認、現場受入を別に扱う設計を進めています。ここで重要なのは、段階が多いことではありません。本番へ公開できたという事実は、公開できたことの証拠です。それだけで現場の仕事が置き換わった証拠にはなりません。逆に現場が使えたとしても、どの版で確認したかが分からなければ、次の変更へ安全に引き継げません。

AIの報告を信用するかどうかというより、何を受け入れようとしているかを先に決めます。対象、証拠、環境、受入条件が結び付いたときに初めて、完了という言葉に具体的な意味が生まれます。

Guide

この記事について

進め方と判断の順序を整理した記事です。

First-hand experience

ピース・ビズ グループのCIで行った確認対象の版の照合、業務基盤の検証状態、Developer Hubの作業報告・確認根拠・完了計算の設計と実装を扱います。仕組みの存在を、すべての案件が受入済みという意味にはしていません。

参照した一次情報

Published
2026.09.03
Updated
2026.09.11
Published by
Peace Biz

業務とテクノロジーのトピックに戻る

このテーマで公開している記事の一覧をご覧いただけます。