Community编程与开发github.com

dehtiarone/升级子智能体

用于修复仓库错误、实现功能或进行仓库变更。该技能协调发现、实施和独立验证,并通过有界模型升级机制进行管理;将简单的编辑任务路由给单个工作线程。

升级子智能体 是什么?

该技能专为像Codex这样的AI代理设计,提供了一种结构化的多阶段方法来完成仓库变更任务。它通过“升级阶梯”(ladder of escalation)分配不同复杂度的任务(从简单的A级到高风险变更的D级),从而优化资源利用。核心工作流程包括发现(Discover)、实施(Implement)和验证(Validate)阶段,每个阶段由单独的代理实例处理,严格禁止任务委派或技能重入。技能还包含详细的预算管理、调用追踪和升级规则,以处理不完全的工作、错误的诊断或环境故障。它支持特定的平台(如Codex)和模型(如gpt-6.1-sol),并利用原生代理生成函数(如`spawn_agent`)以及一个基于Bash的辅助脚本进行Git快照,以确保状态一致性和原子性。该技能特别适用于需要严谨过程验证的高风险变更,如涉及认证、数据隔离或生产数据的变更。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dehtiarone/skills/tree/main/codex/skills/escalating-subagents

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

面向Codex的升级子智能体

推荐协调器:gpt-6.1-sol(低努力)。保留父级选定的模型;此技能不会更改模型。主代理统筹协调:选择层级,定义验收标准,向工作线程简报,检查交接,分类,并报告。它从不编辑产品代码。从简洁的报告(最多30行)、范围差异和证据路径开始;在证据缺失、有争议或不足以应对D级风险时,检查更多代码或运行检查。不要机械地在未更改的补丁上重复检查。

工作线程执行分配的一个阶段,从不委派或调用此技能。尊重主机权限和协作模式;计划模式不允许实施或产生变更的发现。

层级

在第一个进度行中命名层级。任何阶段都可以升级层级;永不降级。升级时,保留计数器,使用更高层级的总预算,并修改每个受影响工作线程的标准。对于D级,将发现/验证至少提升到第3阶;永不降低现有阶数。在进行进一步实施之前,执行新要求的发现。

层级工作流程起始阶数
A简单、完全指定、低风险编辑,带有具体检查实施;交接取代验证1
B受益于委托的明确变更实施 → 验证两者均为1
C不明确的错误或重要功能;默认发现 → 实施 → 验证全部为1
D认证、租户隔离、迁移、队列/同步、生产数据变更发现 → 实施 → 验证发现/验证为3;实施为1

阶段与检查

  1. 验收标准 - 父级: 在分发前定义“完成意味着”。A/B级从请求中推导检查和预期结果;C/D级在发现后完善草稿。实施和验证接收相同的标准和原始请求。
  2. 发现 - C/D级: 确认范围或重现问题。不允许产品编辑;但明确允许创建自有的重现/测试文件。报告原因/范围,包括位置、证据、建议标准和未决问题。对于只读发现,在简报中禁止仓库编辑并验证范围;不要发明每代理沙箱设置。
  3. 实施: 仅编辑自有文件;报告编辑内容、命令、退出状态和未完成的工作。
  4. 验证 - B/C/D级: 一个未参与实施的新的代理根据请求、规格和标准检查集成的补丁。不允许仓库编辑或新的回归测试;为实施提出缺失的测试。允许草稿报告和正常的测试工件。报告每个标准的证据和未测试的区域。

在提交命令之前,先进行飞行前测试先决条件检查。仅在覆盖范围相当时,才优先选择可行的替代方案。永远不要因为仅仅为了获得PASS而用单元测试替代所需的集成、端到端、视觉或设备证据。将受阻的必需检查纳入最终结果;不要假设任何特定的测试运行器能在沙箱中运行。仅在具体修复后重试环境故障。

发现/实施返回DONE、PARTIAL或BLOCKED。验证返回PASS、FAIL、BLOCKED或INCONCLUSIVE。每次调用的时间预算:A/B级10分钟;C/D级25分钟。在达到限制时,返回PARTIAL或INCONCLUSIVE,并附上已完成的工作、证据、未完成的检查和下一步骤。

阶梯与调度

阶数模型reasoning_effort
1gpt-6-lunamedium
2gpt-6-lunamedium
3gpt-6.1-sollow
4gpt-6.1-solmedium
5gpt-6.1-solhigh

第2阶是在特定纠正证据下对Luna的全新重试。Sol的low在应用中代表Light,不是一个额外的阶数。 对于具体的遗漏或对简报的误读,前进一个阶数;第2阶是在升级到更强模型之前的单一遗漏重试。对于第1阶或第2阶确认的推理失败,直接跳到第3阶。在第3阶或更高阶,前进一个阶数。下面的“升级”即指此规则。当不充分的工作耗尽了第5阶时停止。有成果的延续和已纠正的环境故障不会前进阶数。不要在没有具体纠正的情况下重试相同的失败方法;改为升级。这不禁止有成果的延续。

使用暴露的Codex模式:spawn_agent,带唯一的task_name、完整的简报在message中、显式的model、reasoning_effort以及在支持情况下的fork_turns: "none"。不要为覆盖使用全历史分支。报告不兼容的控制,而不是更改全局配置或通过嵌套CLI绕过它们。对同阶延续使用followup_task,对模型/努力级别变更使用全新的生成。等待/监听调用不会创建额外的免费分配。中断超时的工作线程,并确保在继续之前停止写入。 记录请求的和可观察的有效设置;当有效值未暴露时使用unavailable。从不静默替换不可用的模型或设置。在简报中保留证据路径,而不是复制完整的记录。重试的简报需命名纠正/假设,并说继续补丁或替换这些块。

核算与分类

分别跟踪每个阶段/工作项的调用总数、每阶段调用次数和阶数。每个新的工作分配、重试或延续算作一次调用;状态消息和等待不算。并行工作线程和基线测试工作线程单独计算。在支持时,为每个分配的作业或延续创建一个运行时任务列表条目;更新它不算作调用。正确的验证FAIL是成功的验证,不是升级验证器的理由。在选择行之前诊断失败。

发现下一步操作计数
工作不充分使用证据升级相关阶段调用 + 阶数前进/跳转
PARTIAL,且方法合理且有进展在同一阶数继续调用
在同一阶数的第二次PARTIAL,或无进展证据升级该阶段调用 + 阶数前进/跳转
错误诊断升级发现;之后修改实施简报调用 + 阶数前进/跳转 (发现)
验证FAIL是错误的父级使用记录证据进行纠正,或升级验证;不要更改实施纠正不算;重新验证算调用 + 阶数前进/跳转
验证FAIL正确识别了不充分的实施升级实施,然后以其当前阶数进行全新的验证调用 + 阶数前进/跳转 (实施), 调用 (验证)
验证超时,但列出了已完成的检查在未完成检查上继续其当前阶数调用
环境故障或缺少先决条件在授权范围内修复,然后重试一次;如果未解决则停止重试算一次调用;阶数不变
阻碍性歧义改变了“完成”或D级风险询问用户;指明阻碍者无

父级纠正不会免除检查:接受需要每个标准都有证据。仅当验证器从未实施且补丁未更改时,才在同一代理中继续验证。修复后,使用全新的验证器。在第5阶的正确FAIL不会耗尽验证器;对实施进行分类。

预算: A级 3次调用;B级 4次;C/D级 8次。在分派前检查:剩余调用必须覆盖所有提议的工作线程,外加其工作需要时的一次最终验证。验证本身只需要它自己的调用。允许还剩一次调用+最终验证;允许还剩两次+一次实施;不允许还剩两次+两次实施。仅在所有必需工作仍然适合时才减少批次。在发现后保留实施和验证。升级后重新检查。

最后一次允许的调用可以成功完成任务。否则在无法承担的工作前停止,在最终阶数失败时停止,或针对未解决的阻碍者停止。从不静默省略必需的工作或在关键的验证待处理时声称完成。普通的实施选择无需询问用户;记录它们。

快照和交接

仅父级运行下面的嵌入式Bash/Git快照脚本。不需要伴随文件。使用umask 077创建${TMPDIR:-/tmp}/escalating-subagents/,然后使用mktemp -d在那里创建一个唯一的task.XXXXXX目录。使用以下命令提取标记块,切勿重新输入(SKILL是本文档的绝对路径,TASK是任务目录):

sed -n '/^<!-- agent-snapshot:start -->$/,/^<!-- agent-snapshot:end -->$/p' SKILL | sed '1,/^```bash$/d;/^```$/,$d' > TASK/agent-snapshot.sh

其SHA-256(shasum -a 256或sha256sum)必须是ddc6cd474ae00cb7fc7613deefb4a9f5ff959f6b641abf041f1a7e26d7d8ca95;不匹配是阻碍者。对快照单独使用<task>/state。不要将脚本放在最初为空的状态目录中。使用Bash运行它,切勿source它。

在父级账本中记录绝对仓库、辅助脚本和状态路径;在每次调用时显式传递它们,不要依赖跨命令的shell状态。工作线程永不运行辅助脚本或接收其控制路径。在任何分派前成功初始化;报告初始化错误并停止,仅在权限导致时才识别沙箱阻碍者。下面的大写单词是占位符;引用实际路径:

bash HELPER init REPO STATE
bash HELPER capture STATE base
bash HELPER capture STATE pre-1
bash HELPER capture STATE post-1
bash HELPER diff STATE pre-1 post-1 names0
bash HELPER diff STATE pre-1 post-1 stat
bash HELPER diff STATE base post-1 patch

base捕获一次,pre-N在每次分派/批次前立即捕获,post-N在所有工作线程及其写入完成后捕获。将集成补丁输出存储在草稿证据中。命名快照是不可变的。状态持久化树ID和临时索引/对象;实际的索引/对象数据库不变。包含已跟踪的忽略文件和非忽略的未跟踪文件。不要使用git diff HEAD作为替代。

辅助脚本失败是阻碍者。它拒绝并发写入;不要删除锁,除非其记录的进程已确认停止。中断的未发布捕获不能替换命名快照。保留状态直到报告和任何预期后续完成。

使用NUL分隔的更改路径进行范围检查,使用stat进行摘要,使用集成补丁进行验证。超范围的编辑被拒绝,除非父级为合法的依赖项显式扩展所有权。保留不相关的工作;从不自动重置、清理、暂存或还原它。

在可用容量内一起调度不冲突的实施工作线程。对于每个批次,与所有权联合进行比较;报告提供单个归属,而非作者证明。在检查范围或验证之前等待整个批次。串行化共享文件/基础设施和会污染快照的不相关的并发写入者。

在交接处验证命令结果、证据路径、引用的位置和文件状态相关性。新编辑会使受影响的检查失效。已接受的工作前进;被拒绝的工作返回分类。跟踪长时间运行的命令直到完成,并在快照前停止未完成的写入;后台启动不是完成。

仓库约束与简报

阅读适用的AGENTS.md、范围说明、规格和设计指南。使用仓库的包管理器、锁定、依赖版本、迁移和文档策略。将生产数据约束显式地纳入相关工作线程简报,包括实时数据和仅追加要求;不要依赖工作线程间接发现它们。

工作线程从不提交、推送、部署或执行不相关的外部写入。仅当仓库和主机规则允许时,父级才可执行显式请求的操作。

每份简报包括:任务、层级、原始请求、绝对仓库/指令/证据路径、模型/努力级别、逐字标准、所有权、命令超时、挂钟预算、生产数据约束,以及“不要委派、调用此技能或运行快照辅助脚本”。

  • 发现: 相关路径,如果重试则提供之前的报告;除明确授权的重现/测试文件外,不拥有任何内容。不允许产品编辑或安装。报告结果、原因/范围、位置、证据、建议标准、待定点和下一步…

(由于原文被截断,此处翻译基于可用的完整内容。省略号表示原文后续内容未提供,因此无法翻译更多细节。)

相关技能