{
  "schemaVersion": "1.0",
  "item": {
    "slug": "claude-code-orchestrator",
    "name": "Claude Code Orchestrator (tmux-first)",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "canonicalUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/claude-code-orchestrator",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "scripts/bootstrap.sh",
      "scripts/complete-tmux-task.sh",
      "scripts/list-tasks.sh",
      "scripts/monitor-tmux-task.sh",
      "scripts/reconcile-tasks.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "claude-code-orchestrator",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T11:32:26.696Z",
      "expiresAt": "2026-05-08T11:32:26.696Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=claude-code-orchestrator",
        "contentDisposition": "attachment; filename=\"claude-code-orchestrator-0.2.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "claude-code-orchestrator"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/claude-code-orchestrator"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/claude-code-orchestrator",
    "agentPageUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Claude Code Orchestrator (tmux-first)",
        "body": "Use tmux-based orchestration for long coding tasks to avoid silent hangs and make progress observable."
      },
      {
        "title": "Standard workflow",
        "body": "Create prompt file (avoid long shell quote issues).\nStart a dedicated tmux session.\nLaunch claude --dangerously-skip-permissions in interactive mode.\nPaste prompt into Claude.\nRequire callback command in prompt (via wrapper):\nbash {baseDir}/scripts/wake.sh \"...\" now\nShare socket/session attach command with user.\nOn completion, review diff + lint/build + risk summary."
      },
      {
        "title": "Start command",
        "body": "bash {baseDir}/scripts/start-tmux-task.sh \\\n  --label \"gallery-detail-polish\" \\\n  --workdir \"/Users/yaxuan/.openclaw/workspace/work/active/02-gallery-ops\" \\\n  --prompt-file \"/Users/yaxuan/Downloads/gallery-website-design-system.md\" \\\n  --task \"参考这个修改我当前的画廊官网，注意优先打磨细节和质感，对整体结构展示先不用大改。\""
      },
      {
        "title": "Monitor commands",
        "body": "# attach\nbash {baseDir}/scripts/monitor-tmux-task.sh --attach --session <session>\n\n# capture last 200 lines\nbash {baseDir}/scripts/monitor-tmux-task.sh --session <session> --lines 200"
      },
      {
        "title": "Task overview",
        "body": "List all running cc-* tasks at a glance — useful for \"butler-style\" summaries.\n\n# Human-readable one-liner per task\nbash {baseDir}/scripts/list-tasks.sh\n\n# Structured JSON array (pipe to jq, feed to OpenClaw, etc.)\nbash {baseDir}/scripts/list-tasks.sh --json | jq .\n\nOptions:\n\n--lines <n> — number of trailing pane lines to capture per task (default 20).\n--socket <path> — tmux socket path (default $TMPDIR/clawdbot-tmux-sockets/clawdbot.sock).\n--json — emit JSON array instead of human table.\n--target ssh --ssh-host <alias> — list sessions on a remote host.\n\nEach entry contains: label, session, status, sessionAlive, reportExists, reportJsonPath, lastLines, updatedAt.\n\nCombine with OpenClaw to generate a periodic butler summary:\n\n# In an OpenClaw prompt / cron:\nbash {baseDir}/scripts/list-tasks.sh --json | \\\n  openclaw gateway call summarize-tasks --stdin"
      },
      {
        "title": "Rules",
        "body": "Prefer interactive Claude in tmux for visibility (not long claude -p one-shot for large tasks).\nAlways include callback via wrapper bash {baseDir}/scripts/wake.sh \"...\" now in prompt.\nStartup script now uses robust submit (ready-check + multi-Enter retry + execution-state detection) to avoid \"prompt pasted but not submitted\".\nIf no pane output for >2-3 min, inspect and restart session.\nKill stale Claude processes before restart.\nAlways return: session name + attach command + current status."
      },
      {
        "title": "Status check (zero-token)",
        "body": "If wake not received within expected time, check task status before consuming tokens:\n\nbash {baseDir}/scripts/status-tmux-task.sh --label <label>\n\nOutput: STATUS=running|likely_done|stuck|idle|dead|done_session_ended\n\nlikely_done / done_session_ended → proceed to completion loop\nrunning → wait\nstuck → inspect (attach or capture-pane)\ndead → session lost, run complete-tmux-task.sh fallback\nidle → Claude may be waiting for input, inspect"
      },
      {
        "title": "Completion loop (mandatory)",
        "body": "When wake event \"Claude Code done (...)\" arrives, complete this loop immediately:\n\nAcknowledge user within 60s: \"已收到完成信号，正在评估改动\".\nPreferred path: read completion report generated by Claude Code task:\n\n/tmp/cc-<label>-completion-report.json\n\n\nIf report missing, run local fallback immediately:\n\nbash {baseDir}/scripts/complete-tmux-task.sh --label <label> --workdir <workdir>\n\n\nMandatory deep-read: read full JSON/MD report before replying.\nRead context before replying:\n\nRead completion report file(s) (/tmp/cc-<label>-completion-report.json/.md)\nRead recent tmux transcript (monitor script) to capture what Claude actually did/failed/tried\nIncorporate the latest user constraints from current chat\n\n\nThen provide assistant analysis (not a fixed template):\n\nwhat was actually completed\nwhat is reliable vs uncertain\nkey risks/tradeoffs in the user's context\nconcrete next-step options\n\n\nAsk explicit decision from user if scope drift exists.\n\nDo not stop at wake-only notification. Wake is trigger, not final delivery."
      },
      {
        "title": "Anti-pattern to avoid",
        "body": "Forbidden: one-line fixed reply after wake without reading transcript + report.\nForbidden: only relaying \"done + report path\" without analysis in user context.\nForbidden: rigid templated output that ignores current conversation context."
      },
      {
        "title": "Hard guardrails added",
        "body": "Prompt now enforces “no wake without report”:\n\ntask must write /tmp/cc-<label>-completion-report.json + .md\nfinal wake must include report=<json_path>\n\n\nRecovery command exists for deterministic fallback:\n\nscripts/complete-tmux-task.sh reproduces evidence and emits structured report\n\n\nDelivery SLA remains mandatory:\n\nwake received -> ack <= 60s -> report"
      }
    ],
    "body": "Claude Code Orchestrator (tmux-first)\n\nUse tmux-based orchestration for long coding tasks to avoid silent hangs and make progress observable.\n\nStandard workflow\nCreate prompt file (avoid long shell quote issues).\nStart a dedicated tmux session.\nLaunch claude --dangerously-skip-permissions in interactive mode.\nPaste prompt into Claude.\nRequire callback command in prompt (via wrapper): bash {baseDir}/scripts/wake.sh \"...\" now\nShare socket/session attach command with user.\nOn completion, review diff + lint/build + risk summary.\nStart command\nbash {baseDir}/scripts/start-tmux-task.sh \\\n  --label \"gallery-detail-polish\" \\\n  --workdir \"/Users/yaxuan/.openclaw/workspace/work/active/02-gallery-ops\" \\\n  --prompt-file \"/Users/yaxuan/Downloads/gallery-website-design-system.md\" \\\n  --task \"参考这个修改我当前的画廊官网，注意优先打磨细节和质感，对整体结构展示先不用大改。\"\n\nMonitor commands\n# attach\nbash {baseDir}/scripts/monitor-tmux-task.sh --attach --session <session>\n\n# capture last 200 lines\nbash {baseDir}/scripts/monitor-tmux-task.sh --session <session> --lines 200\n\nTask overview\n\nList all running cc-* tasks at a glance — useful for \"butler-style\" summaries.\n\n# Human-readable one-liner per task\nbash {baseDir}/scripts/list-tasks.sh\n\n# Structured JSON array (pipe to jq, feed to OpenClaw, etc.)\nbash {baseDir}/scripts/list-tasks.sh --json | jq .\n\n\nOptions:\n\n--lines <n> — number of trailing pane lines to capture per task (default 20).\n--socket <path> — tmux socket path (default $TMPDIR/clawdbot-tmux-sockets/clawdbot.sock).\n--json — emit JSON array instead of human table.\n--target ssh --ssh-host <alias> — list sessions on a remote host.\n\nEach entry contains: label, session, status, sessionAlive, reportExists, reportJsonPath, lastLines, updatedAt.\n\nCombine with OpenClaw to generate a periodic butler summary:\n\n# In an OpenClaw prompt / cron:\nbash {baseDir}/scripts/list-tasks.sh --json | \\\n  openclaw gateway call summarize-tasks --stdin\n\nRules\nPrefer interactive Claude in tmux for visibility (not long claude -p one-shot for large tasks).\nAlways include callback via wrapper bash {baseDir}/scripts/wake.sh \"...\" now in prompt.\nStartup script now uses robust submit (ready-check + multi-Enter retry + execution-state detection) to avoid \"prompt pasted but not submitted\".\nIf no pane output for >2-3 min, inspect and restart session.\nKill stale Claude processes before restart.\nAlways return: session name + attach command + current status.\nStatus check (zero-token)\n\nIf wake not received within expected time, check task status before consuming tokens:\n\nbash {baseDir}/scripts/status-tmux-task.sh --label <label>\n\n\nOutput: STATUS=running|likely_done|stuck|idle|dead|done_session_ended\n\nlikely_done / done_session_ended → proceed to completion loop\nrunning → wait\nstuck → inspect (attach or capture-pane)\ndead → session lost, run complete-tmux-task.sh fallback\nidle → Claude may be waiting for input, inspect\nCompletion loop (mandatory)\n\nWhen wake event \"Claude Code done (...)\" arrives, complete this loop immediately:\n\nAcknowledge user within 60s: \"已收到完成信号，正在评估改动\".\nPreferred path: read completion report generated by Claude Code task:\n/tmp/cc-<label>-completion-report.json\nIf report missing, run local fallback immediately:\nbash {baseDir}/scripts/complete-tmux-task.sh --label <label> --workdir <workdir>\nMandatory deep-read: read full JSON/MD report before replying.\nRead context before replying:\nRead completion report file(s) (/tmp/cc-<label>-completion-report.json/.md)\nRead recent tmux transcript (monitor script) to capture what Claude actually did/failed/tried\nIncorporate the latest user constraints from current chat\nThen provide assistant analysis (not a fixed template):\nwhat was actually completed\nwhat is reliable vs uncertain\nkey risks/tradeoffs in the user's context\nconcrete next-step options\nAsk explicit decision from user if scope drift exists.\n\nDo not stop at wake-only notification. Wake is trigger, not final delivery.\n\nAnti-pattern to avoid\nForbidden: one-line fixed reply after wake without reading transcript + report.\nForbidden: only relaying \"done + report path\" without analysis in user context.\nForbidden: rigid templated output that ignores current conversation context.\nHard guardrails added\nPrompt now enforces “no wake without report”:\ntask must write /tmp/cc-<label>-completion-report.json + .md\nfinal wake must include report=<json_path>\nRecovery command exists for deterministic fallback:\nscripts/complete-tmux-task.sh reproduces evidence and emits structured report\nDelivery SLA remains mandatory:\nwake received -> ack <= 60s -> report"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "publisherUrl": "https://clawhub.ai/Yaxuan42/claude-code-orchestrator",
    "owner": "Yaxuan42",
    "version": "0.2.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/claude-code-orchestrator",
    "downloadUrl": "https://openagent3.xyz/downloads/claude-code-orchestrator",
    "agentUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent",
    "manifestUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/claude-code-orchestrator/agent.md"
  }
}