claude-task-worker 0.40.0 → 0.41.0

package/README.md

@@ -335,6 +335,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 ```json
 {
   "mode": "default",
+  "advisor": false,
   "projects": {
     "app-a": "/Users/me/repos/app-a",
     "app-b": "/Users/me/repos/app-b",
@@ -346,7 +347,7 @@ claude-task-worker yolo --epic 100 --epic 200 --label priority-high
 }
 ```
 
-`mode` については [`mode`（タスクの実行形態）](#modeタスクの実行形態) を参照。
+`mode` については [`mode`（タスクの実行形態）](#modeタスクの実行形態)、`advisor` については [`advisor`（アドバイザーモデル）](#advisorアドバイザーモデル) を参照。
 
 `--project` は繰り返し指定可能で、複数指定した場合は解決後のプロジェクト集合の和集合が対象になる（重複は一意化される）。`--epic` / `--label` と併用でき、ディスパッチ先の各プロジェクトで実行されるコマンドにそのまま引き継がれる。
 
@@ -405,6 +406,24 @@ claude-task-worker exec-issue --project app-a --epic 100 --label priority-high
 
   適用は `herdr server reload-config`。この設定は herdr サーバー全体に効くため、ワーカー以外の対話セッションの完了音も鳴らなくなる（`[ui.sound.agents] claude = "off"` でも実質同じ範囲）。ワーカーだけを無音にしたい場合は、`HERDR_DISABLE_SOUND=1 herdr --session <name>` で別セッションを起動し、その中でディスパッチャーを動かす
 
+### `advisor`（アドバイザーモデル）
+
+`config.json` のトップレベルに `advisor: true` を書くと、ワーカーがタスクを起動する際、Claude CLI へ `--advisor <model>` を渡すようになる。渡すモデルはリポジトリ直下の `claude-task-worker.json` の `workers.<ワーカー名>.advisorModel`（[ワーカーごとの設定](#ワーカーごとの設定)）で指定する。`mode` と同じくトップレベル一括で、プロジェクト単位・ワーカー単位のオン/オフはできない。
+
+| `advisor` | 挙動 |
+|---|---|
+| `false`（既定） | `advisorModel` の指定に関わらず `--advisor` を渡さない |
+| `true` | 各ワーカーの `advisorModel`（未指定時はワーカー既定値）を `--advisor` に渡す。空文字のワーカーには渡さない |
+
+```json
+{
+  "advisor": true,
+  "projects": { "app-a": "/Users/me/repos/app-a" }
+}
+```
+
+advisor は main モデル以上の能力を持つモデルである必要がある（Claude CLI 側の制約）。そのため `advisorModel` の既定値は、`model` が `sonnet` のワーカーは `opus`、`model` が `opus` のワーカー（`answer-issue-questions`）は空文字（＝advisor なし）にしてある。
+
 ### exec-issue
 
 `cc-exec-issue` ラベルが付いた自分にアサインされたIssueを定期取得し、Claude Codeで処理を実行する。（デフォルト1分間隔）
@@ -562,26 +581,26 @@ claude-task-worker -v
 |---|---|---|---|
 | `fixReviewPointCallbackCommentMessage` | string | - | fix-review-point 完了時にPRへ投稿するコメント（未設定の場合は投稿しない） |
 | `uiDesign` | object | `{ "enabled": false, "designDir": "designs" }` | UIデザイン先行ワークフローの設定（詳細は「[UIデザイン先行ワークフロー](#uiデザイン先行ワークフロー)」） |
-| `workers` | object | `{}` | ワーカーごとに Claude CLI に渡すスキル、`--model` / `--effort`、ポーリング間隔、クールダウン時間、最大同時実行数を上書きする設定（詳細は下記） |
+| `workers` | object | `{}` | ワーカーごとに Claude CLI に渡すスキル、`--model` / `--advisor` / `--effort`、ポーリング間隔、クールダウン時間、最大同時実行数を上書きする設定（詳細は下記） |
 
 ### ワーカーごとの設定
 
-`workers` キーにワーカー名ごとの設定オブジェクトを指定することで、Claude CLI の `-p` に渡すスキル（スラッシュコマンド）、`--model` / `--effort`、ポーリング間隔、タスク完了後のクールダウン時間、最大同時実行数を個別に上書きできる。未指定のワーカー・フィールドは下記のワーカー別デフォルト値が使用される。
-
-| ワーカー名 | デフォルト `skill` | デフォルト `model` | デフォルト `effort` | デフォルト `pollingIntervalSeconds` | デフォルト `cooldownSeconds` | デフォルト `maxConcurrentTasks` |
-|---|---|---|---|---|---|---|
-| `answer-issue-questions` | `/claude-task-worker:answer-issue-questions` | `opus` | `xhigh` | 60 | 0 | 1 |
-| `create-issue` | `/claude-task-worker:create-issue-from-issue-number` | `sonnet` | `xhigh` | 60 | 0 | 1 |
-| `update-issue` | `/claude-task-worker:update-issue` | `sonnet` | `high` | 60 | 0 | 1 |
-| `exec-issue` | `/claude-task-worker:exec-issue` | `sonnet` | `high` | 60 | 0 | 1 |
-| `fix-review-point` | `/claude-task-worker:fix-review-point` | `sonnet` | `high` | 60 | 0 | 1 |
-| `triage-created-issue` | `/claude-task-worker:triage-created-issue` | `sonnet` | `high` | 60 | 0 | 1 |
-| `triage-pr` | `/claude-task-worker:triage-pr` | `sonnet` | `high` | 60 | 0 | 1 |
-| `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `high` | 60 | 0 | 1 |
-| `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `high` | 3600 | 0 | 1 |
-| `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `high` | 300 | 0 | 1 |
-| `create-ui-design` | `/claude-task-worker:create-ui-design` | `sonnet` | `high` | 60 | 0 | 1 |
-| `apply-ui-design` | `/claude-task-worker:apply-ui-design` | `sonnet` | `high` | 60 | 0 | 1 |
+`workers` キーにワーカー名ごとの設定オブジェクトを指定することで、Claude CLI の `-p` に渡すスキル（スラッシュコマンド）、`--model` / `--advisor` / `--effort`、ポーリング間隔、タスク完了後のクールダウン時間、最大同時実行数を個別に上書きできる。未指定のワーカー・フィールドは下記のワーカー別デフォルト値が使用される。
+
+| ワーカー名 | デフォルト `skill` | デフォルト `model` | デフォルト `advisorModel` | デフォルト `effort` | デフォルト `pollingIntervalSeconds` | デフォルト `cooldownSeconds` | デフォルト `maxConcurrentTasks` |
+|---|---|---|---|---|---|---|---|
+| `answer-issue-questions` | `/claude-task-worker:answer-issue-questions` | `opus` | (なし) | `xhigh` | 60 | 0 | 1 |
+| `create-issue` | `/claude-task-worker:create-issue-from-issue-number` | `sonnet` | `opus` | `xhigh` | 60 | 0 | 1 |
+| `update-issue` | `/claude-task-worker:update-issue` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `exec-issue` | `/claude-task-worker:exec-issue` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `fix-review-point` | `/claude-task-worker:fix-review-point` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `triage-created-issue` | `/claude-task-worker:triage-created-issue` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `triage-pr` | `/claude-task-worker:triage-pr` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `resolve-conflict` | `/claude-task-worker:resolve-pr-conflict` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `check-dependabot` | `/claude-task-worker:check-dependabot` | `sonnet` | `opus` | `high` | 3600 | 0 | 1 |
+| `epic-issue` | `/claude-task-worker:create-epic-pr` | `sonnet` | `opus` | `high` | 300 | 0 | 1 |
+| `create-ui-design` | `/claude-task-worker:create-ui-design` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
+| `apply-ui-design` | `/claude-task-worker:apply-ui-design` | `sonnet` | `opus` | `high` | 60 | 0 | 1 |
 
 各フィールドの値:
 
@@ -589,6 +608,7 @@ claude-task-worker -v
 |---|---|---|
 | `skill` | string | Claude CLI の `-p` に渡すスラッシュコマンド（例: `/claude-task-worker:exec-issue`, `/my-plugin:my-skill`）。ワーカーは `"<skill> <issue-or-pr-number>"` の形で Claude を起動する |
 | `model` | string | Claude CLI の `--model` に渡す値（例: `sonnet`, `opus`, `haiku`） |
+| `advisorModel` | string | Claude CLI の `--advisor` に渡す値（例: `opus`）。空文字を指定するとそのワーカーでは advisor を使わない。`config.json` の `advisor` が `true` のときだけ参照される（詳細は「[`advisor`（アドバイザーモデル）](#advisorアドバイザーモデル)」） |
 | `effort` | string | Claude CLI の `--effort` に渡す値（例: `high`, `medium`, `low`） |
 | `pollingIntervalSeconds` | number | GitHub をポーリングする間隔（秒）。正の数を指定する |
 | `cooldownSeconds` | number | タスク完了後に次のポーリングを停止する時間（秒）。`0` でクールダウンなし |
@@ -599,8 +619,8 @@ claude-task-worker -v
 ```json
 {
   "workers": {
-    "exec-issue":        { "skill": "/my-plugin:exec-issue", "model": "opus", "effort": "high", "pollingIntervalSeconds": 60, "cooldownSeconds": 600, "maxConcurrentTasks": 3 },
-    "fix-review-point":  { "skill": "/claude-task-worker:fix-review-point", "model": "sonnet", "effort": "high", "maxConcurrentTasks": 2 },
+    "exec-issue":        { "skill": "/my-plugin:exec-issue", "model": "opus", "advisorModel": "", "effort": "high", "pollingIntervalSeconds": 60, "cooldownSeconds": 600, "maxConcurrentTasks": 3 },
+    "fix-review-point":  { "skill": "/claude-task-worker:fix-review-point", "model": "sonnet", "advisorModel": "opus", "effort": "high", "maxConcurrentTasks": 2 },
     "triage-pr":         { "effort": "medium", "pollingIntervalSeconds": 120 },
     "check-dependabot":  { "model": "haiku", "pollingIntervalSeconds": 7200 }
   }

package/dist/index.js

@@ -1542,7 +1542,8 @@ function systemPromptFilePath() {
   cachedSystemPromptFilePath = target;
   return target;
 }
-function buildClaudeArgs({ mode, prompt, model, effort }) {
+function buildClaudeArgs({ mode, prompt, model, effort, advisorModel }) {
+  const advisor = advisorModel?.trim() ?? "";
   return [
     ...mode === "herdr" ? [] : ["-p"],
     prompt,
@@ -1555,7 +1556,10 @@ function buildClaudeArgs({ mode, prompt, model, effort }) {
     "--model",
     model,
     "--effort",
-    effort
+    effort,
+    // advisor 未指定（空文字）ならフラグごと省く。値なしの `--advisor` を渡すと
+    // 後続フラグを値として食われるため、必ずモデル名とセットでのみ付ける。
+    ...advisor === "" ? [] : ["--advisor", advisor]
   ];
 }
 function buildClaudeExecution(invocation) {
@@ -1575,6 +1579,7 @@ var DEFAULT_UI_DESIGN_CONFIG = {
 var DEFAULT_WORKER_CONFIG = {
   skill: "",
   model: "sonnet",
+  advisorModel: "opus",
   effort: "high",
   pollingIntervalSeconds: 60,
   cooldownSeconds: 0,
@@ -1584,6 +1589,7 @@ var WORKER_DEFAULTS = {
   "answer-issue-questions": {
     skill: "/claude-task-worker:answer-issue-questions",
     model: "opus",
+    advisorModel: "",
     effort: "xhigh",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1592,6 +1598,7 @@ var WORKER_DEFAULTS = {
   "create-issue": {
     skill: "/claude-task-worker:create-issue-from-issue-number",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "xhigh",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1600,6 +1607,7 @@ var WORKER_DEFAULTS = {
   "update-issue": {
     skill: "/claude-task-worker:update-issue",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1608,6 +1616,7 @@ var WORKER_DEFAULTS = {
   "exec-issue": {
     skill: "/claude-task-worker:exec-issue",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1616,6 +1625,7 @@ var WORKER_DEFAULTS = {
   "fix-review-point": {
     skill: "/claude-task-worker:fix-review-point",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1624,6 +1634,7 @@ var WORKER_DEFAULTS = {
   "triage-created-issue": {
     skill: "/claude-task-worker:triage-created-issue",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1632,6 +1643,7 @@ var WORKER_DEFAULTS = {
   "triage-pr": {
     skill: "/claude-task-worker:triage-pr",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1640,6 +1652,7 @@ var WORKER_DEFAULTS = {
   "resolve-conflict": {
     skill: "/claude-task-worker:resolve-pr-conflict",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1648,6 +1661,7 @@ var WORKER_DEFAULTS = {
   "check-dependabot": {
     skill: "/claude-task-worker:check-dependabot",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 3600,
     cooldownSeconds: 0,
@@ -1656,6 +1670,7 @@ var WORKER_DEFAULTS = {
   "epic-issue": {
     skill: "/claude-task-worker:create-epic-pr",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 300,
     cooldownSeconds: 0,
@@ -1664,6 +1679,7 @@ var WORKER_DEFAULTS = {
   "create-ui-design": {
     skill: "/claude-task-worker:create-ui-design",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 60,
     cooldownSeconds: 0,
@@ -1672,6 +1688,7 @@ var WORKER_DEFAULTS = {
   "apply-ui-design": {
     skill: "/claude-task-worker:apply-ui-design",
     model: "sonnet",
+    advisorModel: "opus",
     effort: "high",
     pollingIntervalSeconds: 300,
     cooldownSeconds: 0,
@@ -1709,6 +1726,15 @@ function parseWorkerEntry(name, val) {
       console.warn(`[config] invalid workers.${name}.model: ${String(entry.model)}, using default ${base.model}`);
     }
   }
+  if ("advisorModel" in entry) {
+    if (typeof entry.advisorModel === "string") {
+      result.advisorModel = entry.advisorModel;
+    } else {
+      console.warn(
+        `[config] invalid workers.${name}.advisorModel: ${String(entry.advisorModel)}, using default ${JSON.stringify(base.advisorModel)}`
+      );
+    }
+  }
   if ("effort" in entry) {
     if (typeof entry.effort === "string" && entry.effort.length > 0) {
       result.effort = entry.effort;
@@ -1898,6 +1924,7 @@ import { homedir } from "node:os";
 import { isAbsolute as isAbsolute2, join as join2, resolve } from "node:path";
 var RESERVED_ALL = "all";
 var DEFAULT_RUN_MODE = "default";
+var DEFAULT_ADVISOR_ENABLED = false;
 var UserConfigError = class extends Error {
   constructor(message) {
     super(message);
@@ -1946,6 +1973,13 @@ function parseMode(raw, path2) {
   console.warn(`[config] invalid mode: ${JSON.stringify(value)} in ${path2}, using "${DEFAULT_RUN_MODE}"`);
   return DEFAULT_RUN_MODE;
 }
+function parseAdvisor(raw, path2) {
+  if (!("advisor" in raw)) return DEFAULT_ADVISOR_ENABLED;
+  const value = raw["advisor"];
+  if (typeof value === "boolean") return value;
+  console.warn(`[config] invalid advisor: ${JSON.stringify(value)} in ${path2}, using ${DEFAULT_ADVISOR_ENABLED}`);
+  return DEFAULT_ADVISOR_ENABLED;
+}
 function loadUserConfig() {
   const path2 = getUserConfigPath();
   const raw = readRawConfig();
@@ -1962,6 +1996,7 @@ function loadUserConfig() {
     throw new UserConfigError(`config.json "projectGroups" must be an object: ${path2}`);
   }
   const mode = parseMode(raw, path2);
+  const advisor = parseAdvisor(raw, path2);
   const rawProjects = raw["projects"];
   const rawProjectGroups = "projectGroups" in raw ? raw["projectGroups"] : {};
   const projectKeys = Object.keys(rawProjects);
@@ -2012,7 +2047,7 @@ function loadUserConfig() {
     }
     projectGroups[groupName] = members;
   }
-  return { mode, projects, projectGroups };
+  return { mode, advisor, projects, projectGroups };
 }
 var cachedRunMode;
 function getRunMode() {
@@ -2021,6 +2056,27 @@ function getRunMode() {
   }
   return cachedRunMode;
 }
+var cachedAdvisorEnabled;
+function isAdvisorEnabled() {
+  if (cachedAdvisorEnabled === void 0) {
+    cachedAdvisorEnabled = readAdvisorEnabled();
+  }
+  return cachedAdvisorEnabled;
+}
+function readAdvisorEnabled() {
+  let raw;
+  try {
+    raw = readRawConfig();
+  } catch (err) {
+    console.warn(`[config] failed to read config file, advisor disabled: ${err}`);
+    return DEFAULT_ADVISOR_ENABLED;
+  }
+  if (raw === void 0) return DEFAULT_ADVISOR_ENABLED;
+  if (typeof raw !== "object" || raw === null || Array.isArray(raw)) {
+    return DEFAULT_ADVISOR_ENABLED;
+  }
+  return parseAdvisor(raw, getUserConfigPath());
+}
 function readRunMode() {
   let raw;
   try {
@@ -2977,7 +3033,7 @@ function createIssuePollingWorker(config) {
           try {
             const issueUrl = `https://github.com/${owner}/${name}/issues/${issue.number}`;
             syncDefaultBranch(defaultBranch);
-            const { model, effort, skill } = getWorkerConfig(config.name);
+            const { model, effort, skill, advisorModel } = getWorkerConfig(config.name);
             const command = skill || config.command;
             const parentNumber = issue.parent?.number;
             const mode = getRunMode();
@@ -2985,7 +3041,9 @@ function createIssuePollingWorker(config) {
               mode,
               prompt: `${command} ${issue.number}`,
               model,
-              effort
+              effort,
+              // config.json の advisor が false なら advisorModel の指定に関わらず渡さない。
+              advisorModel: isAdvisorEnabled() ? advisorModel : ""
             });
             let baseBranch = defaultBranch;
             if (parentNumber !== void 0) {
@@ -3149,14 +3207,16 @@ function createPrPollingWorker(config) {
             syncDefaultBranch(defaultBranch);
             await createWorktreeFromBranch(worktreeId, defaultBranch);
             const cwd = getWorktreePath(worktreeId);
-            const { model, effort, skill } = getWorkerConfig(config.name);
+            const { model, effort, skill, advisorModel } = getWorkerConfig(config.name);
             const command = skill || config.command;
             const mode = getRunMode();
             const execution = buildClaudeExecution({
               mode,
               prompt: `${command} ${pr.number}`,
               model,
-              effort
+              effort,
+              // config.json の advisor が false なら advisorModel の指定に関わらず渡さない。
+              advisorModel: isAdvisorEnabled() ? advisorModel : ""
             });
             run(
               execution.command,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-task-worker",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "CLI tool that polls GitHub Issues/PRs and delegates work to Claude CLI",
   "type": "module",
   "main": "dist/index.js",