Proposal：Goal 基础模块

[LUPENGHAN]

Issue：Goal 基础模块

1. 功能描述

Goal 是用户需要持续推进的长期目标，是 Task 的上层对象。Goal 用于表达目标、截止、完成标准和进度，不直接占用时间。

Goal 基础模块只负责 Goal 的创建、查看、编辑、删除、状态和目标 Tab 展示，不负责 AI 拆分排期；

2. 用户 / 用户故事

目标用户：需要持续推进跨天或跨周长期目标，并查看目标进度的个人用户。

用户创建“两周完成 AI 时间管理 App 产品需求报告”，填写截止时间、当前基础和完成标准。系统在目标 Tab 展示该 Goal，并在详情中展示后续 Task 和进度。

3. 现有做法及不足

长期目标如果没有独立对象语义，就容易和执行任务、排期草稿混在一起，后续的进度和状态也难以解释。

Goal 基础模块只负责目标本身的创建、查看、编辑、删除和状态边界。

4. 本期范围

1. Goal 创建、查看、编辑、删除。
2. Goal 列表和详情展示。
3. Goal 状态管理。
4. Goal 与 Task 的一对多关系。
5. Goal 进度根据 Task 和 Feedback 推导。
6. AI 创建 Goal 时先生成候选，确认后写入。

5. 明确不做

• 不做 Subtask。
• 不做多层项目树。
• 不做团队目标。
• 不做 Goal 之间的依赖图。
• 不在 Goal 基础模块中生成 Task。
• 不自动判断 Goal 完成，仍需用户确认。

6. 关键决策

决策点	备选方案	选择	理由
Goal 层级	Goal→Task / Goal→Task→Subtask	Goal 只含 Task	降低层级和认知负担
时间语义	Goal 直接占时 / 只含截止	Goal 可有截止，不直接占用时间	真正执行时间由 Task 承担
完成状态	全部 Task 完成即自动关闭 / 用户确认	用户确认完成	避免 Task 全完但目标质量未达标
创建方式	仅 AI / 仅手动 / 两者	手动 + AI 候选	保留 AI 和手动兜底

7. 边界与异常

• 删除 Goal 前必须展示关联 Task 影响范围。
• Goal 未确认前不得创建正式 Task。
• Goal 到期不等于自动失败或完成。
• Goal 信息不足时，主 Agent 先追问，不调用长任务拆分 Agent。

8. 基本概念与信息结构

概念	含义
Goal	长期目标
Task	Goal 下唯一执行层
deadline	Goal 目标截止时间
success_criteria	完成标准
status	进行中、完成、取消等状态
progress	基于 Task 状态和反馈推导

9. Agent 输入输出约束

• AI 可以生成 Goal 创建或修改候选。
• Goal 创建 / 修改 / 删除必须确认。
• Goal 信息补全由主 Agent 负责。
• 长任务拆分 Agent 不直接创建 Goal。
• 架构基准中的“长任务”在本产品中统一指 Goal；手动保存 Goal 作为确认事件，删除 Goal 需强确认。

10. 验收标准

• 用户可创建 Goal 并在目标 Tab 看到。
• Goal 详情展示 Goal 信息、Task 列表和进度。
• Goal 不直接出现在日程时间轴中。
• 删除 Goal 时展示关联 Task 影响并要求确认。
• AI 创建 Goal 未确认前不落库。
• Goal 到期不会被系统静默标记完成。
• 手动保存和完成确认可追踪；删除未强确认时不改变 Goal 或关联 Task。