@coda-console/ultra

中文文档
1.2.2发布于 2026/10/31MITES Module零依赖构建来源已验证

输入框的 Ultra 协调模式:节省主 Agent 的 Token 和上下文,非微小任务的执行默认交给 Coda 子会话,串行任务也委派。主 Agent 负责决策、调度和验收。名单在模式参数里改,常用的存成模板。

此软件包已被标记为弃用

已并入 @coda-console/composer(输入框模式),请改用它

中文使用文档

Ultra

Ultra 已并入 @coda-console/composer(输入框模式)。本包暂时保留,待 Coda 完成设置迁移后再处理;新插件的模板设置为 composer.templates。

输入框的 Ultra 协调模式(Coda 的输入框模式):在保持质量的前提下,节省主 Agent 的 Token 和上下文。 主 Agent 负责定义任务、困难决策、调度和验收,非微小任务的主要执行工作按名单用 spawn 派给 Coda 子会话;关键路径和需要串行执行的任务也委派。 只有整个请求已经明确、简短答复或一次显然的局部操作就能完成时,主 Agent 才直接做,例如已知位置的错字或简单状态查询。 不能把复杂任务拆成单条命令逐个自己执行;小任务一旦需要排查或调试,就交给子会话。

从 Coda 的商店安装(npm 包 @coda-console/ultra,分类「工作流程」),不随 Coda 默认装上。Coda 不认识 Ultra:模式、参数、给 Agent 的话都在这个插件里。

用法:会话或新任务的输入框里打 /ultra(或在 / 菜单、iPhone 的「+」里选),输入框进入 Ultra;在新任务里进入,发出第一条后开出的会话就在 Ultra 里,模式条上写着所选的模板和名单里 Agent 的图标;点模式条打开参数:

参数是什么
模板设置 ultra.templates 里的模板,加「自定义」;选一个就把名单换成它的,手动改了名单就变成「自定义」。进入时取排第一的模板;没有模板时为「自定义」,名单为空
子 Agent名单,一行一个:Agent 组合(Agent、模型、推理强度、配置项)和「什么时候派给它」。名单为空或名单里没提到的活,Agent 用自己的 Agent 和模型派

模式开着时发的每条消息照常发给这个会话,工具栏上的 Agent 和模型不变;点 × 退出。

告诉 Agent 什么(ultra.mjs,经 Coda 的「顺带告诉」随下一轮带上):

  • 开着后发的第一条,以及参数改过之后的第一条:进入协调模式,原先「没要求就别派」不再适用;用户明确修改规则时优先,普通的实现请求不算解除协调职责。附上名单,一行一个,写成 spawn 要的 agent、model、effort、mode、options。
  • 主 Agent 定义任务、处理困难决策、约定验收标准、选择执行者、检查证据并汇总。多文件修改、重构、调试、评审、详细规划、研究和验证默认委派;实现、编写测试、运行测试或构建及失败修复也交给子会话。微小任务例外按整个请求判断,为调度和验收做少量定向阅读、只读抽查可以。
  • 子任务具体、自包含,给出相关背景、验收标准和不与其他执行中会话重叠的写入范围;相关工作交给同一个执行者,后续修正复用它。子会话回传简短结论、文件或来源、实际验证结果和未解决问题,不回传大量日志。
  • 主 Agent 在交接任务里明确子会话是执行者,自己完成任务,不继承主会话的协调职责;没有明确指派就不继续转派,获准转派也走 Coda。结果自动回来,主 Agent 不重复子会话的搜索、修改和常规检查。
  • 委派只走 Coda 的 spawn,即使用自己的 Agent 和模型,也创建 Coda 子会话;除非用户明确要求,不用运行时自带的子 Agent 或委派工具。
  • 之后每条模式内消息都带简短提醒:节省主 Agent 的 Token,非微小执行工作必须委派,串行和关键路径也适用,不能拆成单条命令自己做或重复子会话的工作;也提醒执行者分工、等待和只走 Coda 的规则。
  • 名单写得太长、连同说明超过 Coda 一次能告诉 Agent 的长度(4000 字)时,那条消息发不出去,界面说明原因;改短后再发就照常告诉。
  • 退出时撤销 Ultra 的优先委派职责和「委派只走 Coda」限定,恢复通常的执行与委派指令,Coda 子会话回到「有要求才派」;一条都没发过就不说。

同时在跑的子会话有多少由 Coda 管(「会话生命周期」插件的设置「同时执行的子会话」),满了 spawn 当场失败。 并发已满时等已有 Coda 子会话结束、腾出名额;spawn 不可用时说明阻塞,只继续不依赖它的协调工作。两种情况都不扩大微小任务例外或改用原生子 Agent。 这些职责和委派渠道仍是提示词约束,插件没有在运行时禁用主 Agent 的执行工具或原生子 Agent 工具。

设置 ultra.templates:一列行,每行「模板名、Agent、什么时候派给它」,同一个模板名的几行是一个模板。默认不带模板,子会话沿用当前会话的 Agent 和模型;用户可以自行添加、修改、删除模板。

测试在 test/plugins/ultra/。

委派范围与微小任务例外的基础文案采用 oh-my-claudecode 的委派规则, 适配 Coda 的 spawn 与名单,并补充节省主 Agent Token、串行委派和避免重复执行的要求。版权与 MIT 许可见 THIRD_PARTY_NOTICES.md,随 npm 包一同提供。

版本与发布记录

@coda-console/ultra 共发布 9 个版本,首次发布于 2026/10/30;过去 12 个月发布了 9 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.2.2latest2026/10/312 天前
1.2.12026/10/312 天前
1.2.02026/10/313 天前
1.1.22026/10/313 天前
1.1.12026/10/313 天前
1.1.02026/10/313 天前

其他发布通道:bootstrap → 0.0.0。

关于 @coda-console/ultra 的常见问题

@coda-console/ultra 是什么?

输入框的 Ultra 协调模式:节省主 Agent 的 Token 和上下文,非微小任务的执行默认交给 Coda 子会话,串行任务也委派。主 Agent 负责决策、调度和验收。名单在模式参数里改,常用的存成模板。注意:该包已被作者标记为弃用——已并入 @coda-console/composer(输入框模式),请改用它

如何安装 @coda-console/ultra?

在项目目录运行 npm install @coda-console/ultra,或使用 pnpm add / yarn add / bun add。

@coda-console/ultra 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/coda-console__ultra 是否存在。

@coda-console/ultra 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@coda-console/ultra 可以商用吗?

@coda-console/ultra 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@coda-console/ultra 还在维护吗?

最新版本 1.2.2 发布于 2026/10/31(2 天前);至今共发布 9 个版本,其中过去 12 个月发布了 9 个;首次发布于 2026/10/30。作者已将其标记为弃用,新项目建议寻找替代方案。