docs: organize product design by feature

Define repository and feature-scoped documentation rules for PRDs, User Stories, logic, UI, technical design, and progress evidence. Move feature-owned documents under docs/features, add one entry point per feature, remove the redundant docs index, and update all affected cross-references. Expand the local tool environment design with explicit product, story, logic, UI, technical, and progress documents.
2026-09-01 14:52:22 +08:00
parent dba3380a06
commit 2f1881a414
56 changed files with 1763 additions and 765 deletions
@@ -0,0 +1,55 @@
+# Goal Task PRD
+
+## 文档信息
+
+| 项目 | 内容 |
+| --- | --- |
+| 状态 | 设计中，未来能力 |
+| 版本 | 0.1 |
+| 日期 | 2026-08-19 |
+| 依赖 | [Task 与 Job 统一领域模型](./task-and-job-model.md) |
+
+## 1. 产品定义
+
+Goal Task 是围绕可验证结果持续推进的 Task。它只关联一条 Conversation，但该 Conversation
+也可以承载其他 Task；每轮观察、计划、行动和评估由内部 Job/Run 表达，不创建一串顶层 Task。
+
+## 2. 必要配置
+
+- 目标描述。
+- 至少一个成功标准。
+- 约束和停止条件。
+- 最大轮数、截止时间或预算。
+- 每轮评估方式。
+- 无进展处理。
+- Project、Runtime、知识、记忆、目录、工具和审批范围。
+
+## 3. 有界循环
+
+```text
+Observe Job
+  → Planning Job
+  → Permission and budget check
+  → Action Job / parallel Jobs
+  → Evaluation Job
+  → Complete, pause, revise or continue
+```
+
+循环内的所有 Job 通过所属 Task 写入同一关联 Conversation。只有协调器把有意义的阶段进展
+写入消息时间线，避免每个内部步骤产生一条顶层 Task 或杂乱消息。当前 UI 只显示 Goal Task
+及其聚合状态，不显示 Job/Run 层级。
+
+## 4. 完成和无进展
+
+- 模型声明不能单独证明目标完成。
+- 成功标准必须可计算或可人工审查。
+- 连续两轮没有指标改善、重复下一步、连续失败、权限不可用或预算不足时暂停。
+- 修改范围、预算、Runtime、工作模式或权限必须用户确认。
+
+## 5. 验收原则
+
+- [ ] Goal Task 只关联一条 Conversation，Conversation 可以承载其他 Task。
+- [ ] 循环步骤以 Job 表达，不创建顶层子 Task。
+- [ ] 当前 UI 不展示 Goal Task 内部 Job/Run 层级。
+- [ ] 没有成功标准和停止条件时不能启用。
+- [ ] 无进展和预算耗尽不会伪装为成功。