2. エンドツーエンド手順

IBM i / AS400 解析・リバース — 最良の手順と手法(匿名化公開用)

版 2026-07-22 · 対外公開用 · プロンプト+実践知見+用語集

対外公開版(匿名化済み) — 顧客名・案件名・固有ライブラリ/パス/プログラム名は一般化しています。用語は青点線にマウスオーバーで定義を表示。巻末「用語集」も参照。

推奨パイプライン(2026-07 改訂)

A. 棚卸し(Phase1)
   Cursor: analysis_output / bob_context(CALL閉包単位)
   Bob: 機能調査レポート(証跡必須)
   Codex: 反映漏れ・件数・確度査読

B. 精度上げ(Phase2・手元で回せる分)
   1) promote_partial_to_confirmed.py … 列パーサ+DDS+DSPPGMREF注記
   2) enrich_section51_wireframes.py … 画面ASCIIワイヤー
   3) generate_html_reports.py … 共有HTML
   4) rebuild_crud_from_bob_context.py … CRUD図
   5) build_as400_table_definitions.py … テーブル定義書
   6) link_crud_to_table_defs.py … CRUD→定義書リンク

C. 実機で穴埋め(Phase2後半)
   DSPDBR / DSPPGMREF鮮度 / DSPFFD不足 / 代表機能の開ファイル / JOBD LIBL

D. 影響調査利用(Phase3)
   技術UNRESOLVED解消または明示条件化
   Codex重大指摘0
   人間が「利用可」判定
手戻りを減らすコツ: 成果物フォーマット(レポート章立て)は変えない。 変えるのは抽出器・突合・再生成スクリプト側。 顧客向けの見栄えより、根拠行と確度の一貫性を守る。

標準ディレクトリ

06_IBM_i情報/
  SRC/ … 正本ソース
  SRC/analysis_output_*/03_bob_input/ … bob_context
  レポート/ … 機能調査レポート.md + html/
  CRUD図/ … CRUD一覧.md/html/xlsx
  テーブル定義書/ … md/html + _file_index.json
  OBJ情報/ … DSPOBJD / DSPPGMREF / DSPFFD
  IBM_i解析_手順資料一式/ … 本資料

BATCH運用

項目推奨
Bobバッチ1〜5件。400件一括は禁止
キュー06_progress/_bob_report_queue.txt(Excel連動)
査読バッチごとにCodex。重大指摘が残るうちは横展開しない
昇格バッチpromote はバックアップ付き。F仕様のみはPARTIAL維持

よく使うコマンド(Windows / 共有フォルダ)

cd C:\WORK\ibm-i-analysis
python tools/promote_partial_to_confirmed.py --tag colparse_pgmref
python tools/enrich_section51_wireframes.py
python tools/generate_html_reports.py
python tools/rebuild_crud_from_bob_context.py
python tools/build_as400_table_definitions.py
python tools/link_crud_to_table_defs.py

最終運用README(原文)

IBM i 移行解析 — AS400解析 最終プロンプト

> 最終更新: 2026-07-02

> 目的: Cursor / Bob / Codex の役割を分離し、AS400 / IBM i ソース解析結果を影響調査資料として安全に扱うための最終運用プロンプト。

> 基本方針: AIの自然文出力を正本にせず、Cursorの中間ファイル・正本SRC・Codex査読で機械的に担保する。


04_AS400解析_最終運用README

1. 最終結論

AS400 / IBM i の400件超の現行ソース解析では、Bob単体に調査・レポート・判定を任せない。

最終運用は以下とする。

Cursor: 機械抽出・中間ファイル・CALL閉包context生成
Bob: 中間ファイルを根拠にした業務向けレポート生成
Codex: 第三者査読・反映漏れ・件数差分・確度違反チェック
人間: 最終判断・顧客確認・技術深掘り優先順位決定

2. 重要な判定分離

今後は必ず以下を分けて判定する。

判定軸意味
レポート生成手順の横展開可否CursorBobCodexの手順を他PGMにも展開してよいか
個別レポートの影響調査利用可否そのPGMのレポートを移行判断・影響調査資料として使ってよいか

例:

手順: 条件付き手順横展開可
個別PGM: 影響調査利用不可
理由: 技術UNRESOLVED 27件が残っているため

3. フェーズ設計

Phase 1: 棚卸し・未決事項の可視化

目的:400件超を対象に、CALL閉包file_usagecoverage・未決事項を漏れなく表に出す。

許容:

禁止:

Phase 2: 重要PGMの技術深掘り

対象:

目的:CRUD未確認を根拠行付きでCONFIRMEDへ昇格する。

Phase 3: 影響調査資料として利用

条件:


4. ファイル構成

analysis_output_<timestamp>/
  00_raw_grep/
  01_index/
  02_graph/
  03_bob_input/
  04_bob_reports/
  05_codex_reviews/
  06_progress/

5. 標準実行順

1. Cursorで中間ファイル生成
2. CursorでPROGRAMごとのbob_contextをCALL閉包単位で生成
3. Excel から Bob キュー再生成(06_progress/rebuild_bob_report_queue.py)
4. BobでBATCH_SIZE 3〜5件ずつレポート生成(06_progress/_bob_report_queue.txt 先頭から)
5. CodexでBob出力を第三者査読
6. 指摘をCursor/Bobプロンプトへ反映
7. 重大指摘0件になるまで再試験
8. 手順横展開と個別利用可否を分けて判定

Bob キュー(Excel連動)

項目内容
正本SRC/analysis_output_<timestamp>/06_progress/_bob_report_queue.txt
未着手機能一覧 N列(機能ID)が灰色でない行
対象未着手かつ Z列=〇
並びExcel 上から昇順
再生成python rebuild_bob_report_queue.py(06_progress 内)

6. 進捗ステータス

未着手
Cursor抽出済み
Bob入力生成済み
Bobレポート生成済み
BobセルフチェックNG
Codex査読待ち
Codex査読NG
修正済み
人間確認済み
保留

7. 最低合格条件

手順横展開の最低条件

個別影響調査利用の最低条件


8. PGM001から得た教訓


9. 使うプロンプト

この3つをセットで使う。単独利用は禁止。

← 1. 全体像と判定原則3. プロンプト全文 — Cursor →