Excel方眼紙設計書のAIレビュー手法、Zenn記事が手順を解説

エンジニアコミュニティ「Zenn」で、Excel方眼紙で書かれた設計書をAIでレビューさせるためのMarkdown変換手法とプロンプトの解説記事が公開された。コピペ時に起きるレイアウト崩れを防ぎ、注記情報まで含めてAIに正確に渡す手順を示している。

セカンドデプロイ
・2分で読めます・AIが下書きし筆者が確認
方眼のグリッド線が整理されたテキストブロックへと変換されていく抽象的なイメージ
AI 生成画像(FLUX.1 [schnell])

この記事のポイント

  1. 01Excel方眼紙のセルをそのままコピーすると文字数の約7割がタブになり情報が欠落する問題を解説した。
  2. 02結合セルや縦結合を整理し、セルの外にある注記やコメントを別見出しとしてMarkdown化する条件を示した。
  3. 03HTMLコメントで元のセル番地を残し、AIが番地と引用を添えて指摘を出力できるプロンプト例を提示した。
目次
  1. 崩れる要因の整理とMarkdown変換の5要件
  2. 元の番地を保持して照合しやすくするプロンプト設計

エンジニアコミュニティ「Zenn」で、Excel方眼紙で書かれた設計書をAIでレビューさせるためのMarkdown変換手法とプロンプトの解説記事が公開された。ファイルの添付が制限された環境を想定し、セルのコピー&ペーストで発生する崩れを防ぎながら、AIへ正確に仕様を渡す手順を示している。

崩れる要因の整理とMarkdown変換の5要件

記事によると、Excel方眼紙のセルをそのままコピーしてチャット欄に貼り付けると、改行を除く文字数の約7割がタブで埋まり、貼り付け先で列の位置関係が消失するという。さらに、縦結合された区分の所属関係が消えるほか、テキストボックスやコメント(メモ)に書かれた注記が欠落し、非表示設定にした社内メモ行が意図せず含まれてしまう問題を挙げている。

flowchart TD
    A[Excel方眼紙の設計書] --> B[Markdownへの整形変換]
    B --> B1[結合セルを整理・重複排除]
    B --> B2[テキストボックスとコメントを別見出し化]
    B --> B3[HTMLコメントで元の番地を付与]
    B1 --> C[レビュー用プロンプト]
    B2 --> C
    B3 --> C
    C --> D[AIへ入力]
    D --> E[セル番地と原文引用付きの指摘表]

Excel方眼紙からMarkdown変換とプロンプト指定を経てAIレビュー結果を得る流れ

これらの問題を回避するため、記事はAIに渡すMarkdownの条件として次の5点を挙げている。

  • 結合セルは1つの値として1度だけ出力し、空セルや重複を作らない
  • 見出しと明細は表、項目と値の対は「キー: 値」、文章は文章として書き分ける
  • 縦結合されていた下の行には「〃」を入れて同一グループであることを明示する
  • 「」のようにHTMLコメントで元のシート番地を添える
  • テキストボックスやコメントなどのセル外情報は別見出しに分け、番地を付与する

元の番地を保持して照合しやすくするプロンプト設計

設計書の変換テキストをAIに読み込ませる際は、AI側が元のExcelの番地を把握できるよう、プロンプト冒頭でHTMLコメントの展開方法を指示する。表の左からn番目の列や上からm番目の行がどのアルファベットと行番号に対応するかをあらかじめ伝えておく。

指示文では、図形やテキストボックス、コメントも仕様の一部として読み込ませ、除外された非表示部分の内容は推測しないよう指定する。レビューの観点を「項目定義と処理の抜け・矛盾」「用語のゆれ」「未決事項の扱い」などに絞り、指摘結果には「セル番地」「根拠(原文の引用)」「重大度」「修正案」を表形式で出力させる。資料に根拠がない場合は「記載なし」と明記させ、推測と事実を分離して報告させる形式を定めている。

SOURCES 出典

本記事は AI を活用して作成し、筆者が確認のうえ公開しています。詳しくはAI 利用ポリシーをご覧ください。