#!/usr/bin/env python3"""罠の索引(Markdown の表)を点検する。1 行 = 症状 | 原因 | 直し方 | 正本。直し方が長い行は「理由まで索引に書き足した」印、正本が空・存在しないファイルを指す行は、索引だけが残って根拠が消えた印として止める。使い方: python3 trap_index_lint.py docs/trap_index.md --root . [--max-fix 60]"""import argparseimport reimport sysfrom pathlib import PathHEADER = ["症状", "原因", "直し方", "正本"]def rows(text): """表の行を (行番号, セルのリスト) で返す。見出し行と区切り行は飛ばす。""" for no, line in enumerate(text.splitlines(), 1): s = line.strip() if not (s.startswith("|") and s.endswith("|")): continue cells = [c.strip() for c in s.strip("|").split("|")] if cells == HEADER or all(re.fullmatch(r":?-{3,}:?", c) for c in cells): continue yield no, cellsdef main(): ap = argparse.ArgumentParser() ap.add_argument("index") ap.add_argument("--root", default=".", help="正本のパスを解決する起点") ap.add_argument("--max-fix", type=int, default=60, help="直し方の上限(字)") a = ap.parse_args() root = Path(a.root) problems, seen = [], {} for no, cells in rows(Path(a.index).read_text(encoding="utf-8")): if len(cells) != 4: problems.append(f"L{no}: 列が {len(cells)} 個(4 個のはず)") continue symptom, _cause, fix, source = cells if len(fix) > a.max_fix: problems.append(f"L{no}: 直し方が {len(fix)} 字。理由は正本へ移し、ここは 1 行に") if not source or source in {"—", "-"}: problems.append(f"L{no}: 正本が空(「{symptom[:20]}」)") else: # 「path §3-2」のような書き方を許す。パス部分だけ存在を確かめる path = source.strip("`").split(" ")[0].split("§")[0].strip("` ") if path and not (root / path).exists(): problems.append(f"L{no}: 正本 {path} が見つからない") if symptom in seen: problems.append(f"L{no}: 症状が L{seen[symptom]} と重複") seen.setdefault(symptom, no) for p in problems: print(p) print(f"{len(seen)} 行を点検・指摘 {len(problems)} 件") sys.exit(1 if problems else 0)if __name__ == "__main__": main()
#!/usr/bin/env python3"""複製した直後のリポジトリに、雛形の固有値が残っていないかを数える。固有値の一覧(1 行 1 語・# で始まる行は無視)を雛形側で持っておき、新しい側で走らせる。コメント行だけに残っているものは「意図して残した跡」として別に数え、失敗にはしない。使い方: python3 leftover_values.py template_values.txt app components lib public"""import reimport sysfrom pathlib import PathTEXT_EXT = {".ts", ".tsx", ".js", ".mjs", ".css", ".json", ".md", ".html", ".py", ".txt", ".toml"}COMMENT = re.compile(r"^\s*(//|#|/\*|\*|<!--)")def load_values(path): vals = [] for line in Path(path).read_text(encoding="utf-8").splitlines(): line = line.strip() if line and not line.startswith("#"): vals.append(line) return valsdef main(): if len(sys.argv) < 3: sys.exit(__doc__) values = load_values(sys.argv[1]) pat = re.compile("|".join(re.escape(v) for v in values), re.IGNORECASE) live, in_comment = [], 0 for top in sys.argv[2:]: for f in sorted(Path(top).rglob("*")): if not f.is_file() or f.suffix not in TEXT_EXT: continue try: lines = f.read_text(encoding="utf-8").splitlines() except UnicodeDecodeError: continue # 画像などの取り違えは飛ばす for no, line in enumerate(lines, 1): m = pat.search(line) if not m: continue if COMMENT.match(line): in_comment += 1 else: live.append(f"{f}:{no}: {m.group(0)} ← {line.strip()[:70]}") for x in live: print(x) print(f"残り {len(live)} 件(コメント内 {in_comment} 件は対象外)") sys.exit(1 if live else 0)if __name__ == "__main__": main()
計測の ID とフォームの送信先を残したまま試すと、こう出ます。二つを直してもう一度走らせると、コメントの一件だけを残して 0 件になります。
このスクリプトの価値は、置き換えそのものより「終わったと言える条件」を一つに決めてくれることにあります。エージェントに置き換えを頼むと、目についた所だけを直して「完了しました」と返ってくることがあります。私の側では、この出力が 0 件になったことをもって完了とし、それまでは次の作業に進まないことにしています。計測の ID が雛形のまま本番に出れば、新しいサイトの訪問が古いサイトの数字に混ざってしまいます。数字の混ざりは画面を見ても分からないので、機械に数えてもらうほうが確かなのです。
#!/usr/bin/env python3"""正本と写しのずれを確かめる(写しを直接直した事故を、次の作業の前に見つける)。mirrors.txt に「正本<TAB>写し」を 1 行ずつ。写しの先頭には「> 写し。正本は …」の注記を置く約束なので、その注記行だけを除いて本文を比べる。 python3 mirror_check.py mirrors.txt # ずれを報告(あれば exit 1) python3 mirror_check.py mirrors.txt --write # 正本から写しを作り直す"""import difflibimport sysfrom pathlib import PathNOTE_PREFIX = "> 写し。正本は "def body(text): return [l for l in text.splitlines() if not l.startswith(NOTE_PREFIX)]def main(): if len(sys.argv) < 2: sys.exit(__doc__) write = "--write" in sys.argv base = Path(sys.argv[1]).resolve().parent drift = 0 for raw in Path(sys.argv[1]).read_text(encoding="utf-8").splitlines(): if not raw.strip() or raw.startswith("#"): continue src_rel, dst_rel = raw.split("\t") src, dst = base / src_rel, base / dst_rel want = src.read_text(encoding="utf-8") if write: dst.parent.mkdir(parents=True, exist_ok=True) dst.write_text(f"{NOTE_PREFIX}`{src_rel}`(ここは直さない)\n{want}", encoding="utf-8") print(f"写した: {dst_rel}") continue if not dst.exists(): print(f"写しが無い: {dst_rel}") drift += 1 continue a, b = body(want), body(dst.read_text(encoding="utf-8")) if a != b: drift += 1 print(f"ずれ: {dst_rel}") for d in list(difflib.unified_diff(a, b, src_rel, dst_rel, lineterm="", n=0))[2:8]: print(" ", d) if not write: print("一致" if drift == 0 else f"{drift} 件ずれ") sys.exit(1 if drift else 0)if __name__ == "__main__": main()