autonomous-skill

自律スキル — 長時間タスクの実行

デュアルエージェントパターン（イニシャライザー＋エグゼキューター）を使用し、Codex の非対話モードでセッションを自動継続して、複数のセッションにわたる複雑な長時間タスクを実行します。

クイックスタート

自律タスクを管理するには、run-session.sh スクリプトを使用します。

# Start a new autonomous task
~/.codex/skills/autonomous-skill/scripts/run-session.sh "Build a REST API for todo app"

# Continue an existing task
~/.codex/skills/autonomous-skill/scripts/run-session.sh --task-name build-rest-api-todo --continue

# List all tasks and their progress
~/.codex/skills/autonomous-skill/scripts/run-session.sh --list

# Show help
~/.codex/skills/autonomous-skill/scripts/run-session.sh --help

Codex がデフォルトで有効な config.toml または選択中のプロファイルのモデルを使用するよう、実行スクリプトでは意図的に --model を指定していません。

ディレクトリ構成

すべてのタスクデータは、プロジェクトルートの .autonomous/<task-name>/ に保存されます。

project-root/
└── .autonomous/
    ├── build-rest-api/
    │   ├── task_list.md        # Master task checklist
    │   ├── progress.md         # Session-by-session notes
    │   ├── session.id          # Last Codex session ID for resumption
    │   └── session.log         # Codex stdout/stderr transcript with JSON events
    ├── refactor-auth/
    │   ├── task_list.md
    │   ├── progress.md
    │   └── session.id
    └── ...

これにより、競合を避けながら複数の自律タスクを並行して実行できます。

スクリプトのオプション

Usage:
  run-session.sh "task description"           Start new task (auto-generates name)
  run-session.sh --task-name <name> --continue Continue specific task
  run-session.sh --list                        List all tasks
  run-session.sh --help                        Show help

Options:
  --task-name <name>       Specify task name explicitly
  --continue, -c           Continue existing task
  --no-auto-continue       Don't auto-continue after session
  --max-sessions N         Limit to N sessions
  --list                   List all existing tasks
  --resume-last            Resume the most recent Codex session
  --network                Enable danger-full-access sandbox for tasks that need broader shell access

ワークフローの概要

User Request → Generate Task Name → Create .autonomous/<task-name>/ → Execute Codex Sessions
                                                                            ↓
                                                                    ┌───────────────┐
                                                                    │ task_list.md  │
                                                                    │ exists?       │
                                                                    └───────┬───────┘
                                                                            │
                                                    ┌───────────────────────┴───────────────────────┐
                                                    │ NO                                        YES │
                                                    ▼                                              ▼
                                            ┌───────────────┐                            ┌───────────────┐
                                            │  INITIALIZER  │                            │   EXECUTOR    │
                                            │  - Analyze    │                            │  - Read state │
                                            │  - Break down │                            │  - Next task  │
                                            │  - Create     │                            │  - Implement  │
                                            │    task_list  │                            │  - Mark done  │
                                            └───────────────┘                            └───────────────┘
                                                                            │
                                                                            ▼
                                                                    ┌───────────────┐
                                                                    │ All complete? │
                                                                    └───────┬───────┘
                                                                            │
                                                            ┌───────────────┴───────────────┐
                                                            │ NO                        YES │
                                                            ▼                              ▼
                                                    Auto-continue               Exit with success
                                                    (3 sec delay)

使用例

例 1：新しいタスクを開始する

~/.codex/skills/autonomous-skill/scripts/run-session.sh "Build a REST API for todo app"

出力：

ℹ Generated task name: build-rest-api-todo
==========================================
  SESSION 1 - build-rest-api-todo
==========================================

==========================================
  INITIALIZER SESSION
==========================================
Task: Build a REST API for todo app
Task Name: build-rest-api-todo
Task Directory: .autonomous/build-rest-api-todo

[Codex creates task_list.md with 25 tasks...]

✓ Initializer session complete
ℹ Session ID saved: 550e8400-e29b-41d4-a716-446655440000

=== Progress: 0/25 ===

Continuing in 3 seconds... (Press Ctrl+C to pause)

例 2：既存のタスクを続行する

~/.codex/skills/autonomous-skill/scripts/run-session.sh --task-name build-rest-api-todo --continue

例 3：セッションコンテキストを使用して再開する

# Resume the Codex session (preserves conversation context)
~/.codex/skills/autonomous-skill/scripts/run-session.sh --task-name build-rest-api-todo --continue --resume-last

例 4：すべてのタスクを一覧表示する

~/.codex/skills/autonomous-skill/scripts/run-session.sh --list

出力：

==========================================
  AUTONOMOUS TASKS
==========================================
  ✓ build-rest-api-todo (25/25 - 100% complete) [session: 550e8400...]
  ○ refactor-auth (12/30 - 40%) [session: 661f9511...]
  ? incomplete-task (no task_list.md)

例 5：ネットワークアクセスを有効にする

# Enable network access for tasks that need API calls
~/.codex/skills/autonomous-skill/scripts/run-session.sh --network "Fetch data from GitHub API and analyze"

主要ファイル

各タスクの .autonomous/<task-name>/ 内にあるファイル：

ファイル	用途
task_list.md	チェックボックスで進捗を管理するマスタータスクリスト
progress.md	セッションごとの進捗メモ
session.id	再開に使用する最後の Codex セッション ID
session.log	Codex セッションからの JSON Lines 形式の出力

重要な注意事項

1. タスクの分離：各タスクには専用のディレクトリがあり、競合しません
2. タスクの命名：説明から自動生成されます（小文字、ハイフン区切り、最大 30 文字）
3. タスクリストは厳守：タスクの説明は削除・変更せず、[x] を付けるだけにしてください
4. 1 セッションにつき 1 タスク：タスクを丁寧に完了させることに集中してください
5. 自動継続：セッションは 3 秒の遅延後に自動継続します。一時停止するには Ctrl+C を押します
6. セッションの再開：--resume-last を使用すると、Codex の会話コンテキストを保持できます
7. 設定済みモデル：実行スクリプトは --model を渡さず、有効な Codex 設定／プロファイルのモデルを使用します
8. ネットワークモード：--network を指定すると、承認ポリシーを非対話型に保ったまま、サンドボックスのオーバーライドが danger-full-access に切り替わります
9. Git の整理：ログのコミットを避けるため、.autonomous/ を .gitignore に追加することを検討してください

Codex CLI リファレンス

このスクリプトでは、内部で次の Codex コマンドを使用します。現在の CLI から on-request 承認が引き継がれて無人実行が停止しないよう、意図的に --full-auto ではなく設定のオーバーライドを使用しています。

# Non-interactive execution with file edits (fully autonomous)
# Uses the configured model from the active Codex config/profile
codex exec \
  -c 'approval_policy="never"' \
  -c 'sandbox_mode="workspace-write"' \
  --skip-git-repo-check \
  --json \
  "prompt"

# Resume previous session
codex exec resume \
  -c 'approval_policy="never"' \
  -c 'sandbox_mode="workspace-write"' \
  --skip-git-repo-check \
  --json \
  <SESSION_ID> \
  "prompt"

# Full access (file edits + shell network / unrestricted filesystem) - use with caution!
codex exec \
  -c 'approval_policy="never"' \
  -c 'sandbox_mode="danger-full-access"' \
  --skip-git-repo-check \
  --json \
  "prompt"

トラブルシューティング

問題	解決策
タスクが見つからない	--list を実行して既存のタスクを確認します
タスクが複数ある	--task-name でタスク名を指定します
セッションが停止している	タスクディレクトリ内の session.log を確認します
再起動が必要	タスクディレクトリを削除して、新しく開始します
再開に失敗した	session.id を削除して、新しいセッションを開始します
承認待ちで実行が一時停止した	更新後の実行スクリプトで -c approval_policy="never" のオーバーライドが使用されていることを確認します
Codex が見つからない	Codex CLI をインストールします：npm install -g @openai/codex