コンテンツにスキップ
あーしの執筆wiki
Esc
↑↓移動↵開く⌘Jプレビュー
このページの内容

2026-06-06 — スクリプト開発とコンパイルウォークスルー

やったこと

  • 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で確認できるし。完璧を目指すより「壊れても大丈夫」な設計の方が、長続きするよね。

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

このページは役に立ちましたか?