Skip to content

将 reusable workflow templates 演进为可复用工作流预设 #56

@keting

Description

@keting

Problem

当前仓库已经有 process template / reusable workflow template 能力,也有示例目录 issue #30,但 v0.3 roadmap 的目标不只是“补示例”,而是把现有模板模型演进为更可复用的“工作流预设”。

现状问题包括:

  • 模板更像静态 JSON,而不是可复用的协作预设
  • 与任务卡片、handoff、agent 选择的关系不够明确
  • 用户难以判断模板是“演示素材”还是“推荐工作方法”

Proposed Change

在现有流程模板模型之上,定义一版更贴近实际使用的“工作流预设”能力。

建议至少明确:

  • 预设与现有 process template 的关系:是包装层、扩展字段,还是命名层调整
  • 预设中可以固定哪些内容:节点结构、建议角色、任务卡片骨架、handoff 骨架
  • 预设中哪些内容必须保留为实例化时填写
  • 如何避免把 v0.3 做成支持复杂控制流的工作流引擎

实现可以分阶段:

  • 第一阶段:先定义模型与示例
  • 第二阶段:前端支持基于预设创建项目 / 计划
  • 第三阶段:补文档与演示素材

Why It Matters

如果没有这一步,#30 只能解决“给几个模板样例”,但不能真正回应 roadmap 中“演进现有流程模板模型”的目标。工作流预设应当成为用户复用最佳实践的主要承载形式。

Additional Context

#30 的关系:

  • #30 可以继续保留,聚焦“示例目录和示例 JSON”
  • 本 issue 聚焦“产品与数据模型层面的预设能力演进”
  • 实现时可以把 #30 作为子任务或依赖项引用

建议验收标准:

  • 文档明确“process template”与“workflow preset”的定位关系
  • 至少一版数据模型或字段扩展方案被落盘
  • 至少 1 个预设能体现任务卡片 / handoff / agent 配置的复用价值
  • v0.3 范围内不引入分支、循环、动态路由能力

相关 roadmap:

  • ROADMAP.zh-CN.md v0.3: “用可复用工作流预设演进现有的流程模板模型”
  • 相关 issue: #30

Metadata

Metadata

Assignees

Labels

area:backendBackend / Python / FastAPI relatedarea:docsDocumentation, guides, and contributor docsarea:frontendFrontend / React / UI relatedtype:featureNew user-facing capability

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions