メインコンテンツへスキップ
見出し画像

Codexにアプリ作成を任せっきりにして失敗した|「動いたから完成」にしない5つの確認項目

    Codexにアプリを作ってもらい、画面が表示された時点で「完成した」と思っていませんか?

    自分も、Codexが作ったものを見て、

    「動いているなら問題ないだろう」

    と判断していました。

    しかし、Codexが作業を完了したことと、人間が安心して使える状態になったことは別です。

    Codexは、依頼した内容をもとに成果物を作ります。

    一方で、

    • どの情報を正しいものとして採用するか

    • 不足情報をどこまで許容するか

    • 誰の承認が必要か

    • 外部へ公開してよいか

    • 本番環境で使ってよいか

    を最終的に判断するのは人間です。

    今回は、Codexでアプリや資料を作ったあと、任せっきりにせず確認するためのワークフローを整理します。

    前回の記事では、Codex公式が紹介する、

    コンテキストを集める
    ↓
    目標を決める
    ↓
    出力を指定する
    ↓
    初稿を作る
    ↓
    レビューする
    ↓
    指示を改善する
    ↓
    うまくいったものを再利用する
    

    という流れを紹介しました。

    ▼続・【中級でつまづいた人のための】Codexで迷ったときに戻る、プロジェクト・推論・Skillsの基本

    今回の記事は、その中でも特に抜けやすい、「レビューする」工程を深掘りします。


    私が失敗したワークフロー

    以前の自分は、次のような流れでCodexを使っていました。

    作りたいものを伝える
    ↓
    Codexが実装する
    ↓
    画面を開く
    ↓
    動作していることを確認する
    ↓
    完成として使い始める
    

    確認していたのは、主に見た目と基本動作です。

    • 画面が開くか

    • ボタンが押せるか

    • エラーが表示されないか

    • 欲しかった機能があるか

    もちろん、これらも重要です。

    ただし、確認項目としては足りませんでした。

    たとえば、画面上は正常に見えていても、次のような問題が残っている可能性があります。

    • 古い資料を参考にしている

    • 仮の数値が残っている

    • 存在しない担当者を設定している

    • 日付を推測している

    • テスト用のデータを本番データとして表示している

    • 必要な権限確認が抜けている

    • 外部へ送信する処理が含まれている

    • エラー時の動作が確認されていない

    • 元のファイルを上書きしている

    • アクセスできなかった情報を無視している

    動いたことだけを確認しても、情報の正しさや運用上の安全性までは確認できません。


    改善後のワークフロー

    現在は、次のようにレビュー工程を入れています。

    目的と条件を伝える
    ↓
    Codexが初稿・試作版を作る
    ↓
    Codex自身に確認結果を報告させる
    ↓
    人間が資料・仕様・権限を確認する
    ↓
    修正内容をCodexへ戻す
    ↓
    再度テストする
    ↓
    人間が採用・公開を判断する
    ↓
    効果が確認できた手順だけ再利用する
    

    最初から完成品を作らせるのではありません。

    まずは、人間が確認するための試作版を作らせます。

    この考え方に変えてから、問題が起きたときも、

    「Codexが間違えた」

    で終わらず、

    「どの確認項目が不足していたのか」

    を考えられるようになりました。


    1.適切な情報源を使っているか

    最初に確認するのは、Codexが何を参考にして作ったかです。

    アプリ作成なら、次のような情報源があります。

    • 要件を書いたメモ

    • 既存のコード

    • 最新の商品データ

    • デザイン指示

    • 過去の会議メモ

    • スプレッドシート

    • APIの仕様書

    • 参考にしたウェブサイト

    • 前回作成したアプリ

    たとえば、商品情報を表示するアプリを作ったとします。

    画面の文章が自然でも、参考にした商品データが古ければ、正しい成果物とはいえません。

    Codexには、作業後に次のように質問します。

    今回の実装で参考にした情報源をすべて挙げてください。
    
    それぞれについて、次を説明してください。
    
    ・ファイル名または参照元
    ・どの部分で使用したか
    ・最新情報だと判断した理由
    ・アクセスできなかった情報
    ・内容が矛盾していた情報
    
    確認できなかった内容は、推測せず「要確認」としてください。
    

    重要なのは、Codexが資料を読んだかどうかだけではありません。

    必要な資料をすべて読めたかも確認します。


    参考資料が多いほど正確になるとは限らない

    関連しそうなファイルを大量に渡すと、精度が上がるように感じます。

    しかし、古い資料と新しい資料が混ざっている場合は、逆に判断が難しくなります。

    たとえば、

    商品情報_旧.xlsx
    商品情報_最新版.xlsx
    商品情報_修正版.xlsx
    商品情報_最終版.xlsx
    

    というファイルが並んでいたら、どれを採用すべきか判断しにくくなります。

    Codexが正しいものを選ぶとは限りません。

    そのため、資料を渡すときは、

    商品情報は「商品情報_2026年6月30日.xlsx」を最新版として使用してください。
    
    ほかの商品情報ファイルは比較用としてのみ確認し、数値の採用には使用しないでください。
    

    のように指定します。


    2.不足・不明・根拠のない内容がないか

    Codexが作った成果物は、文章としてきれいにまとまっていることがあります。

    そのため、不明な情報まで正しいように見えることがあります。

    たとえば、資料に日付が書かれていないのに、自然な日付が設定されている。

    担当者が決まっていないのに、過去の資料から担当者らしい人が選ばれている。

    目標数値がないのに、一般的な数値が入力されている。

    文章として自然でも、根拠がなければ確認が必要です。

    Codexには、次のように確認させます。

    今回作成した成果物について、根拠を確認できない内容をすべて挙げてください。
    
    以下を分けて報告してください。
    
    ・資料で確認できた事実
    ・資料から推測した内容
    ・一般的な知識から補った内容
    ・情報が不足している内容
    ・人間の判断が必要な内容
    
    推測した内容を、確定情報のように記載しないでください。
    

    この指示を入れると、完成品だけを見るより、確認すべき場所を見つけやすくなります。


    「情報がない」と書けることも品質の一部

    不足情報があると、つい埋めたくなります。

    しかし、実務では、

    分からないことを分からないまま示すこと

    も重要です。

    たとえば、

    担当者:要確認
    
    公開日:未決定
    
    使用するデータ:最新版を特定できず
    
    送信先:承認待ち
    

    と表示されていれば、人間は次に何を確認すべきか分かります。

    空欄を自然な情報で埋めるより、安全です。


    3.担当者・日付・決定事項・約束を作っていないか

    特に注意したいのが、次の4項目です。

    • 担当者

    • 日付

    • 決定事項

    • 約束

    これらは、文章の中に書かれているだけで、正式に決まった内容のように見えます。

    たとえば、Codexがプロジェクト概要に、

    田中さんが7月15日までに公開する
    

    と書いたとします。

    しかし、元資料には、

    田中さんへ相談予定
    公開時期は7月中を検討
    

    としか書かれていないかもしれません。

    この2つは意味が違います。

    前者は、担当者と期限が確定しています。

    後者は、まだ相談・検討段階です。

    Codexには、次の区別をさせます。

    担当者、期限、決定事項、約束について確認してください。
    
    各項目を、次の3つに分類してください。
    
    ・確定している
    ・提案または検討段階
    ・資料だけでは判断できない
    
    確定していると判断した項目には、根拠となる資料も記載してください。
    

    検討中の内容を、決定事項へ変えないことが重要です。


    4.読みやすくしながら、元の事実を維持できているか

    Codexは、文章や画面を分かりやすく整えることができます。

    しかし、読みやすくする過程で、意味が変わる可能性があります。

    たとえば、元資料に、

    テスト後、問題がなければ7月中の公開を検討する
    

    と書かれていたとします。

    これを短くして、

    7月中に公開する
    

    と書けば、読みやすくはなります。

    ただし、条件と検討段階であることが消えています。

    アプリの画面でも同じです。

    元データでは、

    効果には個人差があります
    

    と書かれているのに、画面上で、

    確実に効果があります
    

    へ変わっていたら、根本的な意味が変わっています。

    見た目や文章を改善するときは、次を確認します。

    • 条件が消えていないか

    • 注意事項が削られていないか

    • 未決定事項を断定していないか

    • 数値の単位が変わっていないか

    • 対象範囲が広がっていないか

    • 誰の発言か分からなくなっていないか


    コピペ用:事実を維持した改善指示

    読みやすさとデザインを改善してください。
    
    ただし、以下は変更しないでください。
    
    ・事実関係
    ・数値
    ・日付
    ・担当者
    ・決定状況
    ・条件
    ・注意事項
    ・対象範囲
    
    表現を短くすることで意味が変わる場合は、短縮しないでください。
    
    変更後、元の内容と意味が変わっていないか確認し、変更した箇所と理由を報告してください。
    

    5.送信・共有・公開前に承認が必要ではないか

    Codexは、外部ツールやアプリと接続すると、成果物を作るだけでなく、操作まで進められる場合があります。

    たとえば、

    • メールを送る

    • カレンダーへ予定を入れる

    • ファイルを更新する

    • ウェブサイトを公開する

    • SNSへ投稿する

    • スプレッドシートへデータを書き込む

    • GitHubへ変更を反映する

    といった作業です。

    便利ですが、作成と公開は別工程として考えます。

    自分は最初、下書きを作ってもらう作業と、実際に反映する作業を一緒に頼んでいました。

    現在は、次のように分けています。

    成果物を作る
    ↓
    人間が確認する
    ↓
    修正する
    ↓
    承認する
    ↓
    外部へ反映する
    

    最初の指示にも、次の制約を入れます。

    今回は確認用の下書きまで作成してください。
    
    次の操作は行わないでください。
    
    ・送信
    ・共有
    ・公開
    ・スケジュール設定
    ・本番環境への反映
    ・既存ファイルの上書き
    
    実行が必要な操作は、実行内容と影響範囲を説明し、私の承認を待ってください。
    

    Codexが作ったアプリを確認するチェックリスト

    アプリを作成・更新したあと、自分は次の順番で確認します。

    情報源

    • 必要な資料をすべて確認したか

    • 最新の資料を使用したか

    • アクセスできなかった資料はないか

    • 資料同士の矛盾を報告しているか

    • 参考にした情報源を説明できるか

    内容

    • 根拠のない情報を追加していないか

    • 不明な情報を推測していないか

    • 仮データが残っていないか

    • 数値や単位が正しいか

    • 必要な注意事項が残っているか

    担当者と日付

    • 担当者を勝手に決めていないか

    • 期限を推測していないか

    • 検討中の内容を決定事項にしていないか

    • 約束していない内容を約束として書いていないか

    動作

    • 想定した操作で動くか

    • 入力内容が間違っている場合も確認したか

    • 空欄の場合も動くか

    • エラー時の表示が分かりやすいか

    • 元の機能が壊れていないか

    外部への影響

    • メールを勝手に送らないか

    • 予定を勝手に追加・変更しないか

    • 本番データを上書きしないか

    • 外部へ公開しないか

    • 実行前に人間の承認を求めるか

    共有前の状態

    • 初めて見る人にも理解できるか

    • 機密情報が含まれていないか

    • テスト用の文言が残っていないか

    • 確認が必要な箇所が明記されているか

    • 公開してよい状態か、人間が判断したか


    コピペ用:Codexへレビューさせるテンプレート

    Codexが作業を終えたあと、次の指示を使います。

    今回作成・更新した成果物を、公開や共有の前にレビューしてください。
    
    # 1.使用した情報源
    
    ・使用したファイル、メモ、データ、ウェブ情報
    ・各情報源を使用した箇所
    ・アクセスできなかった情報
    ・内容が矛盾していた情報
    
    # 2.不足・不明・推測
    
    ・情報が不足している箇所
    ・不明な箇所
    ・推測して補った箇所
    ・根拠を確認できない箇所
    
    # 3.担当者・日付・決定事項
    
    ・担当者を確定した箇所
    ・日付や期限を設定した箇所
    ・決定事項として記載した箇所
    ・約束や確約として記載した箇所
    
    それぞれ、根拠となる資料を示してください。
    
    # 4.事実の維持
    
    ・表現やデザインを変えた箇所
    ・元の意味が変わっていないか
    ・条件、注意事項、対象範囲が維持されているか
    
    # 5.承認が必要な操作
    
    ・送信
    ・共有
    ・公開
    ・スケジュール設定
    ・本番環境への反映
    ・既存データの更新
    
    これらに該当する操作がある場合は、実行せず、承認待ちとして報告してください。
    
    # 6.最終報告
    
    以下に分けて報告してください。
    
    ・そのまま使用できる部分
    ・修正が必要な部分
    ・人間の確認が必要な部分
    ・今回確認できなかった部分
    
    レビューだけを行い、修正や公開は私の確認後に実施してください。
    

    良いワークフローは、レビューを成果物の近くに置く

    レビューは、作業がすべて終わったあとにまとめて行うものだと思っていました。

    ただ、工程が長くなるほど、最後にすべてを確認するのは難しくなります。

    たとえば、次のような作業です。

    データを読む
    ↓
    仕様を考える
    ↓
    コードを書く
    ↓
    画面を作る
    ↓
    外部サービスと連携する
    ↓
    公開する
    ↓
    最後に確認する
    

    公開直前に間違いを見つけると、どの工程から直すべきか分かりにくくなります。

    そのため、確認場所を作業の近くへ置きます。

    データを読む
    ↓
    使用したデータを確認する
    
    仕様を考える
    ↓
    完成条件と対象範囲を確認する
    
    コードを書く
    ↓
    変更内容とテスト結果を確認する
    
    外部と連携する
    ↓
    権限と実行範囲を確認する
    
    公開する
    ↓
    人間が最終承認する
    

    確認項目が明確なほど、ワークフローを再利用しやすくなります。


    Skillにする前に、レビュー項目も一緒に保存する

    同じワークフローを何度も使うようになったら、Skillとして保存できます。

    ただし、作業手順だけを保存すると、同じ失敗も繰り返します。

    たとえば、次のようなSkillです。

    資料を読む
    ↓
    プロジェクト概要を作る
    ↓
    Wordで保存する
    

    このSkillには、レビュー工程がありません。

    改善後は、次のようにします。

    資料を読む
    ↓
    使用した資料を報告する
    ↓
    不足情報を洗い出す
    ↓
    プロジェクト概要を作る
    ↓
    事実・担当者・日付を確認する
    ↓
    人間の承認を待つ
    ↓
    承認後にWordで保存する
    

    Skillには、何を作るかだけでなく、何を確認するかも含めます。


    コピペ用:レビュー付きSkillを作る指示

    今回確定したワークフローを、再利用可能なSkillとして整理してください。
    
    # 目的
    
    複数の資料から成果物を作成し、人間が安全に確認できる状態まで準備すること。
    
    # 必須工程
    
    1.使用可能な資料を確認する
    2.使用した情報源を報告する
    3.不足・不明・矛盾を洗い出す
    4.確認用の初稿を作る
    5.事実、担当者、日付、決定事項を確認する
    6.元の意味を維持できているか確認する
    7.送信・共有・公開に承認が必要か確認する
    8.人間のレビューを待つ
    9.承認後に修正または本番反映する
    
    # 禁止事項
    
    ・根拠のない情報を追加しない
    ・担当者や日付を推測しない
    ・検討事項を決定事項として扱わない
    ・人間の承認前に送信、公開、上書きしない
    ・アクセスできない情報を無視しない
    
    # 作業後の報告
    
    ・使用した情報源
    ・確認できた事実
    ・不足情報
    ・推測した可能性がある内容
    ・人間の承認が必要な操作
    ・残っているリスク
    
    作業を自動化するだけではなく、レビュー工程も必ずSkillに含めてください。
    

    おさらい:ツールが進化しても、基本の順番は変わらない

    Codexのモデルや機能は、今後も変わっていきます。

    画像生成。

    GoogleやSlackとの連携。

    Skills。

    MCP。

    自動化。

    複数エージェント。

    できることが増えるほど、任せられる範囲も広がります。

    ただし、基本の進め方は変わりません。

    コンテキストを集める
    ↓
    目標を決める
    ↓
    出力を具体的に示す
    ↓
    確認用の初稿を作る
    ↓
    慎重にレビューする
    ↓
    指示を改善する
    ↓
    うまくいったものを再利用する
    

    再利用する前に、少し立ち止まる。

    そのワークフローは、正しい情報を使っているか。

    不足情報を勝手に埋めていないか。

    誰かの承認を飛ばしていないか。

    共有してよい状態になっているか。

    ここを確認してから再利用します。


    初心者向けに一言でいうと

    Codexは、作業を代わりに進めてくれます。

    しかし、完成したものを信用してよいか判断するところまでは、人間の仕事です。

    動いたから完成。

    文章がきれいだから正しい。

    Codexが完了と言ったから確認不要。

    この考え方では、間違ったものを効率よく作る可能性があります。

    自動化する範囲が広がるほど、レビュー項目も具体的にする。

    これが、Codexを任せっきりにして失敗したあとに残った判断基準です。


    今回のメモ

    • Codexの完了報告は、人間による確認の開始地点

    • 動作確認だけでは、情報の正しさまでは分からない

    • どの情報源を使ったか報告させる

    • アクセスできなかった情報も確認する

    • 不足情報を推測で補わせない

    • 担当者、日付、決定事項、約束を作っていないか確認する

    • 読みやすくする過程で、元の意味を変えない

    • 送信、共有、公開、本番反映は別工程にする

    • 人間の承認前には実行させない

    • レビューを作業の最後ではなく、各工程の近くに置く

    • Skillには作業手順だけでなく、確認手順も入れる

    • レビュー済みのワークフローだけを再利用する


    次に読む記事

    Codex公式の基本ワークフローを確認したい方はこちらです。

    ▼【中級でつまづいた人のための】Codexは結局何者?迷ったときに戻る、プロジェクト・推論・Skillsの基本

    プロジェクトとSkillの違い、再利用できるワークフローの作り方はこちらです。

    ▼続・【中級でつまづいた人のための】Codexで迷ったときに戻る、プロジェクト・推論・Skillsの基本

    Codexが結局何をするものなのか、推論やプロジェクトの基本から確認したい方はこちらです。

    ▼codeX初心者メモ:仕事で使えるまでに覚えたこと全部残す

    この記事が参加している募集

     
     
    AIの活用事例や最新情報を、実際に使った活用事例、中級者でもつまづきそうになる点などを、日本一わかりやすくを目標に取り組んでいます。 【メインコンテンツ】 大規模言語モデル、ChatGPT、CodeX、画像生成、アプリ制作、デザインなど

    あなたへのおすすめ