work（work 搜索）

Work Skill

Plans.md のタスクを実装する主力スキル。スコープに応じて戦略を自動選択。

Philosophy

「聞いて、判断して、実行する」 1タスクなら直接実装。複数なら並列。大量なら自動反復。 ユーザーはスコープだけ決めれば、あとは自動。

Quick Reference

/work                    # スコープを聞いてから実行
/work 3                  # タスク3だけ即実行
/work all                # 全タスクを即実行
/work 3-6                # タスク3〜6を即実行
/work --codex            # Codex CLI で実装（スコープを聞く）
/work --codex all        # Codex CLI で全タスク即実行
/work --parallel 5       # 並列5ワーカーで実行
/work --no-commit        # 自動コミット抑制
/work --resume latest    # 前回セッション再開

Options

Scope Dialog (引数なし時)

引数なしで呼ぶと、対話でスコープを確認:

/work
どこまでやりますか?
1) 次のタスク (推奨): Plans.md の次の未完了タスク
2) 全部: 残りのタスクを全て完了
3) 指定: タスク番号や範囲を指定 (例: 3, 3-6)

> [Enter = 1]

引数ありなら即実行（対話スキップ）。

詳細: references/scope-dialog.md

Auto Strategy Selection

スコープに応じて、内部戦略を自動選択:

実行開始時に戦略を表示:

🔧 戦略: 直接実装 (タスク1件)
🔧 戦略: 並列 3 ワーカー (タスク3件)
🔧 戦略: 並列 3 ワーカー + 自動反復 (タスク8件, 最大10回)

ユーザーは戦略を意識する必要なし。

Default Flow

/work [scope]
    ↓
Phase 0: スコープ確認 (引数なしなら対話)
    ↓
Phase 1: 戦略選択 (タスク数で自動判断)
    ↓
Phase 2: 実装
    → 1タスク: 直接実装
    → 複数: task-worker サブエージェント並列
    → 全部/4+: 並列 + 反復ループ (完了まで自動)
    ↓
Phase 3: Review Loop (harness-review)
    → APPROVE: proceed
    → REQUEST_CHANGES: fix → re-review
    ↓
Phase 3.5: Auto-Refinement
    → Default: run /simplify (bundled)
    → --deep-simplify: run /simplify then code-simplifier agent
    → --no-simplify: skip
    ↓
Phase 4: Auto-commit (unless --no-commit)
    ↓
Tip 表示

Unified Memory Gate（必須）

/work 実行時は、以下の順序で Unified Harness Memory を必ず通す:

1. 実装前: harness_mem_resume_pack(project, session_id?, limit=5, include_private=false)
2. マイルストーン到達時（設計確定・大きな修正・方針転換）: harness_mem_record_checkpoint(session_id, title, content, tags?, privacy_tags?)
3. 実装完了時（handoff 前）: harness_mem_finalize_session(session_id, summary_mode="standard")

補足:

• session_id は $CLAUDE_SESSION_ID → .claude/state/session.json の .session_id の順で取得する
• harness_mem_sessions_list(project, limit=1) の先頭利用は read-only（resume確認）に限定し、record_checkpoint / finalize_session は明示 session_id が無い場合に失敗扱いとする
• Codex では notify hook（after_agent）とこの手順を併用し、記録漏れを抑える
• .codex/history.jsonl は daemon 側で自動インジェストされるため、手動追記不要
• いずれかが失敗した場合は harness_mem_health() と scripts/harness-memd doctor で状態確認し、復旧後に同ステップを再実行する

Auto-Iteration (4+ tasks or all)

大量タスク時は自動反復ロジックが有効化:

• 前回の失敗から自己学習
• 未完了タスクを次イテレーションで再試行
• 完了条件: 全タスク cc:done + ビルド成功 + テスト通過 + Review APPROVE
• 最大反復回数: --max-iterations (default: 10)

詳細: references/auto-iteration.md

--codex Engine

--codex フラグで Codex CLI にすべての実装を委託:

詳細: references/codex-engine.md

Feature Details

Smart Parallel Detection

Completion Tip

実行完了時に次のアクションを案内:

Done! 2 tasks completed. (3 remaining)
Tip: /breezing でチーム並列実行できます
Tip: --codex を付けると Codex に実装を委託できます

Session State

初期化

# work-active.json を作成
cat > .claude/state/work-active.json <<EOF
{
  "active": true,
  "started_at": "$(date -u +%Y-%m-%dT%H:%M:%SZ)",
  "strategy": "iteration",
  "codex_mode": false,
  "simplify_mode": "default",
  "bypass_guards": ["rm_rf", "git_push"],
  "allowed_rm_paths": ["node_modules", "dist", ".next", ".cache"],
  "review_status": "pending"
}
EOF

完了時クリア

rm -f .claude/state/work-active.json

Auto-invoke Skills

Project Configuration

Override defaults via .claude-code-harness.config.yaml:

work:
  auto_commit: false          # Disable auto-commit
  commit_on_pm_approve: true  # 2-Agent: defer commit until PM approves

VibeCoder Hints

Related Skills

• breezing - Agent Teams でチーム並列完走（Lead は指揮のみ）
• harness-review - コードレビュー（/work 内で自動起動）
• impl - 個別タスクの実装ロジック