用途：run-with-it 是最终运行时路由权威，消费已准备好的 issue，执行路由、协调、审查与收尾。上游流程通常为 break-req 解析需求、create-git-issue 发布 PRD 与实现切片，再由 run-with-it 执行。
架构：采用两层结构以维持有界上下文。主编排器在主会话运行，启动时拉取全部 ready-for-agent issue，创建共享运行特性分支，依据各 issue 的 Blocked by 做依赖图与拓扑排序，通过平台调度器维持最多 PARALLEL_JOBS 个 Sub-Coordinator 的滚动池，读取紧凑报告 JSON 并即时发布 GitHub 评论与关闭 issue，最后创建最终 PR。Sub-Coordinator 在子代理会话中端到端处理单个 issue，创建 issue 分支与工作树，执行复杂度分析、路由、计划、实现、审查与修改循环，并写紧凑报告。另有 Plan Worker、Artifact Recovery Worker 与 Merge Recovery Coordinator 等角色。
使用方式：需提供任务摘要，其余为可选覆盖项，如 ISSUE_LABEL（默认 ready-for-agent）、ISSUE_LIMIT（默认 1000）、SUB_COORD_AGENT（默认 codex）、SUB_COORD_MODEL（默认 gpt-5.6-sol）、SUB_COORD_TIMEOUT_SECONDS（默认 3600）等。运行前需检测操作系统，Windows 使用 .ps1 运行器，macOS/Linux/Git Bash/WSL 使用 .sh 运行器。
限制：不合成 PRD、不编写初始 issue 模板、不修改运行器脚本实现细节、不改变注册表数据定义。主编排器不直接实现工作、不运行测试或构建、不读取完整日志或实现差异，仅依据紧凑报告 JSON 判断。Sub-Coordinator 不接触 GitHub，也不更新 main-state.json。具体收费、价格与平台支持范围暂未提供。