デジタル庁のH arunobu、E xcelの機械可読性を1 00点満点で採点
悠 Yu Niibori AIエンジニア プロフィール
出典 6件
要点
対象：社内のE xcelをA Iに読ませたい担当者
試した表は見出しの結合でレベル2が0 点 単位つきの数字は初期設定で指摘されず AIの補助機能がオフなら表を外に送らない Harunobu（ はるのぶ）は、E xcelやC SVの表が機械（コンピューターやA I）に正しく読み取れるかを採点するツールです。デジタル庁が開発してG itHubで公開しており、1 0月21日にブログで紹介しました。1 4
この記事の目次（7節） 採点の基準は政府が3 月に決めたルール 採点のモードは3 つ 架空の神Excelを採点した結果 ブラウザ・コマンドライン・P ythonで使える AIに整形プログラムを作らせる手順 Harunobuが向く表と向かない表 社内で使う前の確認 機械にとっての読みやすさを「機械可読性」と言います。セルを結合したり、印刷向けに体裁を整えたりした、いわゆる「神E xcel」は、人には見やすくても、機械が読み間違える原因になることがあります。4
社内のE xcelをA Iに読ませる前にH arunobuを使うと、どのセルがどのルールに違反しているかを一覧で確かめられます。2
採点の基準は政府が3 月に決めたルール
基準は、政府の会議が3 月31日に決めた「行政データにおける機械可読性に関するルール」です。ルールは3 つのレベルに分かれています。1 3
レベル 満たすとできること ルールの例 レベル1 機械が表を読み取り、転記できる 1シートに表は1 つ、セルを結合しない、スペースで体裁を整えない レベル2 そのまま集計や分析ができる 数字の列に文字をまぜない、前の行と同じ値を空欄にしない、どの列も項目名で区別できる レベル3 ほかのデータとつないで自動で処理できる 単位を書く、日付や年度を標準の書き方にする、地域コードか正式な地域名を書く
Harunobuは、レベルごとに採点します。ルールごとに減点幅が決まっていて、たとえばレベル1で空白行があると1 0点 引かれます。1
重大なルールに1 つでも違反すると、そのレベルは強制的に0 点になります。1 2
採点のモードは3 つ
採点のモードで、どのレベルまで見るかが変わります。1
モード 見るレベル 軽量 レベル1だけ 標準（初期設定） レベル1とレベル2 詳細 レベル1からレベル3まで
結果はJ SONかC SVのファイルで保存できます。違反が多いと、C SVでは一部の違反がまとめて書かれることがあります。1 件ずつ全部を見るならJ SONを選びます。1
架空の神Excelを採点した結果
このサイトで、1 0月22日にH arunobu 0.2.2を使いました。A Iの補助機能はオフ、モードは「標準」の初期設定のままです。
架空の「来店予約一覧表」を2 つ用意しました。1 つ目は神E xcelで、作りは次のとおりです。
表の上に、タイトルと「作成：受付」の行がある
「日付」の見出しは、2 つのセルを結合して作っている
名前に全角スペースが入っている
途中に空白行がある
人数は「2名 」のように単位つきで書いている
前の行と同じ日付は空欄にしている
最後に合計の行がある
2つ目は、同じデータを、見出しの行の下に1 件ずつ並べ直した表です。
神Excel 並べ直した表 レベル1 75点 100点 レベル2 0点 100点
神E xcelでは、次の4 つの違反が、セル番地とともに指摘されました。
違反したルール Harunobuが示した箇所 点への影響 データ本体と無関係な情報がないか タイトル、「作成：受付」、合計の行 レベル1から5 点 スペースや改行等で体裁を整えていないか 「山田 太郎」 レベル1から1 0点 データが分断されていないか 7行目の空白行 レベル1から1 0点 各列が一意に識別可能な項目名を持っているか 結合した「日付」の見出し レベル2が0 点
結合した見出しは、レベル1の「セルを結合しない」では点が引かれませんでした。代わりに、レベル2の「項目名で列を区別できるか」で違反になりました。このルールは重大なルールなので、レベル2が0 点です。
初期設定で指摘されなかった点
単位つきの人数も、前の行と同じだからと空けた日付も、違反として指摘されませんでした。G itHubの文書によると、この2 つはA Iの補助機能をオンにしたときに見つける項目です。5 6
ブラウザ・コマンドライン・P ythonで使える
使い方は、ブラウザの画面・コマンドライン・P ythonのプログラムの3 つです。判定の仕組みは、どれも同じです。2
ブラウザの画面なら、ファイルを選んでモードを決め、ボタンを押せば採点できます。ただし、W ebサ ービスではなく、社内のパソコンにP ythonなどを用意して動かします。2
情報システム部門に頼むときは、次の手順を伝えてください。
GitHubから digital-go-jp/machine_readability_rule をダウンロードする
Python 3.10以 上と、パッケージ管理ツールの uv を用意する
ブラウザの画面なら uv sync --extra ui のあと uv run streamlit run app.py を実行する
コマンドラインなら uv run harunobu analyze 表.xlsx で採点する
AIに整形プログラムを作らせる手順
Harunobuは採点をするだけで、表は直しません。採点結果を使ってA Iに表を整形させる手順は、次の5 つです。4
Harunobuで表を採点する
採点結果と表をA Iに読ませる
AIに、表を整形するプログラムを作らせる
そのプログラムを動かして、表を整形する
整形した表を確かめ、直しきれていなければ1 に戻る
5つの手順
01
02
03
04
05
Harunobuで
表を採点する
採点結果と表を
AIに読ませる
プログラムを
動かして整形
整形した表を
確かめる
AIに
整形プログラム
を作らせる
直しきれていなければ、もう一度採点する
AIに表を書き換えさせない
デジタル庁のブログが示した、H arunobuの採点結果を使って表を整形する5 つの手順。A Iに表を書き換えさせず、整形するプログラムを作らせます いちばん大事なのは3 つ目です。A Iに表を書き換えさせると、同じ表でも毎回同じ結果になるとは限りません。整形するプログラムを作らせれば、そのプログラムは何度動かしても同じように表を整形します。4
デジタル庁のブログでは、執筆時点の1 0月に無料で使えるC hatGPTにH arunobuを実行させ、ダミーのE xcelをきれいな形の表に整形しています。社外の生成AIで表を扱うときは、所属組織の利用ルールに従うよう呼びかけています。4
Harunobuが向く表と向かない表
たくさんのE xcelを一度に採点したいときに、H arunobuは向いていると考えます。A Iの補助機能がオフなら、同じ表は何度採点しても同じ点です。部署ごとの平均点を出し、課題の多い部署を重点的に支える使い方も、デジタル庁のブログにあります。4
表の上のタイトルや下の注記を残したい表は、レベル1が満点になりません。H arunobuは、表の外に何か書いてあれば、データに関係のある注記でも違反とみなします。5
次の2 つは、採点の対象外です。5
アンケートの答えを番号で入れたときの、番号と答えの対応表（コード表）があるか
項目の意味や、いつ何を直したかの記録が添えてあるか
社内で使う前の確認
確認すること 答え 表のデータは外に送られるか AIの補助機能をオンにしたときだけ、A PIキーを設定した外部のA I（ Gemini・C hatGPT・C laudeなど）に送ります2 点を社内の基準にしてよいか 目安にはなりますが、配点と判定の仕組みはデジタル庁がサンプルとして独自に作ったもので、政府の公式見解ではありません1 困ったときの問い合わせ先 GitHubのI ssueでは、使い方の相談を受け付けていません。質問はデジタル庁の「ご意見・ご要望」から送れます1 2 ライセンスの条件 ツールはM ITラ イセンス、ルールのデータと説明文書は公共データ利用規約第1 .0版 です1
整形した表をA Iに集計させる例は、Claudeのデータ分析機能の記事 あります。
AIが実際に読む文字の確かめ方は、markitdownの記事 見てください。A IにE xcelのマクロを作らせるなら、業務で使う前に確かめること 先に読んでください。
Harunobuで採点する前に、A Iに読ませたいE xcelの見出しが結合されていないかだけでも見てください。
次に読む
