2026年3月30日の開発日記
朝5時台からChrome DevTools MCPでクラウド会計のAPIを叩き始め、夜まで拡張機能の機能実装に没頭した。仕訳登録→削除→復帰のフルサイクル検証から始まり、勘定科目エクスポート/インポート、未登録明細タブ、自動仕訳コマンド、証憑アップロードと、一日で5つの大きな機能を積み上げた。
今日やったこと
1. 会計ソフト仕訳APIフルサイクルテスト＋勘定科目エクスポート/インポート
仕訳登録（journalize）→削除（DELETE journals/{id}）→対象外解除（ignore_cancel）→未入力復帰の全サイクルをAPIで回せることを実証した。45件の一括登録を200ms間隔で流しても、レート制限に引っかからなかった。
仕訳更新API（PATCH update_new）をUIから操作してキャプチャし、複合仕訳の作成方法も解明。貸方を1行目に合計額集約でもAPIが受け入れることを実験で確認した。
勘定科目エクスポート/インポート機能も実装。事業者設定タブとHTML生成を共通コンポーネント化し、2カラムグリッドレイアウトを適用。会計ソフトCSVの""とSheetsの空文字の差異をtrim一行で解決した。
主な成果:
- 仕訳CRUD全操作のAPIエンドポイントと仕様を解明
- 勘定科目エクスポート/インポート＋補助科目削除の実装完了
- 共通コンポーネント化で3タブ（自動仕訳ルール・事業者設定・勘定科目）のUIを統一
詳細: 会計ソフト仕訳APIフルサイクルテストと勘定科目エクスポート/インポート機能の実装
2. 未登録明細タブ・自動仕訳コマンド・証憑アップロード
journalizing_suggestions APIで6サービス211件の未登録明細を一括取得。direction（出金/入金）と口座連動科目から借方/貸方を事前振り分けた複式簿記形式のインポートシートを設計した。デフォルト側セルにグレー背景を付けて、手入力箇所が一目で分かるようにした。
bulk_register APIを解析したが、ReactのuidとセッションCSRFに依存していて外部から呼べない。腹を括って1件ずつjournalize＋0.5秒ウェイトで実装。
自動仕訳コマンド（/mf-auto-journal）をPythonスクリプトで構築。複合仕訳対応で行挿入→行番号調整のロジックに行ずれバグが出たが、「ダウンロード→全行組み立て→バランス検証→一括書き込み」に再設計して根本解決した。
証憑アップロードはGoogle Drive→background.js→会計ソフトのcoffret APIで実現。
主な成果:
- 未登録明細のエクスポート/インポート実装（複式簿記形式）
- /mf-auto-journal、/mf-review-rulesスラッシュコマンド作成
- 証憑アップロード機能（Drive→会計ソフト添付）
- 勘定科目設定（データ連携）のエクスポート/インポートも追加
詳細: Chrome拡張 未登録明細タブ・自動仕訳コマンド・証憑アップロード
3. /commitカスタムコマンドと世界一周旅行記事
Claude Codeで/commitを呼ぶとSkillツールに誤ルーティングされてUnknown skillエラーが返る問題を、.claude/commands/commit.mdで解決。機能単位の分割コミット戦略をCodex（GPT-5.4）にレビューしてもらい、モノレポのパス問題を修正した。
円安環境下の世界一周旅行記事も2本のリサーチエージェントを並列で走らせて作成。イラン戦争でホルムズ海峡危機が起きており中東全域が通過不可という発見があった。
主な成果:
- /commitカスタムコマンドで機能単位分割コミットを自動化
- 世界一周旅行記事（10ヶ月100〜135万円の試算）
詳細: /commitカスタムコマンド作成と世界一周旅行記事の並列リサーチ
今日の試行錯誤
| # | テーマ | 試したこと | 結果 | 気づき |
|---|---|---|---|---|
| 1 | 仕訳登録API | UIからボタンクリックでネットワークリクエストをキャプチャ | 成功 | PATCHでなくDELETE + POST ignore_cancelが正しいフロー |
| 2 | 仕訳更新API | PUT で仕訳更新を試みる | 400エラー | 正解は PATCH /update_new。UIから実操作してキャプチャが確実 |
| 3 | 複合仕訳バランス | 各branchが自己バランス必須と仮定 | 誤り | 貸方を1行目に合計額集約でもAPIは受け入れる |
| 4 | bulk_register | 会計ソフト内部の一括登録APIを外部から呼ぶ | 失敗 | React内部状態のuidに依存しており再現困難 |
| 5 | diff正規化 | 会計ソフトCSVとSheetsの空文字の差異 | 87件が偽の変更扱い | ""と空文字をtrimで正規化して解決 |
| 6 | 行ずれバグ | 行挿入後のオフセット計算 | 行がずれる | 累積オフセット比較が誤り。全行組み立てに再設計 |
| 7 | 証憑アップロード | Chrome DevToolsから直接Google Driveにアクセス | CORSでブロック | 拡張機能のbackground.jsからなら問題なし |
| 8 | serviceName空 | URLのaccount_idパラメータで取得 | 空のまま | 正しいパラメータ名はaccount_id_hash%5D= |
今日の学び
- UIの操作をChrome DevToolsでキャプチャしてAPI仕様を逆引きするアプローチが最も確実
- 外部から呼べないAPI（React内部状態依存）は深追いせず、安定したAPIで迂回する判断が大事
- スプレッドシートの行挿入→行番号調整は壊れやすい。「全行をメモリ上で組み立てて一括書き込み」の方が決定論的
- Windows Git Bashのコマンドライン引数上限（約32,000文字）に注意。大きなJSONはバッチ分割で書き込む