Skip to content

将任务输入输出标准化为结构化任务卡片 #53

@keting

Description

@keting

Problem

当前 HALF 的任务输入输出更多依赖自由文本、页面上下文和隐式约定,导致以下问题:

  • 同一类任务在不同项目中的字段结构不稳定
  • agent 执行前后缺少统一可读、可校验的数据边界
  • handoff、状态展示、后续自动化能力缺少稳定依赖面
  • 新用户很难判断“一个任务最少应该包含哪些信息”

v0.3 需要先把任务层的最小输入输出 contract 收敛起来。

Proposed Change

为任务定义一版最小可用的“结构化任务卡片”格式,并在创建、展示、执行相关流程中落地。

建议第一版至少覆盖:

  • 任务基础元数据:标题、描述、状态、优先级、负责人
  • 任务输入:目标、约束、依赖、参考材料、预期产物
  • 任务输出:结果摘要、产物引用、阻塞原因、后续建议
  • 明确哪些字段是必填、哪些字段允许为空
  • 前后端统一 schema,并提供兼容旧数据的降级策略

实现上可以采用“保留自由文本 + 增加结构化字段”的渐进方案,而不是一次性完全替换。

Why It Matters

结构化任务卡片是 v0.3 其他能力的基础:

  • 为节点间 handoff 提供稳定承载格式
  • 为工作流预设提供可复用的任务骨架
  • 为任务状态展示和通知提供更清晰的信息源
  • 降低首次试用和团队协作时的理解成本

Additional Context

建议验收标准:

  • 后端存在一版明确的任务卡片 schema
  • 前端任务创建 / 查看页面能展示和编辑核心结构化字段
  • 执行结果可以按统一格式回写到任务输出区域
  • 旧任务数据不会因 schema 引入而无法读取
  • README 或架构文档明确说明任务卡片的定位与边界

相关 roadmap:

  • ROADMAP.zh-CN.md v0.3: “将任务输入输出标准化为结构化任务卡片”

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