AI 原生开放教材

外观

Claude Code Harness工程手册·中英混排原文 ↗原件 ↓仓库 ↗

機能詳細 ​

Task tool メトリクス ​

サブエージェントが消費したトークン数・ツール呼び出し数・実行時間を集計できる。 parallel-workflows スキルでは複数サブエージェントのメトリクスを集約し、コスト分析に使用。

metrics: {tokens: 40000, tools: 7, duration: 67s}

/debug コマンド ​

セッション診断用コマンド。複雑なエラーや予期しない挙動の原因調査に使用。 troubleshoot スキルが自動的に起動し、問題を体系的に診断。

PDF ページ範囲指定 ​

大型 PDF を読み込む際にページ範囲を指定可能（例: pages: "1-5"）。 notebookLM スキルでのドキュメント処理、harness-review での大型仕様書参照に活用。

Git log フラグ ​

git log の構造化オプション（--format, --stat, --since 等）を活用。 リリースノート生成、コミット分析、変更追跡を効率化。

OAuth 認証 ​

DCR（Dynamic Client Registration）非対応 MCP サーバーへの OAuth 認証設定。 codex-review スキルでの Codex CLI 接続に使用。

68% メモリ最適化 ​

--resume フラグによるセッション再開時のメモリ使用量削減。 長時間作業セッションでのコンテキスト継続に有効。

サブエージェント MCP ​

Task tool で起動したサブエージェントが親セッションの MCP ツールを共有できる。 task-worker での並列実装時に、各エージェントが同じ MCP ツールセットを使用可能。

Reduced Motion ​

アクセシビリティ設定。モーション/アニメーションを削減するオプション。 harness-ui スキルで UI 生成時に考慮。

TeammateIdle/TaskCompleted Hook ​

Breezing チームのメンバーがアイドル状態になった時、またはタスク完了時に発火するフック。 scripts/hook-handlers/teammate-idle.sh と task-completed.sh で処理。

json
"TeammateIdle": [{"hooks": [{"type": "command", "command": "...teammate-idle", "timeout": 10}]}],
"TaskCompleted": [{"hooks": [{"type": "command", "command": "...task-completed", "timeout": 10}]}]

Agent Memory (memory frontmatter) ​

エージェント定義 YAML の memory: project フィールドで永続メモリを有効化。 task-worker, code-reviewer が過去の実装パターン・失敗と解決策を跨ぎセッションで学習。

Fast mode (Opus 4.6) ​

/fast コマンドで切り替える高速出力モード。同じ Opus 4.6 モデルを使用。 全スキルで利用可能。長い実装タスクでの待ち時間短縮に有効。

自動メモリ記録 ​

セッション終了時に学習内容を自動的にメモリファイルへ永続化。 session-memory スキルが管理。次のセッションで前回の文脈を自動復元。

スキルバジェットスケーリング ​

SKILL.md の文字数予算がコンテキスト窓の 2% に自動調整される。 推奨 500 行は目安値。実効上限はモデルのコンテキスト窓サイズに依存。

Task(agent_type) 制限 ​

Task tool 呼び出し時に subagent_type を指定し、サブエージェントの種類を制限。 agents/ 定義と組み合わせて、意図したエージェントのみを起動することを保証。

Plugin settings.json ​

プラグインの settings.json で初期化時の設定を事前定義。 init トークン消費を削減し、セキュリティポリシーをセッション開始直後から適用。

Worktree isolation ​

git worktree を使って同一ファイルへの並列書き込みを安全化。 breezing と parallel-workflows での複数エージェント並列実装時のコンフリクト防止。

Background agents ​

非同期でバックグラウンドエージェントを起動。完了を待たずに他の処理を継続可能。 generate-video スキルでの複数シーン並列生成に使用。

ConfigChange hook ​

設定ファイル（settings.json 等）が変更された時に発火するフック。 scripts/hook-handlers/config-change.sh で変更を記録・監査。

last_assistant_message ​

セッション終了時の最後のアシスタントメッセージを参照できる機能。 session-memory スキルがセッション品質の自己評価に使用。

Sonnet 4.6 (1M context) ​

最大 1M トークンのコンテキスト窓を持つ Sonnet 4.6 モデル。 大規模コードベースの分析、長大なドキュメント処理に対応。全スキルで利用可能。

補足: 2.1.69 系では旧 Sonnet 4.5 参照は Sonnet 4.6 へ自動マイグレーションされる前提で運用する。

メモリリーク修正 (v2.1.50〜v2.1.63) ​

CC 2.1.50 で LSP 診断データ、大型ツール出力、ファイル履歴、シェル実行に関するメモリリークが修正された。 完了タスクのガベージコレクションも実装され、/breezing 等の長時間チームセッションの安定性が大幅に改善。 v2.1.63 ではさらに MCP 再接続時のリーク、git root キャッシュ、JSON パースキャッシュ、Teammate メッセージ保持、シェルコマンドプレフィックスキャッシュのリークが追加修正された。 Harness 側は JSONL ローテーション（500→400 行）やアトミック更新で既に独自対策を実施済み。

claude agents CLI (v2.1.50) ​

claude agents list で登録済みエージェントの一覧を表示。 troubleshoot スキルでエージェント spawn 失敗時の診断に活用。

bash
claude agents list   # 登録済みエージェントの一覧

WorktreeCreate/WorktreeRemove hook (v2.1.50) ​

Worktree の作成・削除時に発火するライフサイクルフック。 /breezing 並列ワークフローでの自動セットアップ・クリーンアップに活用。 scripts/hook-handlers/worktree-create.sh と worktree-remove.sh で実装済み。

claude remote-control (v2.1.51) ​

外部ビルドシステムとローカル環境のサービングを可能にするサブコマンド。 将来的に Breezing のクロスセッション制御や CI 連携に活用の余地あり。

/simplify (v2.1.63) ​

CC 2.1.63 で追加された実装後の自動コード洗練コマンド。 /work の Phase 3.5 Auto-Refinement として統合され、実装完了後に自動でコードを簡潔化・整理する。 code-simplifier プラグインと組み合わせて --deep-simplify オプションで深いリファクタリングも可能。

/batch (v2.1.63) ​

横展開タスク（同じ変更を複数ファイルに適用するマイグレーション等）を並列委任するコマンド。 /breezing と組み合わせて、Breezing チームに一括マイグレーションを並列実行させる際に使用。 繰り返し作業の効率化と、人為的ミスの削減に有効。

code-simplifier プラグイン ​

/simplify の深いリファクタリングモードを担う外部プラグイン。 --deep-simplify 指定時に起動し、複雑なロジックの分解・不要な抽象化の除去・命名の改善を自動実行。 通常の /simplify は軽量、--deep-simplify はより踏み込んだリファクタリングを実施。

HTTP hooks (v2.1.63) ​

CC 2.1.63 で追加された新しいフック形式。既存の command / prompt タイプに加え http タイプが利用可能になった。 JSON を指定 URL に POST し、外部サービス（Slack、ダッシュボード、メトリクス収集等）と連携できる。 詳細は .claude/rules/hooks-editing.md の「http Type」セクションを参照。

Auto-memory worktree 共有 (v2.1.63) ​

CC 2.1.63 で isolation: "worktree" 使用時に Agent Memory が worktree 間で共有されるようになった。 /breezing の並列 Implementer が各自 worktree 分離で作業しながら、同一の MEMORY.md を参照・更新可能。 Implementer 間の知識共有と、同一バグへの重複対応を防止する。

/clear スキルキャッシュリセット (v2.1.63) ​

CC 2.1.63 で追加されたスキルキャッシュのリセットコマンド。 スキルファイルを編集後に古いキャッシュで動作する問題（スキル開発時に頻発）を /clear で解消できる。 troubleshoot スキルのキャッシュ問題診断ステップに組み込み済み。

ENABLE_CLAUDEAI_MCP_SERVERS (v2.1.63) ​

CC 2.1.63 で追加された環境変数。false を設定すると claude.ai が提供する MCP サーバーを無効化できる。 セキュリティポリシー上、外部 MCP サーバーへの接続を制限したい環境での利用を想定。 setup スキルの環境初期化チェックリストに追加済み。

Agent hooks (v2.1.68) ​

CC 2.1.68 で追加された type: "agent" フック。LLM エージェントがフック判断を行うことで、正規表現では検出困難なコード品質問題を動的に判断できる。 Harness では3箇所に限定採用し、コスト管理のため model: "haiku" と matcher で対象を絞る:

  • PreToolUse Write|Edit: シークレット埋め込み・TODO スタブ・セキュリティ脆弱性のガード
  • PreCompact: dirty Plans.md は pathspec 限定 auto-checkpoint（chore(plans): auto-checkpoint before compaction）後に compact 続行。commit 失敗または precompactAutoCommit: false のみ block（harness-loop 所有セッションは別途 block）
  • PostToolUse Write|Edit: コードレビュー（品質・命名・単一責任）

効果不足時は command 型にロールバック可能な設計。

これら3件は Claude 専用。Codex manifest は inline の空 hook object で plugin-root fallback を止め、Codex / Orca が未対応 agent hook を読み飛ばす警告を 防ぐ。Codex の command hook は harness gen hooks の project-local 生成物として 別経路で配線する。

Effort levels + ultrathink (v2.1.68) ​

CC 2.1.68 で Opus 4.6 が medium effort をデフォルトに変更。ultrathink キーワードで1ターンのみ high effort（extended thinking）を有効化できる。 harness-work スキルが多要素スコアリング（変更ファイル数・対象ディレクトリ・キーワード・失敗履歴・PM 明示指定）でスコアを算出し、閾値 3 以上で Worker spawn prompt 冒頭に ultrathink を自動注入する。 詳細は skills/harness-work/SKILL.md の「Effort レベル制御」セクション参照。

Opus 4/4.1 削除（v2.1.68） ​

CC 2.1.68 で Opus 4 と Opus 4.1 が first-party API から削除された。Harness が対象エージェントで model: opus 相当を指定している場合、Opus 4.6 へ自動移行される。 Worker/Reviewer エージェントは model: sonnet のため影響なし。Lead（Opus 使用時）のみ medium effort がデフォルトになる変更を受ける。

${CLAUDE_SKILL_DIR} 変数 (v2.1.69) ​

CC 2.1.69 でスキル実行時の基準パス変数 ${CLAUDE_SKILL_DIR\} が導入された。 Harness では SKILL.md から references/*.md を参照するリンクを $\{CLAUDE_SKILL_DIR\}/references/... へ統一し、ミラー構成（codex/opencode）でも同じ参照を維持する。

InstructionsLoaded hook (v2.1.69) ​

CC 2.1.69 で InstructionsLoaded イベントが追加された。Harness では scripts/hook-handlers/instructions-loaded.sh を新設し、instructions 読み込み完了時の軽量トラッキングと事前検証に利用する。

agent_id / agent_type 追加 (v2.1.69) ​

Teammate 系イベントに agent_id / agent_type が追加された。 Harness の guardrail は session_id 前提から agent_id 優先（fallback: session_id）へ拡張し、role ガードを安定化した。

\{"continue": false\} teammate 応答 (v2.1.69) ​

TeammateIdle / TaskCompleted で \{"continue": false, "stopReason": "..."\} を返せるようになった。 Harness では stop リクエスト受信時と全タスク完了時に同レスポンスを返し、breezing の停止判定を明示化した。

/reload-plugins (v2.1.69) ​

スキル・フック編集後にセッション再起動なしで反映するため、開発フローに /reload-plugins を追加。 編集 → /reload-plugins → 再実行、を標準手順とする。

includeGitInstructions: false (v2.1.69) ​

git 指示を常時埋め込む必要がないタスクでは includeGitInstructions: false を適用し、トークン消費を抑制できる。 Harness では breezing/work の軽量タスク（ドキュメント更新など）での活用を推奨する。

git-subdir plugin source (v2.1.69) ​

plugin source を monorepo のサブディレクトリで管理する git-subdir 方式がサポートされた。 Harness では現状 .claude-plugin/plugin.json に追加フィールドを強制せず、リリース時に plugin source を明示して運用する（互換性優先）。

Compaction 画像保持 (v2.1.70) ​

CC 2.1.70 でコンテキスト圧縮（Compaction）時にサマリーリクエストが画像を保持するようになった。 これにより、スクリーンショットや図表を含むセッションで Compaction 後も画像コンテキストが維持される。 プロンプトキャッシュの再利用率も改善され、画像を扱うスキル全般で効率が向上。

サブエージェント最終レポート簡潔化 (v2.1.70) ​

サブエージェント完了時の最終レポートが簡潔化され、トークン消費が削減された。 breezing や harness-work で多数のサブエージェントを起動する場合、累積的なトークン節約効果が大きい。

--resume スキルリスト再注入廃止 (v2.1.70) ​

--resume でセッション再開する際、スキルリストの再注入が廃止された。 これにより約 600 tokens が節約され、session スキルでの再開フローが軽量化。

Plugin hooks 修正 (v2.1.70) ​

v2.1.70 で複数の Plugin hooks 関連バグが修正された:

  • Stop / SessionEnd フックが /plugin コマンド実行後にも正常に発火
  • 同一テンプレートを持つフック間の衝突が解消
  • WorktreeCreate / WorktreeRemove フックの正常動作が確認

Teammate ネスト防止追加修正 (v2.1.70) ​

v2.1.69 で対応済みの Teammate ネスト防止に追加修正が入った。 エージェントが別のエージェントを無限に spawn するカスケード問題の防止が強化された。

PostToolUseFailure hook (v2.1.70) ​

CC 2.1.70 で PostToolUseFailure イベントが追加された。ツール呼び出しが失敗した時に発火する新しいフックイベント。 Harness では hooks スキルと error-recovery で活用し、連続失敗時の自動エスカレーション（3回連続失敗で停止）に使用。

json
"PostToolUseFailure": [{
  "hooks": [{
    "type": "command",
    "command": "...post-tool-failure.sh",
    "timeout": 10
  }]
}]

/loop + Cron スケジューリング (v2.1.71) ​

CC 2.1.71 で /loop コマンドが追加された。/loop 5m <prompt> のように間隔とプロンプトを指定すると、定期的にコマンドを実行する Cron 風スケジューリングが可能。 breezing では /loop 5m /sync-status でタスク進捗の定期チェックに活用。 既存の TeammateIdle（受動的・イベント駆動）と異なり、能動的に定期監視を行える。

Background Agent 出力パス修正 (v2.1.71) ​

CC 2.1.71 で Background Agent の完了通知に出力ファイルパスが含まれるようになった。 これにより、圧縮後でもバックグラウンドエージェントの結果を安全に回収可能。 breezing や parallel-workflows での run_in_background: true が実用的に。

--print モードでチームエージェントが hang する問題が修正された。 CI パイプラインでの claude --print 実行時のチームエージェント安定性が向上。

Plugin インストール並列実行修正 (v2.1.71) ​

複数の Claude Code インスタンスが同時にプラグインをインストールする際の状態競合が修正された。 breezing で複数 Teammate が同時に起動する際のプラグイン読み込み安定性が向上。

Marketplace 改善 (v2.1.71) ​

CC 2.1.71 で Marketplace 周りに複数の改善が入った:

  • @ref パーサー修正: owner/repo@vX.X.X 形式の参照解決が正確に
  • update 時の merge conflict 修正: プラグイン更新がより安定に
  • MCP server 重複排除: 同一 MCP サーバーの多重登録を防止
  • /plugin uninstall が settings.local.json を使用: ユーザーローカル設定への正確な反映

Per-agent hooks (v2.1.69+) ​

CC 2.1.69 でエージェント定義の frontmatter に hooks フィールドが追加された。 グローバル hooks.json とは別に、エージェント固有のフックを定義できる。

Harness での活用:

  • Worker: PreToolUse で Write/Edit 時の pre-tool.sh ガードレールを適用
  • Reviewer: Stop でレビューセッション完了をログ出力

エージェント定義内フックはそのエージェントのライフサイクル中のみ有効で、終了時に自動クリーンアップされる。

Agent isolation: worktree (v2.1.50+) ​

エージェント定義の frontmatter に isolation: worktree を追加すると、 そのエージェントが起動時に自動で git worktree を作成し、独立したリポジトリコピーで作業する。 変更がない場合は worktree が自動クリーンアップされる。

Harness では Worker エージェントに isolation: worktree を追加。 memory: project と組み合わせることで、worktree 間で Agent Memory（MEMORY.md）が共有され、 並列 Worker が同一の学習内容を参照・更新可能。

Auto Mode rollout ポリシー ​

Auto Mode は Claude Code の team execution をより安全側に寄せるための移行候補として整理している。 ただし shipped default はまだ bypassPermissions であり、project template や frontmatter には公式 docs に載っている permission mode のみを残す。

レイヤー採用値理由
project template (permissions.defaultMode)bypassPermissionsdocumented permission modes に autoMode が含まれないため
agent frontmatter (permissionMode)bypassPermissions宣言的設定は documented 値のみを使うため
teammate 実行経路bypassPermissions（現行）shipped default と実際の permission 継承を一致させるため
--auto-modeopt-in marker親セッションが互換な permission mode の場合のみ rollout を試すため

既定コマンド例:

bash
/breezing all
/execute --breezing all

Subagent background フィールド ​

エージェント定義の frontmatter に background: true を追加すると、そのエージェントは常にバックグラウンドタスクとして実行される。 明示的に run_in_background: true を指定しなくても、Agent tool 経由で起動するたびにバックグラウンド実行となる。

yaml
---
name: long-running-analyzer
background: true
---

Harness では breezing の Worker spawn 時に検討可能だが、現状は Lead が明示的に run_in_background を制御しているため、追加適用は Phase 2 以降で検討する。

Subagent local メモリスコープ ​

memory: local は .claude/agent-memory-local/<name>/ に保存され、.gitignore に追加すべきパス。 project との違い:

スコープパスVCS コミットユースケース
user~/.claude/agent-memory/<name>/対象外全プロジェクト共通の学習
project.claude/agent-memory/<name>/共有可能チーム共有のプロジェクト知識
local.claude/agent-memory-local/<name>/非推奨個人固有・機密性の高い学習

Harness では Worker/Reviewer ともに memory: project を使用中。local は個人的なデバッグパターンの記録に適するが、チーム共有を優先するため現行設定を維持。

Agent Teams 実験フラグ ​

Agent Teams は実験的機能として CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 環境変数で有効化される。 settings.json 経由でも設定可能:

json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Harness の breezing スキルは Agent Teams 機能を前提としているため、 セットアップ時にこの環境変数が設定されていることを確認する検証ステップを追加。

Desktop Scheduled Tasks ​