SuperAPI AI 工具集

run

编程与开发

查看项目

更新于 10-29 06:18

技能介绍

用途:该技能让主会话充当协调者,把任务分派给独立的规划、测试、编码和审计角色,而不是在一个上下文中模拟所有角色,用于构建功能或修复缺陷。

主要能力:

  • 角色化流程:scout(调研)、planner(规划)、tester(测试)、coder(编码)、auditor(审计)、consultant(咨询)、releaser(发布,仅在用户单独请求时使用)等七类 dev_team_* 代理。
  • 仓库画像与尺寸选择:根据 git 状态、改动范围选择 small 或 standard;small 仅用于一两个文件且不涉及接口或持久化数据变更。
  • 测试优先闸门:tester 阶段要求每个新测试在缺失行为下失败,或记录为人工验证标准。
  • 有限纠正轮次:规划审计失败允许一次规划修订与一次重审;测试失败允许一次纠正;有效的差异审计失败最多两轮编码修复,每轮后重新审计。状态脚本强制执行这些上限。
  • 状态与证据记录:run-state.mjs 创建运行目录、记录阶段结果、保存报告原文、维护测试路径快照并检查测试文件是否被改动。

使用方式:

  1. 前置条件:要求 .codex/dev-team.md,缺失时建议运行 dev-team:init;执行 node "PACKAGE/scripts/doctor.mjs" --cwd "REPOSITORY",并在新会话中发现全部七个 dev_team_* 代理;使用父客户端常规 workspace-write 权限。
  2. 在主会话中执行一次 printf DEV_TEAM_GUARD_PROBE,要求钩子拒绝并指出 main;各角色也独立执行自己的探针。
  3. 检查 git status --porcelain,脏工作区需说明并取得同意后才传 --allow-dirty;读取画像中的规划审计设置(缺省自动)。
  4. 用 run-state.mjs start 启动,保存 task.md,使用显式代理类型与全新上下文(fork_context: false 或等效无历史选项)分派,禁止通过 spawn 请求覆盖 TOML 中固定的模型与投入。
  5. 按流程记录各阶段结果,pass 表示达到闸门而非代理返回;fail 为普通闸门失败,error 立即停止。
  6. 审计只接收精确的规划路径和变更范围,不传测试/编码报告、摘要或父上下文;默认使用原生 Codex 执行,用户明确选择时才用 codex-audit.mjs。
  7. 中断后检查 run.json、报告、Git 状态与测试哈希,先停止所有活动角色再用 abort 终止,保留报告并说明重启要求。
  8. 结束输出步骤/角色/报告/结果表、最终闸门命令与退出码、审计引擎/模型/投入、未解决问题和运行目录。

适用场景:需要在 Codex 环境中以多角色、测试优先、带审计和纠正上限的方式完成小型到标准规模的功能开发或缺陷修复。

限制:依赖 PACKAGE 目录结构与相关脚本;缺少 .codex/dev-team.md、doctor 检查失败、代理发现不全或探针未按预期拒绝时均会停止;不支持 claude 引擎(该移植中明确失败);不支持 Full Access/bypass 沙箱模式;不存在自动恢复或锁抢占;发布不是自动阶段。