はじめに
申請書・応募票・届出の書式など、「配られた Word や Excel の欄を埋めて送る」作業は開発の外にもたくさんあります。私は最近、この記入を AI エージェントに任せて人は確認だけする運用にしているのですが、一度 宣誓欄が 1 つ空いたまま提出してしまい、書類不備で受け付けてもらえませんでした。
本文は何度も読み返していたのに、表の右端にある小さな「生成AIの利用:」の欄だけ見落としていました。人の目も AI の目も「読む」ことには強い一方、「空いている所を探す」ことには弱いと痛感しました。
そこで、提出の直前に必ず流す空欄チェッカーを書きました。python-docx と openpyxl だけで、80 行ほどです。
何を「空欄」とみなすか
書式の空欄には、だいたい次の 3 つの形があります。
| 形 | 例 | 判定 |
|---|---|---|
| ラベルの後ろが空 | 生成AIの利用: |
全角・半角のコロンの後ろが空白や _ だけ |
| 表の右隣が空 | ` | 電話番号 |
| Excel の見出しの右が空 |
B3: メール / C3: 空 |
見出しセルの右 3 列が全部空 |
コードの中心は 1 本の正規表現です。
import re
BLANK = re.compile(r"[::]\s*[\s __]*$")
全角スペース と全角アンダーバー _ を入れておくのがポイントです。日本の書式は「氏名:____」のように下線で欄を描いていることが多く、半角だけ見ていると素通りします。
Word(docx): 段落と表を両方見る
from docx import Document
def check_docx(path):
d = Document(path)
hits = []
for i, p in enumerate(d.paragraphs):
t = p.text.strip()
# 長い文はコロンで終わる本文(「次のとおりです:」など)なので除く
if t and len(t) <= 40 and BLANK.search(t):
hits.append((f"段落{i}", t))
for ti, tbl in enumerate(d.tables):
for ri, row in enumerate(tbl.rows):
cells = [c.text.strip() for c in row.cells]
for ci, c in enumerate(cells):
if c and BLANK.search(c):
hits.append((f"表{ti}行{ri}", c))
if c and ci + 1 < len(cells) and cells[ci + 1] == "" and len(c) <= 20:
hits.append((f"表{ti}行{ri}", c + " →(右が空)"))
return hits
document.paragraphs には 表の中の文字が含まれません。応募票の大半は表なので、document.tables も必ず回します。また「40 字以下」「20 字以下」という長さの条件は、本文の文章を欄と誤認しないための足切りです。これが無いと「以下のとおり報告します:」のような本文が大量に引っかかります。
Excel(xlsx): 結合セルの右端から数える
import openpyxl
def check_xlsx(path):
wb = openpyxl.load_workbook(path)
hits = []
for ws in wb.worksheets:
merged = {(r.min_row, r.min_col): r.max_col for r in ws.merged_cells.ranges}
for row in ws.iter_rows():
for c in row:
v = c.value
if not (isinstance(v, str) and v.strip() and len(v) <= 20 and c.column < ws.max_column):
continue
left = ws.cell(row=c.row, column=c.column - 1).value if c.column > 1 else None
if left not in (None, ""):
continue # 左に文字があるセルは「値」の側
end = merged.get((c.row, c.column), c.column)
rights = [ws.cell(row=c.row, column=k).value
for k in range(end + 1, min(end + 4, ws.max_column + 1))]
if rights and all(x in (None, "") for x in rights) and not v.strip().startswith(("※", "(", "(")):
hits.append((f"{ws.title}!{c.coordinate}", v.strip() + " →(右が空)"))
return hits
Excel の書式は見出しが B3:D3 のように 結合セル になっていることがよくあります。単純に「右隣」を見ると結合の中の空セルを拾ってしまうので、merged_cells.ranges から結合の右端の列を引き、そこから右を見ます。「左に文字があるセルは値の側」という条件で、記入済みの値そのものを見出しと誤認するのも防いでいます。
任意の欄は「報告するが失敗にしない」
「※該当する場合のみ」「任意」の欄まで失敗にすると、毎回止まって使われなくなります。そこで別の正規表現で弱い扱いにしました。
SKIP = re.compile(r"(該当する場合|任意|※)")
...
soft = bool(SKIP.search(t))
print(f"[{'任意' if soft else '空欄'}] {f.name} {where}: {t}")
最後に空欄の数を出し、1 件でもあれば終了コード 1 で終えます。
$ python -I tools/blank_fields.py sample.docx sample.xlsx
[空欄] sample.docx 段落1: 生成AIの利用:
[空欄] sample.docx 表0行1: 電話番号 →(右が空)
[空欄] sample.xlsx Sheet!B3: メール →(右が空)
空欄 3 件
$ echo $?
1
終了コードで返すので、AI エージェントの手順書に「提出前に blank_fields.py を流し、空欄 0 件になるまで提出しない」と 1 行書くだけで、確認が仕組みになります。人が「ちゃんと見たか」を信じる必要がなくなりました。
はまった所
- パスワード付きの docx・xlsx は読めない: 提出用に暗号化したファイルは開けないので、例外をつかまえて「暗号化前のファイルを渡して」と表示するようにしました。
-
~$で始まるファイル: Word や Excel を開いている間にできるロックファイルです。フォルダごと渡すと拾ってしまうので、名前で除きます。 -
チェックボックス
□: 「□ はい □ いいえ」のどちらにも印が無い状態も空欄です。必要なら^[□\s はいいえ]+$のような判定を足すと拾えます。
まとめ
- 「読む」確認と「空いている所を探す」確認は別物。後者は機械に任せたほうが確実
- 日本の書式は全角コロン・全角スペース・全角アンダーバーまで見る
- Word は段落と表の両方、Excel は結合セルの右端から数える
- 終了コードで返して、人や AI の手順に組み込む
80 行の小さなスクリプトですが、これを入れてから同じ不備は一度も出ていません。書類を扱う作業がある方は、提出フォルダの前に一枚かませてみてください。