Ultracode

这是什么

/ultracode 是一个纯知识型 prompt skill：调用时把一段固定的 「Workflow Orchestration Playbook」文本注入当前上下文。它的实现是 src/skills/bundled/ultracode.ts 里的 registerUltracodeSkill()， 通过 registerBundledSkill 注册为一个 userInvocable 的 prompt 命令。

它注入的手册覆盖这些内容：

• 何时该用 Workflow 工具（显式 opt-in 的五种情形）、何时不该用；
• 编排原语速查：agent / parallel / pipeline / phase / log / workflow；
• 质量模式库：adversarial-verify、judge-panel、loop-until-dry、multi-modal-sweep、 completeness-critic；
• 脚本执行约束：纯 JavaScript、禁 import、禁 TypeScript 语法、 禁 Date.now() / Math.random()；
• 恢复与预算：resumeFromRunId / journal 重放 / budget 消耗；
• 并发与模型分层：默认并发 3、上限 16、按任务选择 haiku / sonnet / opus。

它不改变主循环、不切换任何行为开关、零运行时副作用。真正执行脚本的是 Workflow 工具 （见 Workflows），查看实时进度的是 /workflows 面板。

前置条件

安装启用

1. 确认 skill 已随 CLI 注册

   编译进 CLI 后无需安装，会话里直接输入 /ultracode 即可。它是 bundled skill， 所有用户可用。

2. 确保 Workflow 工具已开启

   Build 产物默认包含 WORKFLOW_SCRIPTS。dev 模式可用环境变量显式开启， 以便实际调用 Workflow 工具：

   Terminal 复制

   # dev 模式手动开启工作流脚本特性
   FEATURE_WORKFLOW_SCRIPTS=1 bun run dev

3. 在会话中调用手册

   输入 /ultracode 注入手册；可带一段描述，参数会追加到手册末尾的 ## User input 段落。

   qsdashi 会话 复制

   /ultracode 审计 auth 模块的正确性与并发安全
   # → 手册 + 你的输入一同进入上下文，模型据此决定是否调用 Workflow 工具

4. （可选）用 /workflows 观察执行

   模型发起 Workflow 后，用 /workflows 面板实时查看 phase 与 agent 进度。

手册内容与约束

手册为模型规定了下面的行为边界，调用即生效，无需额外配置：

常用命令与参数

手册并不直接接收参数，它引导模型生成如下 Workflow 工具输入（字段定义以引擎包 schema 为准）：

实战示例

手册建议：先用内联脚本，调用后 Workflow 会自动把脚本落盘并把路径写回工具结果， 之后用 Write/Edit 改这个文件、以 scriptPath 重新调用即可迭代。

# 1. 注入手册，带上本次任务范围
/ultracode 审查本次改动，逐条对抗式验证

# 2. 模型据手册发起 Workflow（示例脚本见下）
#    工具结果返回 run_id 与脚本落盘路径

# 3. 打开面板看实时进度
/workflows

# 4. 改脚本后用 scriptPath + resumeFromRunId 续跑

一段符合手册约束、可真实运行的命名 workflow 脚本骨架：

export const meta = {
  name: 'review-changes',
  description: '按维度审查改动，并对抗式验证每条发现',
  phases: [{ title: 'Review' }, { title: 'Verify' }],
}

const FINDINGS_SCHEMA = {
  type: 'object',
  properties: {
    findings: {
      type: 'array',
      items: {
        type: 'object',
        properties: {
          title: { type: 'string' },
          file: { type: 'string' },
        },
        required: ['title', 'file'],
      },
    },
  },
  required: ['findings'],
}

const VERDICT_SCHEMA = {
  type: 'object',
  properties: { isReal: { type: 'boolean' } },
  required: ['isReal'],
}

const DIMENSIONS = [
  { key: 'bugs', prompt: '通读 git diff，找出正确性 bug' },
  { key: 'perf', prompt: '通读 git diff，找出性能问题' },
]

// pipeline：每个维度独立走 Review -> Verify，阶段间无屏障
const results = await pipeline(
  DIMENSIONS,
  d => agent(d.prompt, {
    label: `review:${d.key}`,
    phase: 'Review',
    schema: FINDINGS_SCHEMA,
  }),
  review => parallel(
    (review && review.findings ? review.findings : []).map(f => () =>
      agent(`对抗式验证这条发现的真伪：${f.title}`, {
        label: `verify:${f.file}`,
        phase: 'Verify',
        schema: VERDICT_SCHEMA,
      }).then(v => ({ ...f, verdict: v }))
    )
  )
)

const confirmed = results
  .flat()
  .filter(Boolean)
  .filter(f => f.verdict && f.verdict.isReal)

log(`确认 ${confirmed.length} 条发现`)
return { confirmed }

常见问题排错