• #Claude Code
  • #カスタムコマンド
  • #git
  • #Codexレビュー
  • #世界一周旅行
開発mdx-playgroundメモ

/commitカスタムコマンドと世界一周旅行記事

Claude Codeで /commit と打ったら「Unknown skill: commit」とエラーが返ってきた。ビルトインCLIコマンドでもスキルでもないので当然だが、コミット作業を毎回手動でやるのは面倒すぎる。カスタムコマンドを書いて解決し、ついでに世界一周旅行の記事をリサーチエージェント2本で並列生成した。

/commitカスタムコマンドの作成

「Unknown skill」エラーの正体

Claude Codeの Skill ツールは .claude/commands/ にあるMarkdownファイルをスキルとして読み込む。/commit は見た目からビルトインコマンドに見えるが、実際にはどこにも定義されていない。Skill(commit) を呼ぶと「Unknown skill」エラーで止まる。

解決は単純で、.claude/commands/commit.md にカスタムコマンドを置くだけ。

機能単位の分割コミット戦略

単に git add -A && git commit するのではなく、変更内容を分析して機能単位にグルーピングしてから順番にコミットする戦略にした。

## グルーピング規則(優先順位)

1. コード変更(apps/web/app/, server/, scripts/ 等)
2. コンテンツ記事(日付ディレクトリ単位、古い→新しい順)
3. 設定・ツール(.claude/, nuxt.config.ts 等)
4. 画像・SVG(関連記事と同じコミットに含める)
5. メモ(memo/ はユーザーに確認してから)

コミットメッセージはConventional Commits準拠(feat:, docs:, chore: 等)で日本語記述。

Codex(GPT-5.4)レビューで2件修正

計画をCodexに投げたら致命的な指摘が2件返ってきた。

#指摘内容修正
1ファイルパスがモノレポ構造を反映していないapp/apps/web/app/ に修正
2コミットメッセージ規約が未定義Conventional Commitsのtype一覧とフォーマットを追記

パス指摘は地味だが、実行時に git add が空振りする致命傷になるところだった。Codexがモノレポ構造をCLAUDE.mdから読み取って指摘してきたのは助かった。


世界一周旅行記事の並列リサーチ

リサーチエージェント2本を同時起動

円安環境下での学生向け世界一周旅行プランについて、2つのリサーチエージェントを並列で走らせた。

  • エージェントA: 費用・予算の調査(宿泊費、交通費、食費の地域別相場)
  • エージェントB: 安全ルートの調査(渡航危険度、現地治安、ビザ要件)

イラン戦争で中東ルートが消えた

リサーチで最大の発見は、2026年2月に始まったイラン戦争とホルムズ海峡危機で中東全域が事実上の通過不可になっていること。バックパッカーの定番だった「トルコ→イラン→インド」陸路ルートは使えない。アフリカ東岸経由やコーカサス迂回も検討したが、いずれも安全面でリスクが残る。

予算試算

ドミトリー前提、5大陸カバー6ヶ月で100〜135万円。東南アジア中心3〜4ヶ月の節約コースなら55〜75万円。ワーキングホリデーやWorkawayで途中の資金補充も組み込んだ。

Codex GPT-5.4レビューで3件指摘

#指摘内容対応
1エチオピア北部をルートに含めているが紛争リスクあり該当区間を削除
2Workawayはビザステータスに注意が必要注意書きを追記
3為替レートの前提が記事中で揺れている150〜159円のレンジに統一

2026-03-29の日記生成

make-diaryコマンドでclaude-code-syncログから03-29の日記を自動生成した。Chrome拡張の大規模リファクタリング(タブ再編、NFKC正規化によるルールID照合バグ修正、事業者設定エクスポート/インポート)が中心の一日だった。


試行錯誤

#テーマ試したこと結果
1/commitSkill(commit)で呼び出し「Unknown skill」エラー
2/commit.claude/commands/commit.md作成正常動作
3コミット計画app/パスでファイル指定Codexが「モノレポではapps/web/app/」と指摘
4リサーチエージェント1本で費用+ルート両方情報量が多すぎて途中で切れた
5リサーチ2本並列(費用/ルート分離)両方完走。結果をマージして記事化
6中東ルートトルコ→イラン→インド陸路イラン戦争で通過不可
7中東迂回コーカサス経由安全面でリスク残。記事では非推奨扱い

学び

  • カスタムコマンドは .claude/commands/{name}.md に置くだけで /name として呼べる。Skillツールの仕組みを理解すると、繰り返し作業を一発で自動化できる
  • Codexレビューはパス構造のような「動かしてみないと気づかない」ミスを事前に潰せる。特にモノレポでは相対パスの罠が多い
  • リサーチ系タスクは関心軸で分割して並列実行すると、1本で全部やるより完走率が上がる
  • 地政学リスクは旅行記事に限らず、サプライチェーンやSaaS選定でも同じ構造。「定番ルートが使えなくなる」前提で代替を用意しておく思考が染みついた