chore(workflow): 工作流相关代码中文文案全部英文化

源码（src/workflow/ + packages/workflow-engine/src/）的中文注释、
用户可见错误消息、字符串字面量；测试文件的标题与注释；同步 6 条
硬编码断言到英文化后的错误消息。

Co-Authored-By: glm-5.2 <zai-org@claude-code-best.win>

Author: claude-code-best

packages/workflow-engine/src/__tests__/WorkflowTool.test.ts

@@ -48,7 +48,7 @@ function mockPorts(
   return { ports, events, runStatus }
 }
 
-test('call 返回 launch 消息并在后台完成', async () => {
+test('call returns launch message and completes in background', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports, runStatus } = mockPorts(
@@ -74,7 +74,7 @@ test('call 返回 launch 消息并在后台完成', async () => {
   }
 })
 
-test('inline script 持久化到 run 目录，返回真实 scriptPath', async () => {
+test('inline script persists to run directory, returns real scriptPath', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports } = mockPorts(
@@ -102,7 +102,7 @@ test('inline script 持久化到 run 目录，返回真实 scriptPath', async ()
   }
 })
 
-test('缺少 script/name/scriptPath → 返回错误（不进后台）', async () => {
+test('missing script/name/scriptPath → returns error (does not enter background)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports, runStatus } = mockPorts(dir, new Map())
@@ -115,7 +115,7 @@ test('缺少 script/name/scriptPath → 返回错误（不进后台）', async (
   }
 })
 
-test('脚本语法错 → 返回校验错误（不进后台）', async () => {
+test('script syntax error → returns validation error (does not enter background)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports, runStatus } = mockPorts(dir, new Map())
@@ -126,14 +126,14 @@ test('脚本语法错 → 返回校验错误（不进后台）', async () => {
       undefined,
       undefined,
     )
-    expect(res.data.output).toMatch(/校验失败|Error/)
+    expect(res.data.output).toMatch(/validation failed|Error/i)
     expect(runStatus.size).toBe(0)
   } finally {
     await rm(dir, { recursive: true, force: true })
   }
 })
 
-test('name 解析到 .claude/workflows/<name>.ts', async () => {
+test('name resolves to .claude/workflows/<name>.ts', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     await mkdir(join(dir, '.claude', 'workflows'), { recursive: true })
@@ -180,7 +180,7 @@ test('renderToolUseMessage / mapToolResultToToolResultBlockParam', () => {
   expect(block.content[0]!.text).toBe('hi')
 })
 
-test('scriptPath 解析到文件内容并后台执行', async () => {
+test('scriptPath resolves to file content and runs in background', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const scriptFile = join(dir, 'external.ts')
@@ -209,7 +209,7 @@ test('scriptPath 解析到文件内容并后台执行', async () => {
   }
 })
 
-test('脚本运行时失败 → onFinish 路由到 fail', async () => {
+test('script runtime failure → onFinish routes to fail', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports, runStatus } = mockPorts(dir, new Map())
@@ -229,7 +229,7 @@ test('脚本运行时失败 → onFinish 路由到 fail', async () => {
   }
 })
 
-test('元数据方法：description/prompt/renderToolUseMessage', async () => {
+test('metadata methods: description/prompt/renderToolUseMessage', async () => {
   const { ports } = mockPorts('/tmp', new Map())
   const tool = createWorkflowTool(ports)
   expect(tool.isEnabled()).toBe(true)
@@ -242,7 +242,7 @@ test('元数据方法：description/prompt/renderToolUseMessage', async () => {
   )
 })
 
-test('prompt 包含默认并发 3 + AskUserQuestion 指引', async () => {
+test('prompt includes default concurrency 3 + AskUserQuestion guidance', async () => {
   const { ports } = mockPorts('/tmp', new Map())
   const tool = createWorkflowTool(ports)
   const p = await tool.prompt()
@@ -251,7 +251,7 @@ test('prompt 包含默认并发 3 + AskUserQuestion 指引', async () => {
   expect(p).toMatch(/AskUserQuestion/i)
 })
 
-test('name 不存在 → 返回错误（不进后台）', async () => {
+test('name does not exist → returns error (does not enter background)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     await mkdir(join(dir, '.claude', 'workflows'), { recursive: true })
@@ -270,7 +270,7 @@ test('name 不存在 → 返回错误（不进后台）', async () => {
   }
 })
 
-test('workflow 被 abort → onFinish 路由 kill', async () => {
+test('workflow aborted → onFinish routes to kill', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const runStatus = new Map<string, string>()
@@ -321,7 +321,7 @@ test('workflow 被 abort → onFinish 路由 kill', async () => {
   }
 })
 
-test('args 为 JSON 字符串化的对象时防御性 parse（向后兼容旧 z.string() 契约）', async () => {
+test('args defensively parses when a JSON-stringified object (backward compatible with old z.string() contract)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const capturedPrompts: unknown[] = []
@@ -360,7 +360,7 @@ test('args 为 JSON 字符串化的对象时防御性 parse（向后兼容旧 z.
     await tool.call(
       {
         script: `return agent(args.commit)`,
-        // 模拟旧契约下模型发送的字符串化 JSON
+        // simulate stringified JSON sent by model under old contract
         args: '{"commit":"abc123"}',
       },
       undefined,
@@ -370,15 +370,15 @@ test('args 为 JSON 字符串化的对象时防御性 parse（向后兼容旧 z.
     await new Promise(r => {
       setTimeout(r, 50)
     })
-    // 若 args 未归一化：args.commit === undefined（string 上无 commit 属性）
-    // 若 args 归一化：args.commit === 'abc123'
+    // if args not normalized: args.commit === undefined (string has no commit property)
+    // if args normalized: args.commit === 'abc123'
     expect(capturedPrompts).toContain('abc123')
   } finally {
     await rm(dir, { recursive: true, force: true })
   }
 })
 
-test('args 为非合法 JSON 字符串时保持原值不抛', async () => {
+test('args keeps original value for non-legal JSON string without throwing', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const capturedPrompts: unknown[] = []
@@ -416,7 +416,7 @@ test('args 为非合法 JSON 字符串时保持原值不抛', async () => {
     const tool = createWorkflowTool(ports)
     await tool.call(
       {
-        // 脚本把 args 当字符串用：agent(args) → agent('hello')
+        // script uses args as a string: agent(args) → agent('hello')
         script: `return agent(args)`,
         args: 'hello',
       },
@@ -427,22 +427,22 @@ test('args 为非合法 JSON 字符串时保持原值不抛', async () => {
     await new Promise(r => {
       setTimeout(r, 50)
     })
-    // 'hello' 不是合法 JSON，应保持为字符串
+    // 'hello' is not valid JSON, should be kept as a string
     expect(capturedPrompts).toContain('hello')
   } finally {
     await rm(dir, { recursive: true, force: true })
   }
 })
 
-test('scriptPath 越界（resolve 后在 cwd 之外）→ 拒绝并报错（防任意文件读）', async () => {
+test('scriptPath out of bounds (resolved outside cwd) → rejected with error (prevents arbitrary file read)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const subDir = join(dir, 'sub')
     await mkdir(subDir, { recursive: true })
-    // 在 subDir 之外（dir 内）放置一个脚本
+    // place a script outside subDir (inside dir)
     const outsideScript = join(dir, 'outside.ts')
     await writeFile(outsideScript, `return agent('x')`)
-    // host.cwd = subDir，scriptPath 是 subDir 外的绝对路径
+    // host.cwd = subDir, scriptPath is an absolute path outside subDir
     const { ports, runStatus } = mockPorts(subDir, new Map())
     const tool = createWorkflowTool(ports)
     const res = await tool.call(
@@ -452,22 +452,22 @@ test('scriptPath 越界（resolve 后在 cwd 之外）→ 拒绝并报错（防
       undefined,
     )
     expect(res.data.output).toMatch(/^Error:/)
-    expect(res.data.output).toMatch(/越界|外|outside|contain/i)
+    expect(res.data.output).toMatch(/out of bounds|outside|not within/i)
     expect(runStatus.size).toBe(0)
   } finally {
     await rm(dir, { recursive: true, force: true })
   }
 })
 
-test('name 含 ".." 路径段 → 拒绝（防路径遍历逃出 workflowDir）', async () => {
+test('name contains ".." path segment → rejected (prevents path traversal escaping workflowDir)', async () => {
   const outer = await mkdtemp(join(tmpdir(), 'wf-outer-'))
   try {
-    // 在 outer 根下放置 evil.ts（在 .claude/workflows 之外）
+    // place evil.ts at outer root (outside .claude/workflows)
     await writeFile(join(outer, 'evil.ts'), `return agent('x')`)
     await mkdir(join(outer, '.claude', 'workflows'), { recursive: true })
     const { ports, runStatus } = mockPorts(outer, new Map())
     const tool = createWorkflowTool(ports)
-    // name = '../../evil' → join 后逃离 workflows 目录到 outer/evil.ts
+    // name = '../../evil' → after join escapes the workflows directory to outer/evil.ts
     const res = await tool.call(
       { name: '../../evil' },
       undefined,
@@ -481,7 +481,7 @@ test('name 含 ".." 路径段 → 拒绝（防路径遍历逃出 workflowDir）'
   }
 })
 
-test('name 含路径分隔符或为绝对路径 → 拒绝', async () => {
+test('name contains path separators or is absolute → rejected', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     await mkdir(join(dir, '.claude', 'workflows'), { recursive: true })
@@ -501,7 +501,7 @@ test('name 含路径分隔符或为绝对路径 → 拒绝', async () => {
   }
 })
 
-test('returnValue 为对象 → complete（formatValue 走 JSON 分支）', async () => {
+test('returnValue is an object → complete (formatValue takes JSON branch)', async () => {
   const dir = await mkdtemp(join(tmpdir(), 'wf-tool-'))
   try {
     const { ports, runStatus } = mockPorts(

packages/workflow-engine/src/__tests__/agentAdapter.test.ts

@@ -36,7 +36,7 @@ const CTX = {
   agentId: 1,
 }
 
-test('resolve 默认走 default adapter，run 返回结果', async () => {
+test('resolve goes to default adapter, run returns result', async () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('a'))
     .register(makeAdapter('b'))
@@ -46,7 +46,7 @@ test('resolve 默认走 default adapter，run 返回结果', async () => {
   expect(r.kind).toBe('ok')
 })
 
-test('route agentType 命中优先于 default', () => {
+test('route agentType hit takes priority over default', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('default'))
     .register(makeAdapter('research'))
@@ -56,18 +56,18 @@ test('route agentType 命中优先于 default', () => {
   expect(reg.resolve(P({ agentType: 'other' })).id).toBe('default')
 })
 
-test('route model 前缀匹配', () => {
+test('route model prefix match', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('cheap'))
     .register(makeAdapter('strong'))
     .route({ kind: 'model', pattern: 'claude-opus', adapter: 'strong' })
     .default('cheap')
   expect(reg.resolve(P({ model: 'claude-opus-4' })).id).toBe('strong')
   expect(reg.resolve(P({ model: 'claude-sonnet-4' })).id).toBe('cheap')
-  expect(reg.resolve(P()).id).toBe('cheap') // 无 model → default
+  expect(reg.resolve(P()).id).toBe('cheap') // no model → default
 })
 
-test('route custom 谓词', () => {
+test('route custom predicate', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('main'))
     .register(makeAdapter('special'))
@@ -81,7 +81,7 @@ test('route custom 谓词', () => {
   expect(reg.resolve(P({ prompt: 'normal' })).id).toBe('main')
 })
 
-test('规则按顺序匹配（先命中先用）', () => {
+test('rules match in order (first hit wins)', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('a'))
     .register(makeAdapter('b'))
@@ -90,20 +90,20 @@ test('规则按顺序匹配（先命中先用）', () => {
   expect(reg.resolve(P({ agentType: 'x' })).id).toBe('a')
 })
 
-test('规则命中的 adapter 未注册 → 跳过该规则继续匹配', () => {
+test('rule-matched adapter not registered → skip that rule and continue matching', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('real'))
     .route({ kind: 'agentType', agentType: 'x', adapter: 'ghost' })
     .route({ kind: 'agentType', agentType: 'x', adapter: 'real' })
   expect(reg.resolve(P({ agentType: 'x' })).id).toBe('real')
 })
 
-test('无匹配且无 default → AdapterNotFoundError', () => {
+test('no match and no default → AdapterNotFoundError', () => {
   const reg = new AgentAdapterRegistry().register(makeAdapter('a'))
   expect(() => reg.resolve(P())).toThrow(AdapterNotFoundError)
 })
 
-test('default 指向未注册的 adapter → 仍抛（不静默回退）', () => {
+test('default points to an unregistered adapter → still throws (no silent fallback)', () => {
   const reg = new AgentAdapterRegistry()
     .register(makeAdapter('a'))
     .default('missing')
@@ -118,7 +118,7 @@ test('has / get', () => {
   expect(reg.get('b')).toBeUndefined()
 })
 
-test('initializeAll / disposeAll 触发 lifecycle（跳过未实现）', async () => {
+test('initializeAll / disposeAll triggers lifecycle (skips unimplemented)', async () => {
   const events: string[] = []
   const withLifecycle: AgentAdapter = {
     id: 'a',
@@ -133,7 +133,7 @@ test('initializeAll / disposeAll 触发 lifecycle（跳过未实现）', async (
       events.push('dispose-a')
     },
   }
-  const noLifecycle = makeAdapter('b') // 无 initialize/dispose
+  const noLifecycle = makeAdapter('b') // no initialize/dispose
   const reg = new AgentAdapterRegistry()
     .register(withLifecycle)
     .register(noLifecycle)
@@ -142,7 +142,7 @@ test('initializeAll / disposeAll 触发 lifecycle（跳过未实现）', async (
   expect(events).toEqual(['init-a', 'dispose-a'])
 })
 
-test('capabilities 声明可读', () => {
+test('capabilities declaration is readable', () => {
   const adapter: AgentAdapter = {
     id: 'a',
     capabilities: { structuredOutput: true, tools: true, stream: false },

packages/workflow-engine/src/__tests__/agentId.test.ts

@@ -46,7 +46,7 @@ function build(results: Map<string, AgentRunResult>) {
   return { ctx, events, hooks: makeHooks(ctx, async () => null) }
 }
 
-test('并发 agent 各自拿到唯一 agentId，started/done 配对', async () => {
+test('concurrent agents each get a unique agentId, started/done are paired', async () => {
   const ok = (out: string): AgentRunResult => ({
     kind: 'ok',
     output: out,
@@ -71,7 +71,7 @@ test('并发 agent 各自拿到唯一 agentId，started/done 配对', async () =
   expect(ctx.resources.agentIdSeq.value).toBe(2)
 })
 
-test('agentId 单调递增', async () => {
+test('agentId increases monotonically', async () => {
   const ok = (out: string): AgentRunResult => ({
     kind: 'ok',
     output: out,

packages/workflow-engine/src/__tests__/budget.test.ts

@@ -1,7 +1,7 @@
 import { expect, test } from 'bun:test'
 import { Budget, BudgetExhaustedError } from '../engine/budget.js'
 
-test('total=null 时无限制', () => {
+test('total=null means unlimited', () => {
   const b = new Budget(null)
   expect(b.total).toBeNull()
   expect(b.remaining()).toBe(Infinity)
@@ -10,7 +10,7 @@ test('total=null 时无限制', () => {
   expect(() => b.assertCanSpend()).not.toThrow()
 })
 
-test('累加并触顶抛错', () => {
+test('accumulates and throws when cap exceeded', () => {
   const b = new Budget(100)
   expect(b.remaining()).toBe(100)
   b.addOutputTokens(40)
@@ -22,7 +22,7 @@ test('累加并触顶抛错', () => {
   expect(() => b.assertCanSpend()).toThrow(BudgetExhaustedError)
 })
 
-test('addOutputTokens 负值忽略', () => {
+test('addOutputTokens ignores negative values', () => {
   const b = new Budget(100)
   b.addOutputTokens(-50)
   expect(b.spent()).toBe(0)