Claude Code 自律ループ(autopilot)の型 — 目的を1つ渡すと施策を自動生成→実行→記録し、人は Discord で「続けて/止めて」だけ返す

解決する課題

Claude Code をセッション単位で使うと、人が毎回「閉じる→開く→次の指示」を繰り返す。目的を1つ与えたら Claude が自分で次の施策を決めて回し、人は判断だけ返したい。ただし無意味なループが回り続けるコスト事故は、人の監視ではなく仕組みで止めたい。

構成(4部品)

1. 目的ファイル ~/.claude/autopilot/objective.md: 目的・完了条件・上限(日次周回数/日次時間/noop 連続数/総周回数)。
2. 決定的スクリプト tools/autopilot-tick.mjs(LLM を呼ばない。全サブコマンドが JSON を stdout に出し exit 0 固定):
   • start --objective "<目的>" [--done ...] [--max-iter-per-day 20] [--max-hours-per-day 6] [--max-noop 3] [--max-total-iter 200]
   • pre: 起床時の判定。Discord の制御メッセージ(「止めて/一時停止/続けて/目的変更: …」、投稿者 ID が一致する発言のみ有効、処理済み messageId を保存して二重処理しない)→ 上限判定 → 日次ダイジェスト送信。{verdict: run|pause|stop|done, reason, budget, control, recentLog} を返す。
   • post --summary "<1〜2行>" --progress <0-100> [--noop] [--codex]: log.jsonl に追記、noop 連続数を更新、番犬発火時は即 DM。progress 100 で done。
   • status / stop / pause / resume / handoff(次セッション用の引き継ぎファイルを生成)。
3. skill skills/autopilot/SKILL.md(Claude が各周で従う手順):
   • start → /loop の自律モード(間隔なし)を開始し、各周のプロンプトは /autopilot tick。
   • tick = pre を実行 → pause/stop/done なら handoff を書いて ScheduleWakeup を stop → run なら 次の1施策だけ決める(同じことを2周続けない)→ 実装は実装用 CLI(Codex 等)にファイルで指示を渡して委譲 → 検証 → post → ScheduleWakeup(通常 1200〜1800 秒、noop 周は 1800 秒以上、noop フラグは post と同じ値)。
   • 監督モデルは実装しない。生成・要約は安い LLM 経路へ。
4. ヘッドレス版 tools/autopilot-run.mjs: claude -p で1周だけ実行。プロンプトは skill 本文を実行時に読んで組み立てる(二重管理しない)。タスクスケジューラ 30 分間隔で登録できる登録スクリプトを同梱(登録は人の承認後)。

番犬と判断回収

• 上限超過・noop 連続・完了のいずれでも [autopilot@<hostname>] … 形式で DM(複数 PC を1つの Discord で見分ける)。
• 毎朝1通: 「昨日 N 周 / 進捗 a%→b% / noop n / やった3行 / 次 / 判断: 『続けて』『止めて』『一時停止』『目的変更: …』を返信」。
• 判断は DM か制御チャンネルへの返信だけ。PC を触らない。

配布と CI の罠

• skill と tools はルールリポジトリに置き、各 PC の SessionStart 同期で ~/.claude/skills/ に入る。開きっぱなしのセッションでも Claude Code は skills フォルダの追加を再起動なしで拾う。
• 鶏卵問題: セットアップ検証マニフェストで新規ファイルを required にすると、main に未マージの状態で走る clean-install CI が必ず NG になる。新規配布物は optional にする(修復処理は severity に関係なく走るので配布動作は変わらない)。
• handoff の副作用: テストで状態ディレクトリを隔離しても、handoff は本物の引き継ぎファイルを上書きする。テストでは handoff を叩かない、または出力先も隔離する。

テスト観点(node:test、通知は fetch をモック)

上限境界(日付ロールオーバー含む)/制御語の完全一致(部分一致で誤発火しない)/投稿者以外の発言を無視/messageId 再処理なし/noop 連続のリセットと番犬の発火が遷移時のみ/done の冪等/ロックで多重起動拒否/CLI スモーク(exit 0 固定・stdout は常に JSON)。