テーブル変更の調査。
機能も画面も、AIが追って探す。

AIへの依頼例 · 架空の資料で試す

まずは、こう頼んでみる。

OmniGrepのプロファイル「顧客管理_設計書」を使い、顧客テーブルT_CUSTOMERへの項目追加について調査してください。まずT_CUSTOMERを使う機能を探し、見つかった機能名・機能IDで再検索して、その機能を使う画面と画面設計書までたどってください。内容読み取りを許可した資料の必要な箇所を確認し、テーブル→機能→画面の関係候補、各段階のファイル名・位置、未確認事項をチャットの調査サマリーにまとめてください。重複する語はまとめ、同じ関係を繰り返し追わないでください。調査範囲はこのプロファイル内の機能・画面までにしてください。最後に、見つかったテーブル名・機能ID・画面IDをOR検索にまとめ、generate_reportで検索根拠をMarkdownに出力してください。保存先はC:\Users\kuboken\Documents\OmniGrep\customer-impact-evidence.mdです。各検索の未完了・読み取り失敗・上限を確認し、改修対象や影響なしとは断定しないでください。件数が多い場合は続行方法を確認してください。

プロファイルと対象資料は、ご自身の環境に合わせてください。本文・表・コードを読ませる前に、対象ファイルと許可設定を確認します。

一度の依頼から、検索をつなぐ

見つかった名前が、次の検索語になる。

画面設計書にテーブル名がなくても、機能ID・画面IDを手掛かりにたどれます。以下は架空の設計書での例です。検索のたびにAIが結果を読み、次の語を選びます。

1. 1. テーブル名から、使う機能を探す

   AIがOmniGrepで検索する語

   T_CUSTOMER

   機能一覧.xlsxの記載から、F_CUST_SEARCH（顧客検索）とF_CUST_UPDATE（顧客更新）が候補に。

   次の検索へ：F_CUST_SEARCH OR F_CUST_UPDATE

2. 2. 見つかった機能IDで、呼出元を探す

   AIがOmniGrepで検索する語

   F_CUST_SEARCH OR F_CUST_UPDATE

   機能設計書の呼出元を確認。SCR_CUST_SEARCH（顧客検索画面）とSCR_CUST_EDIT（顧客編集画面）が候補に。

   次の検索へ：SCR_CUST_SEARCH OR SCR_CUST_EDIT

3. 3. 見つかった画面IDで、画面設計書を探す

   AIがOmniGrepで検索する語

   SCR_CUST_SEARCH OR SCR_CUST_EDIT

   顧客検索画面設計.xlsxと顧客編集画面設計.xlsxが候補に。現行版と該当位置を確認する。

   次の検索へ：各段階の出典をそろえて、レポートへ

AIが整理する、関係候補の一覧

名前の一致に加え、利用・呼出関係の記載を確認した候補です。各矢印の根拠を原本でレビューします。

レビューには、サマリーと検索根拠を。

AIの調査サマリー

関係候補・出典・未確認事項をチャットにまとめます。AIの解釈を含むため、元資料で確認します。

保存する検索根拠レポート（.md）

OmniGrepのgenerate_reportで、調査語の検索結果と出典を保存します。過去の検索履歴の自動統合や、依存関係の確定ではありません。

T_CUSTOMER OR F_CUST_SEARCH OR F_CUST_UPDATE OR SCR_CUST_SEARCH OR SCR_CUST_EDIT

C:\Users\kuboken\Documents\OmniGrep\customer-impact-evidence.md

SEARCH SCOPE

何を、どこまで探せるか。

HOW TO

検索から確認までの3ステップ。

1. 変更内容と調査のゴールを、一度に伝える

   対象プロファイル、テーブル名、変更内容、機能から画面まで追うこと、検索根拠レポートの保存先を伝えます。接続と読み取り許可を準備しておくと、同じ依頼の中で検索を進められます。

2. AIが結果を読み、次の検索語を選ぶ

   AIが件数と候補を確認し、許可された周辺から機能IDを拾います。機能IDで再検索して画面IDを見つけ、画面IDでも再検索。名称の一致だけで依存関係を確定せず、呼出関係が書かれた位置を残します。

3. 関係候補と検索根拠を、レビューに使える形へ

   AIがテーブル・機能・画面・出典・未確認事項を整理。調査で得た語をOR検索にまとめ、OmniGrepのgenerate_reportで検索根拠を.mdに保存します。レポートの完了状態と原本を確認して、改修対象を判断します。

TRY WITH YOUR FILES

まず、小さなフォルダで確かめる。

• テーブル名→機能ID→画面IDが記載された、小さなダミー設計書セットで試す。画面設計書にテーブル名がなくても、機能ID経由でたどれるか確認する。
• 各段階の検索語と、テーブル・機能・画面を結ぶ記載箇所が元資料と一致するか確認する。
• 同名の別機能や古い設計書を混ぜ、AIが名前の一致だけで関係を断定していないか確認する。
• 関係が書かれていない枝は「未確認」と残し、0件・読み取り失敗・結果上限を区別する。
• 保存した.mdを開き、検索語、出典、網羅性に関する注記と、指定した保存先を確認する。

利用前に知っておきたいこと。

• 連続検索の計画・次の検索語の選択・関係の解釈は接続先AIが担当します。OmniGrep自体が依存関係を自動解析する機能ではありません。文書に記載されていない関係は別の調査が必要です。
• generate_reportは指定した1つの検索クエリで再検索し、検索結果と出典をMarkdownにするツールです。過去の全検索履歴を自動統合したり、テーブル→機能→画面の依存関係を確定したりするものではありません。関係候補のサマリーはAIの回答として別に受け取ります。
• 一度の依頼を起点に進められますが、AIクライアントのツール承認、曖昧な名称、大量の結果、読み取り許可、保存先の不足などによって追加確認が必要になる場合があります。
• 完了状態は検索した対象とクエリについてのものです。completeでも、システム全体の影響を漏れなく調べた保証にはなりません。partial・aborted、抽出不完全、上限、読み取り失敗は未確認として残します。
• レポートの保存先はホームディレクトリ配下の絶対パスを指定します。プロファイルを超えた読み取り、DBへの接続、SQL実行、元資料の変更は行いません。
• MCPの結果・許可された本文はAIクライアントへ渡ります。クラウドAIのデータ取扱条件と組織のルールを確認してください。

通常検索はPC内で処理します。ライセンス認証の通信は別です。任意のAI連携では情報の送信範囲をMCPガイドでご確認ください。

よくある質問