SuperAPI AI 工具集

codex-cli-yolo-task

编程与开发

查看项目

更新于 11-07 16:52

技能介绍

用途

该技能用于把一项编程任务交给独立的 Codex CLI 进程执行,且以 YOLO 模式运行(关闭沙箱与审批提示)。仅当用户明确要求这种单独运行方式、并明确指出项目文件夹时使用;若任一条件不清楚,应先询问再启动。

主要能力与约束

  • 仅使用用户指定的项目文件夹,并验证其存在且为目录;不从当前工作目录推断,也不自行创建,除非用户明确要求新建项目或该文件夹。
  • 启动前用 codex exec --help 检查 CLI 支持的参数:优先 --yolo;若不支持但支持 --dangerously-bypass-approvals-and-sandbox,则使用该完整参数;两者都无则停止并报告不兼容,不替换为其他模式。
  • 保持 CLI 默认模型与配置,不传 -m/--model,不通过 -c 设置模型,不切换 profile。
  • 提示词基于用户任务整理,仅移除针对助手的工具选择/启动说明,保留请求的工作、路径、约束和偏好,不扩写为详细规格或增加需求。
  • 明确 YOLO 模式会关闭沙箱与审批;--cd 只设置工作目录,不限制文件访问,因此不能把项目文件夹描述为安全边界。

使用方式

将提示词、JSONL 执行日志和最终回复一起保存到当前工作目录下的 codex-prompt-log-result(或用户指定的其他产物目录)。文件名含时间戳(YYYYMMDD-HHMMSS),不为每次运行创建子目录。使用 --json 输出事件日志,用 --output-last-message(或 -o)指定最终回复文件,stdout 与 stderr 都重定向到日志,提示词通过 stdin 传入。示例流程:

PROJECT_DIR="/absolute/path/to/the/project"
RUN_STAMP="$(date +%Y%m%d-%H%M%S)"
RUN_DIR="$PWD/codex-prompt-log-result"
PROMPT_FILE="$RUN_DIR/prompt-$RUN_STAMP.md"
LOG_FILE="$RUN_DIR/execution-$RUN_STAMP.jsonl"
RESULT_FILE="$RUN_DIR/result-$RUN_STAMP.md"
mkdir -p "$RUN_DIR"

cat > "$PROMPT_FILE" <<'PROMPT'
<the user's task with only tool-selection instructions removed>
PROMPT

if codex exec --yolo \
  --cd "$PROJECT_DIR" \
  --json \
  --output-last-message "$RESULT_FILE" \
  - < "$PROMPT_FILE" \
  > "$LOG_FILE" 2>&1; then
  CLI_EXIT=0
else
  CLI_EXIT=$?
fi

若 codex exec --help 仅显示 --dangerously-bypass-approvals-and-sandbox,则用它替换 --yolo。

执行后处理

记录退出码与产物路径;不打开、读取、分析、引用或总结执行日志。结果文件存在则读取并把内容返回给用户(即使 CLI 退出不成功);不存在则如实说明,不检查日志。不自动删除提示词、日志或结果;用户要求清理旧运行时,只删除本技能在 codex-prompt-log-result 中的产物,若“旧”不明确需先确认日期范围。

适用场景

适合用户已明确授权关闭沙箱与审批、并指定项目目录的单次编程任务委派。

限制

不建议在用户未明确要求 YOLO 模式或未指定项目文件夹时使用;不得把项目文件夹当作安全隔离边界;不要在未获请求时通过 CLI 运行测试或其他检查。最终回复只报告实际发生的操作与检查,包含项目路径、CLI_EXIT、所有产物路径以及结果文件内容(或说明未创建结果文件)。