taskflow

taskflow 1.0 文档

面向 coding-agent 工作流的 Trusted Effects:声明 effect,验证类型化路径,让已准入的文件修改经过唯一 resource authority。

Taskflow 1.0.0 文档。 以下命令固定使用 1.0.0 包版本。发布状态见 GitHub Releases,已验证范围与限制见验收账本。Control Plane 与 WebUI 已实现,Control 命令随 taskflow-mcp-core 交付。

taskflow 是面向 coding-agent 工作流的声明式运行时。它把任务图变成可验证的执行合同,让阶段隔离运行,并把中间 transcript 留在宿主对话之外。1.0 合同包含 Trusted Effects:为已准入的文件 effect 提供类型化声明与受 resources 控制的提交路径。

先选择正确路径

Trusted Effects 不是 OS sandbox。0.3 MVP 通过 resources 路径保护已准入的已声明文件目标。在 resolve-only 执行下,未声明路径的写入仍取决于宿主策略;这一版没有 SecretRef 的 live vault 后端或 ServiceRef 的网络后端。

声明文件副作用合同

声明。 给 phase 附加封闭的 effects[] 列表。每个 effect 写明 kind、类型化 target、purpose,以及可选的 confidentiality/integrity labels。

验证并准入。 校验 EffectIR,解析 PathRef,检查 information-flow labels 与 mutating-path 重叠,再把声明目标绑定到 resource intent。

Stage 并提交。 Resources 层负责 snapshot、lease、journal、stage 与原子提交;事务无法完成时就 restore and reject。

解释。 通过 taskflow_why_effect 或 core why-* API 查看结构化、ledger-backed 原因。声明本身永远不被当作授权。

在你的宿主上使用

1.0.0 正式发布后,使用精确 @1.0.0 版本安装。实际发布状态见 GitHub Releases 与 npm registry。

所有 taskflow package 都要求 Node.js 22.19.0 或更高版本。源码与 fixture 检查使用仓库内的 pnpm。

理解基础层

发布边界

已实现基线与 1.0 待完成范围分别验收:

  • Trusted Effects MVP: 已实现的基础能力,单独完成它不足以满足 1.0 范围。覆盖 EffectIR、类型化 ref、labels、受 resources 控制的文件 transaction、重叠准入、诚实的宿主基线与 ledger-backed why-* explainers。
  • Control Plane: 已实现经认证的多项目准入、持久审批/重放/Receipt、全局协调与 WebUI;Control 命令随公共 taskflow-mcp-core 交付。支持 Unix UDS,Windows pipes 仍非 GA。

规范范围请读仓库中的 MVP 冻结定义 与 0.3-C 计划。

更多资源

当前 1.0 范围与阻塞项见PR #142 release plan.

Last updated on

这页内容对你有帮助吗?

帮助我们改进文档,或在社区中提问。

On this page