Subtask4LLM 是一个面向 Codex 的多步骤软件变更工作流技能。核心思路是让当前 Codex 会话承担规划者与审核者角色,不直接修改目标源码,而是把经授权的工作拆成有序步骤,交给独立的 codex exec 工作进程逐个实现。
用途与适用条件
适用于包含多个有序交接、需要独立上下文的多步骤修改。资料明确要求:不要仅为使用该技能而拆解一个小改动。每个步骤需有边界清晰的任务、可观察的验收标准,且只能依赖更早的步骤。
规划方式
规划者先检查仓库,将工作转化为 2–10 个具体步骤。由于工作进程无法访问规划者对话,计划中需写入相关用户需求、决策、仓库发现、文件路径、架构、约束、边界情况与实现指导;跨步骤通用信息放在共享上下文中,步骤特有细节放在该步骤的上下文里。计划需按 references/plan-format.md 创建 v1 JSON 临时文件,并用 --dry-run 校验。
执行方式
在目标仓库中运行:macOS/Linux 使用 python3 <skill-path>/scripts/run_workflow.py <plan.json> --workspace <repository>;Windows PowerShell 使用 py -3 <skill-path>\scripts\run_workflow.py <plan.json> --workspace <repository>。默认沿用当前 Codex 会话模型并用 --model 传入确切 ID;用户显式配置 CODEX_WORKFLOW_MODEL 时遵循该配置;两者都不可用则省略 --model,由 Codex CLI 使用其配置模型。启动前应在对话中简要展示目标与步骤清单及依赖,然后立即启动,不等待确认。
运行约束与选项
工作进程在同一工作区中一次只运行一个,每个进程都是全新的临时 Codex 会话,仅接收共享上下文、完整流程地图、自身任务与验收标准,以及计划中指定依赖的详细结果;依赖结果有可配置字符上限。编排器会为子进程禁用该技能本身,设置 CODEX_WORKFLOW_CHILD=1 与 CODEX_WORKFLOW_DEPTH=1,并在检测到子进程标识时拒绝运行;子进程提示禁止启动 Codex、子代理或该编排器。工作进程使用 --yolo,会禁用沙箱与审批提示,可能访问工作区外的文件和网络,因此仅应在外部隔离环境中使用。
可用参数包括:--artifacts-dir 保存持久化提示、结果与诊断(可能含敏感信息);--continue-on-error 允许某步失败后继续执行后续步骤,但最终状态仍报告失败;--live-log 指定实时日志路径(默认在系统临时目录,工作区外),运行开始时打印日志路径与可复制的 tail -f 命令;--timeout-seconds 与 --timeout-checkpoint-seconds 调整 30 分钟硬限制与 10 分钟检查间隔。超时与检测到的停滞命令不重试;非超时失败可使用一次重试。失败尝试可能留下部分编辑,编排器不会重置或回滚工作区。
审核与限制
运行结束后,规划者需审阅最终报告与实际工作区差异,执行相称的最终验证,再报告结果、变更文件、检查项与未解决风险。不得委托部署、发布、消息、迁移、购买等非幂等外部效应;不得添加破坏性操作、外部发布、凭据使用或原请求未授予的权限;同一工作区不得并发运行两个工作流。该技能的环境守卫只防止通过本工作流意外递归,并非操作系统安全边界;如需强隔离,需外部沙箱、可执行文件白名单或包装策略。
暂未提供:具体收费、价格、平台与效果数据。