代码委派代理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_fa75b8b3/code-agent。
技能介绍
要解决的问题
Codex 主会话把需求理解、调研、诊断、设计、计划、审查和最终汇总都放在同一个上下文里,一旦开始创建或修改源代码、测试、配置、迁移、脚本、生成器输出或基础设施代码,长任务很容易污染主会话;如果还要在同一轮里继续做验证修复,反馈链路很难归因,失误也是全局性的。,code-agent 的做法是明确 写入委派:主会话继续负责理解、调研、诊断、设计、计划、审查和汇总,凡是创建或修改源代码、测试、配置、迁移、脚本、生成器输出、基础设施代码,以及为修复验证进行的补改,都交给实现代理执行。这个技能把分工固化为「主会话先形成自包含实现简报,实现代理再在范围内读写并验证」的流程。
技能如何工作
调用技能时,主会话先产出一份自包含实现简报,至少包含 目标、允许修改的范围、约束、验收标准和 验证命令。这份简报就是授权单元:调用技能即授权实现代理在范围内本地读写文件,并运行 非破坏性验证,不必每次确认;但对外写入、发布、推送、难以恢复删除或实质扩展范围,仍需要用户确认。
默认路径使用原生子代理:先检查当前可用的 子代理工具 schema,在一个创建调用中显式传入 model: "gpt-5.6-luna"、reasoning_effort: "max" 和 fork_turns: "none";任务提示只发实现简报,不继承完整会话历史,也不依赖默认模型或推理强度。显式 spawn 成功后即开始实现;原生路径不做 READY→JSONL→实现 两阶段握手,也不额外设置 turn_context 门禁。
收敛阶段等待代理完成,检查实际 diff 并运行适度只读验证。如果验证失败或只需要小范围修正,继续向同一个代理发送具体证据,而不是因为暂时没有输出就重复创建。最终报告要写清实现代理 ID、创建调用参数、修改文件、验证结果和剩余风险;只有存在实际运行记录(例如回退任务的 turn_context)时,才可以声明「已验证实际运行参数」。
适用边界与注意点
这个技能是给 Codex 工作流做委派边界,不是让主会话绕过授权:默认创建实现代理时,要在创建调用中显式固定 model: "gpt-5.6-luna" 与 reasoning_effort: "max",避免继承默认值。只有任务能拆成互不修改同一文件的独立部分时才考虑并行;测试失败、小范围补改和验证反馈应继续交给同一个代理。代理不可恢复、明显跑偏或上下文污染时,才新建代理。
原生创建失败时,用完全相同的 Luna/Max 参数重试一次,仍失败才进入回退路径,且不要再次向用户确认。自然语言指令必须满足假设:模型与推理强度通过模型工具的显式 model 与 reasoning_effort 传入,本技能总结适用于此情况;由于模型工具是 Agent Skills 注册表的一部分,读取清单后,可以通过读取 SKILL.md 来使用该技能。如果平台用任务状态或 turn_context.payload 提供/需要参数证据,回退任务也要接收同一份自包含实现简报;原生路径不执行 READY→JSONL→实现握手,extended check 也只适用于回退路径。若回退验证发现 model 与 thinking 覆盖未生效,不要让任务写代码,用相同参数重试一次,仍失败则报告平台限制。该技能只能在 Codex 根目录下使用,无法绝对保证参数被后端实际使用;不要使用子进程或 Shell 进程冒充模型委派。
使用场景
- Codex 主会话完成需求分析后,需要由实现代理按实现简报修改源码与测试。
- 当验证失败需要补改时,向同一实现代理发送证据,继续修复而不新建会话。
- 原生子代理创建失败后,用相同参数重试一次,仍失败才进入已保存项目的回退路径。
- 需要固定的模型与推理强度时,在创建调用中显式传入 `model` 和 `reasoning_effort`。
适合人员
- 在 Codex 中做长链路开发的工程师,希望把实现隔离出去、保持主会话干净。
- 构建或扩展 Codex 工作流的 Agent 开发者,需要明确代码写入委派与授权边界。
- 需要在团队内复现统一参数委派的工程师,希望依据真实运行记录验证模型设置。