用途：作为 start-issue 与 cmux 之间的轻量编排层。start-issue 仍是 GitHub issue 解析、分支命名、worktree 创建/复用、init 钩子、提示渲染和代理启动的唯一来源；cmux 只提供终端工作区和可选的监控面板。
主要能力：在指定仓库中为某个 issue 创建名为 start-issue #123 的 cmux 工作区并运行 start-issue；保持当前工作区焦点（除非用户明确要求切换）；通过读取工作区屏幕和侧栏状态检查代理进度；在同名工作区中按需追加日志面板、浏览器面板或 Markdown 计划面板；支持恢复和监控已有运行。
使用方式：从目标仓库运行 <installed-skill-dir>/scripts/start-in-cmux <issue-url> --agent codex。安装目录视安装器而定，常见为 ~/.codex/skills/start-issue-cmux 或 ~/.agents/skills/start-issue-cmux。若仓库有 .envrc，启动器通过 direnv exec . start-issue <issue> --agent codex 运行；否则直接运行 start-issue。状态检查用 cmux read-screen --workspace <ref> --scrollback --lines <n> 和 cmux sidebar-state --workspace <ref> --json。
适用场景：用户明确要求用 cmux、独立标签页或工作区，或要求恢复/监控某次 start-issue 运行。典型如“在单独 cmux 标签页启动 issue #5001”“检查代理状态”“为日志追加右侧面板”。若用户只说“修 issue #5001”而未提 cmux，则走普通 start-issue 流程。
限制与边界：不手动创建 worktree，不直接启动代理，不绕过 start-issue；合并、发布、部署、生产变更或对外消息均不在本技能范围内；不得在工作区描述、操作、提示、日志或 issue 评论中放入令牌、凭据或渲染后的机密环境值；不得聚焦、输入、移动或关闭用户未明确指定的其他工作区。若 cmux 不可用，应报告诊断阻塞并给出普通 start-issue 命令，不得静默回退。状态处理上，代理工作中不打断；WAIT 需报告等待事件；HUMAN_GATE 需报告所需决策而不代答；DONE 需报告 worktree、分支、提交/PR 证据与剩余评审步骤。cmux 通知或侧栏状态仅作提醒，不能替代 issue、代理、CI 或仓库状态。