サブエージェントに Skill 本文を丸ごと読ませず、持ち場で要る手順だけを渡す

[takemi-ohama]

親: #827

何をするか

supervisor / worker（サブエージェント）には、その持ち場で要る手順だけを渡す。Skill の本文を丸ごと読ませない。

例: 実装の worker に「/ndf:progress-tracking で工程を記録し、/ndf:development-workflow のモード判定に従って…」と指示すると、worker は progress-tracking（約 7.6k トークン）と development-workflow（約 10.7k トークン）の本文を丸ごと読み込む。このうち worker が実際に使うのは、記録用のコマンド 1 行と自分の工程の手順だけである。

なぜ

#827 で実測した結果（2026-09-20 以降、5 リポジトリ、サブエージェント 156 件）:

• 費用の 77% はサブエージェントが使っている（197M / 254M。input 単価を 1 とした換算値）
• 156 件のうち 102 件が Skill を読み込み、合計 371 回・約 230 万トークン（推定）だった
• Skill 本文は、サブエージェントの持ち越し量（文脈に残り続けて毎回読み直される量）の 16% を占める

Skill	サブエージェント内での読み込み回数	1 回あたり
progress-tracking	40	7,649
development-workflow	28	10,679
markdown-writing	46	6,204
cross-review	29	9,807
fix	33	7,211
pr	34	5,067

方針（案）

この課題は、agent-layers.md の supervisor / worker の起動指示の雛形と、抜粋の形を決める。各 Skill の抜粋の中身は作らない。

• agent-layers.md の supervisor / worker の起動指示の雛形から、Skill 本文の読み込みを外す
• development-workflow を読むのは conductor だけにする。supervisor / worker には、モードの判定結果と自分の工程の手順だけを渡す
• 記録は progress-record.sh の 1 行で行う（plugins/ndf/scripts/progress-record.sh <issue> <工程名> [--mode ...]。$SCRIPTS は development-workflow/references/scripts-lookup.md で決め、基盤: スクリプトの置き場所（$SCRIPTS / SKILL_DIR）の解決を 1 本のコマンドにする #847 の後はその 1 コマンドにする）
• 抜粋の形を「呼び出し 1 行・結果の読み方・判断の基準」と決める（Skill の主体をスクリプトへ移し、LLM は呼び出し・結果の解釈・判断だけを持つ（全 Skill の改善の親） #845 の接点 9 と同じ形）
• 対象になる文書: development-workflow/references/agent-layers.md、parallel-work.md

各 Skill の抜粋は #845 の子（#856 #859 #858 #870 #873 ほか）で SKILL.md を縮めるときに作る。 表の 6 Skill のうち development-workflow 以外の 5 つはスクリプト主体へ移り、SKILL.md 自体が「呼び出しと判断」だけに縮む。いま各 Skill の手順を抜粋へ写すと、マイルストーン 29〜34 で書き直すことになる。抜粋と本文の一致の検査は #855 が持つ。

マイルストーン 30（#846 結果の契約・#855 書き方の規約）の始める条件が「この課題が develop にマージされた後」なので、この課題は契約の手前で形だけを決める役になる。agent-layers.md は PR #844（#829 の実装）も触るため、実装は #844 のマージの後に始める。

受け入れ条件

• supervisor / worker を起動する指示の雛形が、Skill 本文の読み込みを求めていない（必要な手順だけが書かれている）
• progress-tracking の記録が、Skill を読まずにコマンド 1 行でできる
• development-workflow: トークン消費の実測と削減（supervisor をスクリプトで駆動し、判断は最小構成の claude -p に任せる） #827 の計測スクリプトで、変更後の版を同じ条件で回すと、サブエージェント内の Skill 読み込み回数が減っている（数値を本 issue に残す）

注意

• 渡す手順が Skill の本文とずれると、規約から外れる。抜粋は本文と同じ場所に置き、検査で一致を確かめる（基盤: Skill の書き方の規約に「スクリプト主体」を足し、検査と本文の量の計測を入れる #855）

関連

#845（接点 9）、#846（契約）、#847（$SCRIPTS の解決）、#855（抜粋と本文の一致の検査）、#856（progress-tracking の抜粋）、#829（PR #844、同じ agent-layers.md）

進行

モード: standard / 作業ツリー: .worktrees/release/v10.17.2-dev.1 / 計画: issues/old/milestone-26-worker-agent/issue-828-680-implementation-plan.md

• 要求と受け入れ条件 — 2026-09-23 05:37
• 作業場所の用意 — 2026-09-23 05:38
• 設計 — 2026-09-23 05:41
• 素材の収集と出典の確定
• ドキュメント再構成 — 2026-09-23 05:45
• ドキュメントレビュー — 2026-09-23 05:47
• 計画 — 2026-09-23 07:50
• 実装 — 2026-09-23 07:51
• 構造改善
• 実装レビュー — 2026-09-23 08:08
• 完了判定 — 2026-09-23 08:16
• Pull Request — 2026-09-23 08:04
• 確定仕様化 — 2026-09-23 08:22
• 後片付け — 2026-09-23 07:49
• 配布 — 2026-09-23 08:31
• 体裁レビュー
• リリース後テスト — 2026-09-23 09:41 / 10.17.2 本番の導入確認は合格、AC12 と AC2 の追加確認は測定待ち（PR Release: ndf v10.17.2 #905 のコメント）
• 振り返り

[takemi-ohama]

AC14 の実機の確かめ（ndf:worker）

2026-09-23、Claude Code 2.1.280。実装ブランチ feat/issue-828-680-worker-agent の plugins/ndf を claude -p --plugin-dir で読み込み、使い捨てのリポジトリで親から subagent_type: "ndf:worker" の子を起動した。

確かめたこと	結果
導入した NDF から ndf:worker を起動できる	起動できた
子の ToolSearch の select:Skill	No matching deferred tools found.
子の道具の一覧に Skill / Agent があるか	どちらも無い（最初の道具は Bash / Edit / ListAgents / Read / ReportFindings / ToolSearch / Write）

定義は plugins/ndf/agents/worker.md の disallowedTools: Skill, Agent。定義の検査は plugins/ndf/scripts/tests/test_worker_agent.py。

[takemi-ohama]

構造改善（/ndf:cross-refactoring）は利用者の指示で省略する（#880 ほか）。PR #903 は実装レビュー（/ndf:cross-review）から進める。

[takemi-ohama]

棚卸（2026-09-25）: 実装は ndf 10.17.18 までに main へ配布済みのため閉じる。