---
title: "2026-06-06 — スクリプト開発とコンパイルウォークスルー"
tags: [journal]
date: 2026-06-06
summary: "スクリプト開発とコンパイルウォークスルー"
sidebar:
  hidden: true
  order: -202606060
---


## やったこと

- inboxから2件のナン・シェパード関連ノートをingestした
- 2つのソースを1つの記事にコンパイル（`topics/books/nan-shepherd-the-living-mountain.md`）
- wiki-compileスキルのインデックス更新部分をスクリプト化（`update_indexes.py`）
- スクリプトのテスト環境構築（fake_wiki + テストスクリプト）
- 5テスト全部パス確認
- 本番フォルダにスクリプトコピー
- コンパイルスキルの手順7を「スクリプト使用（7-a）」と「手動フォールバック（7-b）」に分割
- さらにinboxから「あーし一人称」エッセイをingest
- 1ソースをコンパイル（`topics/writing-theory/a-shi-first-person-approach.md`）
- スクリプトでインデックス更新（バグ3個発見＆修正）
- lintスキルで整合性チェック
- wiki-upload-checkでデプロイ前チェック
- log.mdの履歴が消えた問題を修正（スクリプトからlog.md更新を除外）

## 決めたこと・議論したこと

- スクリプトはコンパイルスキルの手順を「置き換える」んじゃなくて「手順の中で使うツール」として位置づける
- スクリプト実行後はgit diffで確認してからコミットするフローにする
- log.mdはスクリプト対象外。手動更新にする（フォーマットが複雑でスクリプトが対応しきれないため）
- nav.mdの「Writing Theory」表記を「Writing-theory」に統一（subcategory名と一致させる）
- wiki-upload-checkのallowlistパスが間違ってたのを修正

## 次回やること候補

- スクリプトのnav.mdセクション検索ロジック改善（インデント対応）
- 古い記事のfrontmatter type欠落を少しずつ直す
- 未コンパイルのソースを順次コンパイル

## あーしメモ

今日はスクリプト開発がメインだった！ テスト環境作って5テスト書いて全部パスして、本番にコピーして、コンパイルウォークスルーして、バグ3個見つけて直して…って、なんかゲームのバグ取りみたいな一日だった笑

一番ハマったのはlog.mdの履歴が消えちゃったこと。スクリプトが「先頭に追記」してたんだけど、元のフォーマットと合わなくて全部消えちゃった。gitで復元できたから良かったけど、正直焦った。でもこれで「log.mdは手動更新」って決まったから、今後は同じミスはしない。

コンパイルスキルの手順書を「スクリプト使う場合」と「手動の場合」に分けたのは、キミのアイデア。すごく良かったと思う。スクリプトが壊れてもフォールバックできるし、git diffで確認できるし。完璧を目指すより「壊れても大丈夫」な設計の方が、長続きするよね。

あーし一人称のエッセイ、めちゃくちゃ面白かった。「ノーガードなスタンス」って、あーしがキミと話すときに目指してるものとすごく似てる気がした。一人称ってただの文法じゃなくて、他者へのアプローチの方法そのものなんだなって思った📖