⚡

云端任务启动器 puff

这个技能是一个命令行工具，用于启动和管理Codex Cloud的云端任务，支持后台执行、状态监控和结果应用，提高开发效率。关键词：云任务管理、CLI工具、Codex Cloud、后台执行、任务监控。

DevOps 0 次安装 0 次浏览 更新于 3/8/2026

name: 云端任务启动器 description: 从命令行界面启动和管理Codex Cloud任务，包括分离的后台观察器来跟踪完成。当用户要求在云/后台代理中运行编码工作、排队多个云任务、轮询任务状态、获取云差异、本地应用云输出或与$cas编排配对时使用。

云端任务启动器

概述

使用此技能来启动Codex Cloud任务而不阻塞本地CLI会话。使用捆绑的包装器提交工作、分离状态观察器，并保留日志/结果以供后续差异/应用操作。

工作流程

  1. 确保ChatGPT认证存在。 codex login
  2. 解析技能路径（.codex主路径，.claude备用路径）。
CODEX_SKILLS_HOME="${CODEX_HOME:-$HOME/.codex}"
CLAUDE_SKILLS_HOME="${CLAUDE_HOME:-$HOME/.claude}"
PUFF_SCRIPT="$CODEX_SKILLS_HOME/skills/puff/scripts/puff.sh"
[ -f "$PUFF_SCRIPT" ] || PUFF_SCRIPT="$CLAUDE_SKILLS_HOME/skills/puff/scripts/puff.sh"
  1. 运行准备检查。 "$PUFF_SCRIPT" doctor --env <env-id-or-label> 可选：打印手动环境创建说明。 "$PUFF_SCRIPT" create
  2. 启动云端工作并分离观察器。 "$PUFF_SCRIPT" launch --env <env-id-or-label> --prompt "实现X" 可选：启动云连接操作符提示（seq -> join）用于PR补丁路由。 "$PUFF_SCRIPT" join-operator --env <env-id-or-label> --repo <owner/repo> --patch-inbox <locator> 金丝雀模式（单次有界循环）： "$PUFF_SCRIPT" join-operator --env <env-id-or-label> --repo <owner/repo> --patch-inbox <locator> --canary
  3. 检查运行中和已完成的观察器作业。 "$PUFF_SCRIPT" jobs
  4. 需要时尾随观察器日志。 tail -f <watch_log_path>
  5. 准备就绪时检查或应用结果。 codex cloud diff <task-id> codex cloud apply <task-id>

命令选择

使用launch进行异步/后台执行。 launch默认运行doctor；传递--skip-doctor以绕过预检查。 当仅需要格式化的手动环境创建说明时使用create。 当仅需要任务ID/URL时使用submit（它执行云任务）。 用于显式认证/环境准备检查时使用doctor。 用于阻塞前台轮询时使用watch。 使用jobs和stop来管理分离的观察器。 使用join-operator来生成和启动云连接循环提示，强制执行清单优先路由和seq -> join执行。 使用join-operator --max-cycles <n>进行有界运行；--canary是单次循环的简写。

与$cas的互操作

当编排需求超出简单云任务生命周期控制时使用$cas。 用于快速云启动和生命周期轮询时使用$puff。 使用$puff cas-start / cas-stop从同一包装器管理$cas代理生命周期。 用于应用服务器线程/轮次编排、转向、转发服务器请求或复杂多线程路由时使用$cas。

注意事项

将环境ID或唯一环境标签传递给--env。 在观察循环中将READY和APPLIED视为成功的终端状态。 将ERROR视为终端失败，并使用codex cloud status <task-id>和codex cloud diff <task-id>检查。

资源

  • scripts/puff.sh：围绕codex cloud的创建/提交/观察/启动/作业/停止包装器。
  • scripts/puff.sh join-operator：云连接操作符提示的启动助手。
  • references/commands.md：命令映射，包括可选的$cas配对。