docs: rescan rebased documentation hierarchy

This commit is contained in:
Turtle
2026-08-05 12:46:38 +08:00
parent 012bb0a549
commit 8af3babaea
304 changed files with 1091 additions and 1983 deletions

View File

@@ -2,5 +2,5 @@
# side as of the last confirmed-consistent state. Both languages carry equal authority;
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write packages/workflow/README.md
README.md: 17da3397e4fa64837b271d89e9062e3621434338
README.zh.md: 1609d1e961f9b21f859eda66ed84d7f8bdbbe978
README.md: 2416e26e73340a6d8624b8e77681dfc9f55fe7c5
README.zh.md: a5c94a0a9799d78e5cca72394385b38d2fb2ba70

View File

@@ -1,16 +1,14 @@
# workflow/:动态工作流能力族
# workflow/:动态工作流能力
[English](README.md) | 中文
工作流 seam由模型编写 JavaScript 编排脚本,大规模扇出 subagent分阶段、每个 agent智能体的结构化结果、并发上限其设计参考 Claude Code 动态工作流。这是 bash 形态的能力 seam见[能力 seam](../../.agents/notes/implemented/architecture/2026-06-13-capability-seams.md)):每个上下文只有一个引擎实现注册为 `ctx.workflows`;面向模型的工具使用它
本家族通过 subagent 运行由模型编写的编排工作流,并将通用工具与固定策略工具公开给模型
| 包 | 角色 | ctx 键 |
| 包 | 职责 | ctx 键 |
|---|---|---|
| `workflow/` | 抽象工作流 seam服务基类、运行词汇和 `workflow/*` 事件 | `ctx.workflows` |
| `workflow-workerthread/` | `node:worker_threads` 引擎:每次运行使用一个 worker脚本的 vm 上下文位于 worker 内,`agent()` 通过消息端口桥接到 `ctx.subagents` | (提供 `ctx.workflows` |
| `tool-workflow/` | 面向模型的 `workflow` 工具,基于 `ctx.workflows` | 注册到 `ctx.tools` |
| `tool-ralph/` | 基于 `ctx.workflows` 和全新结构化输出 subagent 提供方的固定全新 agent Ralph 策略 | 注册到 `ctx.tools` |
| [`workflow/`](workflow/README.md) | 定义工作流执行和生命周期事件 | `ctx.workflows` |
| [`workflow-workerthread/`](workflow-workerthread/README.md) | 在线程中运行工作流脚本 | 注册到 `ctx.workflows` |
| [`tool-workflow/`](tool-workflow/README.md) | 向模型公开通用工作流执行 | 注册到 `ctx.tools` |
| [`tool-ralph/`](tool-ralph/README.md) | 公开使用全新 agent智能体的固定 Ralph 工作流 | 注册到 `ctx.tools` |
接口位于 `workflow/workflow/`。引擎的 `agent()` 钩子使用 [subagent seam](../subagent/README.md)(任何已注册提供方;随产品交付的示例使用 `spawn``agent({ schema })` 则使用进程内后端实现的结构化输出支持。worker thread 隔离的是脚本:宿主绝不会被它阻塞,已取消运行经过宽限时间后的终止也会实际生效;但它不是安全边界。如果将来确有需要,可以在同一接口背后换用 isolated-vm独立进程引擎以实现真正的沙箱隔离。
通用脚本引擎的决策和暂缓事项见[动态工作流 Agent Note](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md)。独立的 [Ralph 消费方](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md)会固定脚本和全新提供方策略,而不是再添加一个引擎或 agent loop智能体循环模式。
worker thread 将工作流执行与宿主事件循环隔离,但不构成安全边界。参见[动态工作流](../../.agents/notes/implemented/feature/2026-07-05-dynamic-workflows.md)和 [Ralph 工具](../../.agents/notes/implemented/feature/2026-07-19-fresh-agent-ralph-workflow-tool.md)决策。