核心用法
oneshot CLI 是一条命令驱动的自主代码交付流水线，将传统需要人工介入的开发流程压缩为单次执行。用户只需指定仓库和任务描述（或 Linear 工单链接），工具即通过 SSH 连接到预配置服务器或在本地环境运行完整的四阶段管道：Claude 分析代码库并输出实现方案、Codex 执行具体编码、Codex 自我审查 diff、Claude 完成分支创建与 PR 提交。支持 --local 本地模式、--bg 后台 detached 运行、--dry-run 预验证等灵活选项，并可集成 Linear 自动更新工单状态。
显著优点
- 端到端自动化：单命令替代「读代码→写方案→手动编码→自测→提 PR」完整链路，显著降低上下文切换成本
- 隔离安全执行：基于 git worktree 创建临时工作区，主分支始终不受污染，执行后自动清理
- 双模型协同：Claude 负责规划与 PR（需要理解力和表达力），Codex 负责执行与审查（需要代码生成能力），分工合理
- 远程友好：支持 SSH 到高配服务器运行，本地设备零负载，适合大模型推理资源消耗场景
- 可定制流水线：通过
CLAUDE.md注入团队规范，或修改 prompts 文件调整各阶段行为
潜在缺点与局限性
- 生态依赖重：必须同时安装 Bun、Claude Code CLI、Codex CLI、GitHub CLI，且需配置双平台 API 密钥，门槛较高
- 成本不可控：默认使用 Claude Opus + GPT-4.5 Codex 等高阶模型，长任务可能产生显著 token 费用，虽有超时保护（默认单步 20-60 分钟）但仍需预算管控
- 审查闭环缺陷：Codex 自审存在「盲区」风险，无人类最终把关即自动提 PR，可能引入 subtle bugs 或安全隐患
- SSH 模式隐患：需要长期维护服务器凭证与密钥，若配置不当存在横向移动风险
- 语言/框架局限：依赖自动检测安装 bun/pnpm/yarn/npm，对新语言或特殊构建链支持有限
适合人群
- 拥有标准化技术栈、追求 PR 吞吐量的中小工程团队
- 个人开发者希望将重复性编码任务「外包」给 AI 代理
- 已成熟使用 Claude Code / Codex 并愿意承担 API 成本的技术先锋用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 供应链风险 | 全局安装 npm 包，需审计 `oneshot-ship` 及其依赖 |
| 密钥泄露 | `~/.oneshot/config.json` 存储多平台 API 密钥，需严格权限控制（建议 600） |
| 代码质量风险 | AI 生成代码未经人类 review 即合并，可能引入业务逻辑错误或安全漏洞 |
| 基础设施风险 | SSH 长期连接与后台进程管理，需关注服务器资源耗尽与日志审计 |
| 供应商锁定 | 深度绑定 Anthropic / OpenAI / GitHub 生态，迁移成本较高 |