SuperAPI AI 工具集

codex-session-controller

智能体与模型

查看项目

更新于 10-16 03:16

技能介绍

用途 该技能把会话确立为一个协调角色,分为全局与项目两种范围。全局协调者在用户范围内协调多个项目与独立任务,发现已有相关工作、给出带理由的优先级建议、处理跨项目依赖与资源冲突,并通过项目现有负责人推进执行。项目协调者负责项目方向、依赖、集成与约定的交付,既可以是主线任务本身(设计、实现、评审、测试或委派),也可覆盖非代码成果。

主要能力

  • 角色确立与恢复:依据用户指派、已接受的交接或会话历史确定角色;pre-compaction 的 controller 标题可恢复既有角色。普通编码工作、加载技能或 worker 简报提及 controller 本身不改变角色。
  • 事实与索引:使用任务工具返回的 (hostId, threadId) 与 (hostId, projectId) 定位工作;在任务记录或控制文档中维护小索引,包含范围与成果、直接负责人与证据链接、跟进选项、排期、依赖、资源占用及下一步行动,并在重大变化后刷新。
  • 执行与委派:按指派和现有负责人选择直接执行或委派;任务内有限工作使用 spawn_agent,独立工作使用用户可见的既有任务或新建任务,创建时用 list_projects 解析已保存项目。派发后需核验目标身份、上下文与可用访问权限。
  • 协调与集成:操作任务前先读其最新用户决策与进展(优先于过期索引);正常进展不发消息;被用户暂停的工作保持暂停;对已验证的错误、目标不符或未满足依赖,向现有负责人提供事实由其选择补救。按实际归属与释放条件解决资源冲突。对照分配成果评估结果,按消息/回合定位或来源、主张与证据去重。
  • 报告与生命周期:报告匹配请求,全局摘要先给出有用成果、用户决策、可行动的依赖或优先级建议,并说明覆盖范围与不确定性;非当前任务以 <title> 形式链接并附 hostId 与下一步证据。

跟进模式 Mode 决定协调者如何检查或接收其直接用户可见子任务的结果,两种角色均按用户选择执行,默认 Poll。Poll:用户要求检查状态或结果时读取相关任务;Scheduled:用户明确要求定时检查,由计时器唤醒;Callback:用户明确要求事件报告,子任务向直接负责人报告。可同时选择 Scheduled 与 Callback。controller 自身执行构建或测试的授权并不选择计时器或 Callback。

限制与说明 一个范围只保留一个活动协调者,从指派或既有记录恢复该范围;全局范围可覆盖一台或多台机器,已知单机为自然默认,多机且意图不明时可先简短询问范围。一次性任务只做有界检查或操作,不承担持续责任;仅观察不构成接管或恢复工作的授权。优先级建议只有在用户授权范围内才改变进行中的工作。细节见 references/return.md、references/delivery.md、references/closure.md、references/handoff.md,配套技能为 codex-session-naming 与 codex-async-followup。资料未提供具体安装命令、收费或平台支持信息。