flower-trellis 0.6.12 → 0.6.13-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (20) hide show
  1. package/enhancements/0.6/.agents/skills/trellis-extract-prd/SKILL.md +47 -15
  2. package/enhancements/0.6/.agents/skills/trellis-plan-version/SKILL.md +127 -188
  3. package/enhancements/0.6/.agents/skills/trellis-verify-task/SKILL.md +100 -62
  4. package/enhancements/0.6/.claude/skills/trellis-extract-prd/SKILL.md +47 -15
  5. package/enhancements/0.6/.claude/skills/trellis-plan-version/SKILL.md +127 -188
  6. package/enhancements/0.6/.claude/skills/trellis-verify-task/SKILL.md +100 -62
  7. package/enhancements/0.6/overrides/conflicts.json +2 -2
  8. package/enhancements/0.6/overrides/patches/hooks/session-start/context-trim/patch.json +38 -0
  9. package/enhancements/0.6/overrides/patches/hooks/session-start/context-trim/spec-count-content.py +1 -0
  10. package/enhancements/0.6/overrides/patches/hooks/session-start/context-trim/spec-count-selector.py +2 -0
  11. package/enhancements/0.6/overrides/patches/hooks/session-start/context-trim/spec-discovery-content.py +9 -0
  12. package/enhancements/0.6/overrides/patches/hooks/session-start/context-trim/spec-discovery-selector.py +5 -0
  13. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-architecture-and-ownership/customization-principles-content.md +1 -1
  14. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-architecture-and-ownership/skill-taxonomy-content.md +1 -1
  15. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-architecture-and-ownership/system-model-content.md +1 -1
  16. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-architecture-and-ownership/template-hashes-content.md +1 -1
  17. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/customization-order-content.md +1 -1
  18. package/enhancements/0.6/overrides/patches/skills/trellis-meta/managed-customization-routing/skill-edit-route-content.md +1 -1
  19. package/enhancements/MANIFEST.json +6 -2
  20. package/package.json +3 -3
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  name: trellis-extract-prd
3
- description: "Extract a cohesive task PRD faithfully from a source requirements document, optionally using version task/wave planning as task boundary context; preserve UI copy verbatim and annotate source positions."
3
+ description: "Extract a verifiable task package PRD from source requirements and confirmed version planning, preserving original UI copy while carrying business-operation wave context, responsibilities, handoffs, and engineering acceptance."
4
4
  ---
5
5
  # Extract PRD — 基于原始需求文档
6
6
 
7
- 从原始需求文档中提取指定需求或版本规划中的 task 候选,结构化为 `prd.md`。**正文必须有据可依,禁止自行发挥**;仅允许在「本任务 TL;DR」与「本任务范围」两块做结论性提炼(且必须能在原文或已确认版本规划中找到依据)。
7
+ 从原始需求文档中提取指定需求或已确认版本规划的工作包,结构化为 `prd.md`。需求原文与索引忠实保留;TL;DR、Scope 及交付协作说明可依据原文、确认规划和工程证据提炼,不能自行增加业务规则。
8
8
 
9
9
  ---
10
10
 
@@ -12,11 +12,11 @@ description: "Extract a cohesive task PRD faithfully from a source requirements
12
12
 
13
13
  1. **原文优先** — 「来源需求原文」「Requirements 索引」「Acceptance Criteria 索引」三节必须引用或指向原始文档原文,不得改写语义
14
14
  2. **版本规划约束 task 边界** — 如果存在 `doc/<版本>/任务拆分与waves.md` 或用户提供的版本规划产物,单 task PRD 的 Scope 必须落在该产物中对应 task 候选的范围内
15
- 3. **task 必须内聚** — 单 task PRD 应代表一个可开发、可自测、可验收的闭环;不能把不相关需求塞进来,也不能把一个闭环拆成页面 / 接口 / 字段碎片
16
- 4. **wave 是归属,不是 task** — wave 用来说明本 task 属于哪个版本提测 / 交付批次;不要把 wave 当成 `task.py` 状态或独立任务目录
15
+ 3. **task 是内聚工作包** — 有明确输出、工程验证、消费方及集成去向;允许有稳定交接的技术分工。单包无需覆盖整个用户操作链,包内字段、按钮和测试步骤用 Checklist
16
+ 4. **wave 对应业务操作结果** — 继承业务角色、起始条件、操作及可验收结果,说明本包贡献和集成责任。Wave 业务验收与 Task 工程完成分别判断,不新增任务状态或强制 Wave 目录
17
17
  5. **文案原封不动** — 原始文档中出现的用户可见文案(按钮文字、提示语、Toast、弹窗内容、表头、placeholder 等)必须**逐字引用**,禁止改写、缩略或意译
18
18
  6. **标注出处** — 每条需求 / AC 标注来源位置(文档行号、章节编号或页码)
19
- 7. **允许提炼的两个例外** — 「本任务 TL;DR」与「本任务范围」允许做结论性总结,但必须能在原文、版本规划或用户确认中找到依据
19
+ 7. **原文与工程信息分离** — TL;DR/Scope 可提炼,责任、交接和工程完成标准须标注确认规划或契约/代码依据,不得混入「来源需求原文」或冒充原始业务 AC
20
20
  8. **完整提取** — 该 task 候选 / 需求单元下的所有内容全部提取,不跳不漏
21
21
  9. **去重** — 同一条款在 PRD 中只应完整出现一次;Requirements / AC / 关联需求等其他节均以指针形式引用,不复述原文
22
22
  10. **散射追踪是参考,不是清单** — 散射追踪成果仅用于知会关联,不得误读为工作范围;必须明确标注「本任务实现」列
@@ -56,19 +56,25 @@ description: "Extract a cohesive task PRD faithfully from a source requirements
56
56
  从版本规划产物中提取:
57
57
  - Task ID / task 名称
58
58
  - 所属 wave id / 名称
59
+ - Wave 的业务角色、起始条件、操作、可验收结果与集成验收责任
59
60
  - ✅ 本 task 范围
60
61
  - ❌ 相关但不在本 task 范围
61
62
  - 来源需求位置
62
63
  - 散射组归属
63
- - 依赖 task
64
- - 可验收结果 / 可提测性
64
+ - 当前主责、协作者、已有完成范围与历史交付证据
65
+ - 已核实的仓库/模块边界、共享契约的维护责任
66
+ - 依赖提供方、具体输入/输出、消费方与接收条件
67
+ - 可开工/可联调/可验收前提、本包工程完成标准
65
68
  - Task 创建顺序和 slug 建议(如存在)
66
69
 
67
70
  如果用户要求批量生成多个 task:
68
71
  - 必须优先按版本规划产物中的「Task 创建顺序」执行。
69
72
  - 如果版本规划产物没有「Task 创建顺序」,必须先补齐或请用户确认顺序;不要按需求文档顺序、Task ID 字面顺序或临时判断直接创建。
70
- - 同一 wave 的 task 必须连续创建,不能被其他 wave 插开。
73
+ - 本批新建工作包按计划聚合 Wave,再按依赖排列;这是建档顺序,不是所有任务的串行开工门禁。
71
74
  - 跨 wave 支撑 task 按版本规划标注放在服务的首个 wave 之前,或作为跨 wave 前置项单独说明。
75
+ - 只创建用户指定的已确认范围;远期候选可保留在版本规划。用户明确要求全量创建时,覆盖全部指定工作包,不擅自改成只建近期。
76
+
77
+ 旧规划缺少协作信息时,读取能找到的依据,未明确项如实标注,不编造人员或契约。发现工作包没有明确输出/验证、与已有任务重复或只有步骤切片时,先回到受影响规划澄清边界;版本规划写了“允许拆分”不能豁免此判断。
72
78
 
73
79
  如果版本规划产物存在但找不到用户指定的 task 候选:
74
80
  - 不要猜测映射
@@ -88,6 +94,7 @@ description: "Extract a cohesive task PRD faithfully from a source requirements
88
94
  - 不要跳过任何子节(即使看起来不重要)
89
95
  - 记录提取的起止位置(行号或章节号)
90
96
  - 如果版本规划已确认 task 边界,只提取该 task 范围内的来源内容;关联但不在范围的内容放入「关联需求」或「不在范围」
97
+ - 同一业务条款可由多个工作包分担,保留原文指针并注明本包承担的部分及其他归属;不把整个 Wave 的实现和业务验收强加给每个包。
91
98
 
92
99
  ### Step 3: 识别变更性质(关键一步)
93
100
 
@@ -118,7 +125,7 @@ description: "Extract a cohesive task PRD faithfully from a source requirements
118
125
 
119
126
  ### Step 5: 创建或定位任务
120
127
 
121
- 更新已有任务时,先读取已明确定位的任务目录中的 `task.json` 和 `prd.md`,沿用该目录,不运行 `task.py create`。
128
+ 更新已有任务时,先读取已明确定位的 `task.json`、`prd.md` 及相关设计/证据,沿用该目录,不运行 `task.py create`。人员替换保留稳定 ID、历史交付人、已完成范围和证据;提取/改派不改变完成状态,已完成任务返工遵循既有 reopen 流程。
122
129
 
123
130
  新建任务时,从前述提取结果确定标题、slug 和一句话目标,先调用框架脚本创建任务目录、`task.json` 和默认 `prd.md`:
124
131
 
@@ -150,7 +157,7 @@ python3 .trellis/scripts/task.py create "项目列表反馈投标状态" \
150
157
  --description "项目列表反馈投标状态"
151
158
  ```
152
159
 
153
- 不要把日期写入 `--slug`;`task.py create` 会自动添加 `MM-DD-` 前缀。批量创建时,必须按版本规划的「Task 创建顺序」逐个执行上述命令。
160
+ 不要把日期写入 `--slug`;`task.py create` 会自动添加 `MM-DD-` 前缀。批量创建按版本规划的「Task 创建顺序」执行;人员变更、跨日期补建或旧 slug 缺排序键,都不自动要求重命名已有目录。
154
161
 
155
162
  ### Step 6: 写入 PRD 并补充 task.json
156
163
 
@@ -179,6 +186,15 @@ PRD 的结构按下列顺序组织:
179
186
  - ❌ **相关但不在本任务范围**:
180
187
  - <条目> — 归属:<Task ID / Wave / 独立任务 / N/A 原因>
181
188
 
189
+ ## 交付与协作
190
+
191
+ - **业务操作与结果**:<本包服务的 Wave 操作、起始条件与可验收结果;无规划则不编造>
192
+ - **主责/协作者**:<已确认责任及身份依据;未明确则注明>
193
+ - **输入 → 输出 → 消费方**:<具体交付、契约/基线指针及接收条件>
194
+ - **依赖与就绪**:<提供方;可开工、可联调、可验收的不同条件及阻断影响>
195
+ - **代码与共享边界**:<已核实模块及共享改动责任;具体实现留给 design/implement>
196
+ - **集成与业务验收责任**:<谁消费本包输出、谁组织 Wave 验收>
197
+
182
198
  ## 来源需求原文
183
199
  <按原始文档的子结构组织,使用 blockquote 或分级标题忠实摘录>
184
200
  <保留原始编号和层级;用户可见文案逐字引用>
@@ -189,6 +205,11 @@ PRD 的结构按下列顺序组织:
189
205
  ## Acceptance Criteria(索引)
190
206
  - [ ] [<编号>] <一句话摘要> — 详见「来源需求原文」§<编号> / <原文位置>
191
207
 
208
+ ## 工程完成标准
209
+
210
+ - [ ] <本包可验证的输出及接收结果> — 依据:<已确认 Scope/契约/代码证据位置>
211
+ - <与 Wave 集成及业务验收的关系;本包自测或合入不能自动代替 Wave 验收>
212
+
192
213
  ## 关联需求(⚠️ 上下文参考,非本任务范围)
193
214
  | 需求单元 | 关联内容 | 本任务实现 | 归属 / 位置 |
194
215
  |---------|---------|-----------|-------------|
@@ -200,14 +221,20 @@ PRD 的结构按下列顺序组织:
200
221
  - 原始文档路径、提取范围、提取时间
201
222
  - 版本规划产物路径、Task ID、Wave ID(如有)
202
223
  - 关键文件路径(用于 task.json `relatedFiles`)
224
+ - 已有实现/完成证据、当前责任与历史交付说明(如有)
203
225
  ```
204
226
 
227
+ 「交付与协作」按实际依赖展开,简单工作包可简写;旧材料缺失只报告待补充。工程标准检验本包确认范围和契约,例如接口行为、持久化或消费兼容;不能据此发明新的产品行为。Brief 可从这些材料的既有 Context & Decisions 承接关键交接条件,无需增加固定栏目。
228
+
205
229
  PRD 写入后,根据其中的分析补充该任务现有 `task.json` 中的字段:
206
230
  - `dev_type`:`frontend` / `backend` / `fullstack`
207
231
  - `relatedFiles`:PRD Technical Notes 中识别的关键文件路径
208
232
  - `meta.version_plan`:版本规划产物路径(如有)
209
233
  - `meta.wave`:所属 wave id / 名称 / 可提测性(如有)
210
234
  - `meta.source_requirements`:来源需求编号和位置(如有)
235
+ - `assignee`:仅在真实负责人到开发者标识的映射已核实时,通过项目既有分配入口记录;未核实时不把实名或角色猜作标识,也不把创建器默认值当作已确认分工。
236
+
237
+ 读取现有字段及 schema 后再写入,保留无关 metadata 和历史记录;本 Skill 不增加协作 JSON 协议。
211
238
 
212
239
  `meta` 示例:
213
240
 
@@ -246,6 +273,9 @@ PRD 写入后,根据其中的分析补充该任务现有 `task.json` 中的字
246
273
  | **任务边界匹配** | 如存在版本规划产物,Scope 是否严格落在 task 候选范围内 |
247
274
  | **Wave 匹配** | PRD / `task.json.meta` 的 wave 是否与版本规划一致 |
248
275
  | **创建顺序匹配** | 批量生成时,实际创建顺序和 slug 是否遵循版本规划的「Task 创建顺序」 |
276
+ | **工程与业务分层** | 工程完成标准能否追到确认范围/契约,与原始业务 AC 及 Wave 验收是否分清 |
277
+ | **协作可接手** | 是否能回答谁做、交什么、谁接、何时可开工/联调、谁集成验收 |
278
+ | **创建范围与历史** | 是否遵循用户指定建档范围,保留旧 ID、已完成证据和历史交付人 |
249
279
 
250
280
  ---
251
281
 
@@ -260,11 +290,13 @@ PRD 写入后,根据其中的分析补充该任务现有 `task.json` 中的字
260
290
  - ❌ Requirements / AC 小节复述原文内容
261
291
  - ❌ 散射追踪结果混入 Scope ✅ 或 Requirements
262
292
  - ❌ 有版本规划产物却忽略 task 候选边界,直接按原始需求整段提取成过大的任务
263
- - ❌ 把一个内聚 task 拆成页面 / 接口 / 字段碎片
293
+ - ❌ 按人员或技术层自动复制 Task,或将无独立输出/验证的字段、按钮、测试步骤变成持久任务
294
+ - ❌ 要求每个有稳定交接的技术工作包独立提供整个业务操作链
295
+ - ❌ 将协作安排、Mock 成功或工程完成标准伪装成原始业务 AC 或 Wave 已验收
264
296
  - ❌ 未找到版本规划产物时自行编造 wave id 或 Task ID
265
297
  - ❌ 把 wave 当成独立 task 目录或 `task.py` 状态
266
298
  - ❌ 批量创建 task 时忽略版本规划的「Task 创建顺序」
267
- - ❌ slug 缺少 `wNN-tNN` 等稳定排序键,导致同一 wave 的 task 在目录中分散
299
+ - ❌ 为人员分组或自然目录排序重命名历史任务,丢失已有证据;缺材料时编造责任或完成事实
268
300
 
269
301
  ---
270
302
 
@@ -272,7 +304,7 @@ PRD 写入后,根据其中的分析补充该任务现有 `task.json` 中的字
272
304
 
273
305
  | 入口 | 形态 | 职责 | 时机 |
274
306
  |------|------|------|------|
275
- | `trellis-plan-version` | skill | 版本级需求扫描 + 内聚 task 拆分 + wave 编排 | 版本规划阶段 |
307
+ | `trellis-plan-version` | skill | 全文需求扫描 → 业务操作 Wave → 工作包、交接与容量规划 | 版本规划阶段 |
276
308
  | `trellis-brainstorm` | skill(上游) | 对话式需求发现(**无原始文档时**) | 需求模糊时 |
277
- | `trellis-extract-prd` | skill(本技能) | 基于原始文档严格提取单个内聚 task 的 PRD;如有版本规划,则绑定 Task ID / Wave / 来源需求 | 任务开发前、有正式需求文档时 |
278
- | `trellis-verify-task` | skill | 校验任务三件套准确性 + 覆盖度 + 跨层一致性;如有版本规划,则追加版本需求 -> task -> wave 对照 | PRD / Design / Implement 生成后 |
309
+ | `trellis-extract-prd` | skill(本技能) | 提取原文与工作包 Scope,继承 Wave 业务结果、责任、交接及工程标准 | 任务开发前、有正式需求文档时 |
310
+ | `trellis-verify-task` | skill | 校验原文、三件套、版本规划和实际关联任务的覆盖、粒度及协作条件 | PRD / Design / Implement 生成后 |
@@ -1,288 +1,227 @@
1
1
  ---
2
2
  name: trellis-plan-version
3
- description: "Generate a version development plan from a source requirements doc: requirements list, cohesive task candidates, waves, effort estimate, and team assignment."
3
+ description: "Generate a version development plan from source requirements: business-operation waves, verifiable task packages, team responsibilities, handoffs, dependencies, and capacity-aware estimates."
4
4
  ---
5
- # 版本开发计划 — 从需求文档到内聚 Task 与 Waves
5
+ # 版本开发计划 — 从业务操作到 Wave、工作包与分工
6
6
 
7
- 从原始需求文档出发,生成版本开发计划(需求清单 + 内聚 task 候选 + waves + 工时评估 + 人员分工),内置覆盖度校验,确保不遗漏需求,并让版本结果能按批次提测 / 分批交付。
8
-
9
- ---
7
+ 从原始需求全文提取版本范围,先按业务操作与可验收结果划分 Wave,再结合已有能力、团队投入和代码边界拆 Task,形成能用于实际开发、联调和交付的计划。
10
8
 
11
9
  ## 核心原则
12
10
 
13
- 1. **需求文档是唯一真相** — 需求清单必须从文档全文提取,不能只看目录 / 总表
14
- 2. **先扫后拆** — 先完成覆盖度扫描,确认无遗漏后再拆 task、排 wave、评估工时和分工
15
- 3. **task 必须内聚** — 可以拆多个 task,但每个 task 必须是可开发、可自测、可验收的闭环,不能按章节 / 页面 / 接口机械碎拆
16
- 4. **wave 是版本级批次** — wave 组织 task 的分批提测 / 分批交付,不是 `task.py` 状态,也不强制一个 wave 一个 task
17
- 5. **可追溯** — 每个需求条目必须能追到 task,每个 task 必须能追到 wave 或明确标记为跨 wave 支撑项
18
-
19
- ---
11
+ 1. **业务内容有来源** — 需求与 UI 文案以原始需求为依据;用户已确认的补充决定单独标注。代码现状、人员安排和工程估算不伪装成需求原文。
12
+ 2. **先覆盖,再规划** — 全文扫描并确认需求覆盖后,按“业务操作 → Wave → 实现缺口 → Task → 分工与排期”推进。
13
+ 3. **Wave 对应业务操作结果** — 说明谁、在什么前提下、完成哪些操作、得到什么可验收结果;可包含围绕同一结果的多个操作。
14
+ 4. **Task 是执行工作包** — 上下文连贯、范围明确,有输出、工程验证和消费/集成去向;内部字段、按钮、接口和测试步骤放 Checklist。
15
+ 5. **协作有责任和交接** — 支持多人按职责协作及单负责人使用 Agent;人员数、技术层和页面数都不是自动拆包依据。
16
+ 6. **完成分层判断** — Task 按其工程范围及既有生命周期完成;Wave 按真实业务操作验收。Mock、自测、合入或所有 Task 关闭都不能自动证明 Wave 已交付。
20
17
 
21
18
  ## 输入
22
19
 
23
- 用户需提供:
24
- - **原始需求文档路径**
25
- - **版本号或迭代标识**
26
- - **开发团队信息**(人数、角色分工模式)
20
+ 必需:原始需求文档路径、版本/迭代标识、团队信息。团队信息包括实际职责、技能、可用投入及协作方式,不预设前后端或固定人数。
27
21
 
28
- 可选输入:
29
- - **产物目录**:默认 `doc/<版本>/`;如果用户显式指定路径,以用户指定路径为准
30
- - **提测策略偏好**:例如先核心链路、先低风险模块、先后端基础能力等
31
- - **拆分偏好**:例如“尽量少拆 task”“按团队并行拆”“允许 child task”
22
+ 可选:
32
23
 
33
- ---
24
+ - **产物目录**:默认 `doc/<版本>/`,显式指定路径优先。
25
+ - **交付偏好**:优先业务场景、提测窗口、截止约束及拆分偏好。
26
+ - **开发现状**:已有实现、任务、契约、验证证据及外部前置。
27
+ - **规划细度**:近期细化/远期候选,或用户明确要求全版本工作包。
28
+
29
+ 先查现有材料;确实影响边界或日期的未知项向用户澄清,其他未知项标明依据不足,不编造人员、投入、能力或期限。
34
30
 
35
31
  ## 执行步骤
36
32
 
37
- ### Step 1: 理解文档结构 + 全文扫描
33
+ ### Step 1: 理解结构、全文扫描与开发约束
38
34
 
39
35
  #### 1.0 先读后扫
40
36
 
41
- 读取文档,识别其组织方式:
42
- - 需求的划分单元是什么?(编号体系 / 章节 / 功能模块 / 用户故事)
43
- - 有无需求总表或变更日志?
44
- - 版本变更如何标记?(显式标记 / 总表版本列 / 变更日志章节 / 无标记)
45
-
46
- > **不要假设文档有特定格式**,先读再判断。
47
-
48
- #### 1.1 多策略识别本版本变更
37
+ 识别需求单元、编号、总表、变更日志和版本标记。不要假设文档有特定格式。
49
38
 
50
- 根据文档实际结构,组合使用以下策略:
39
+ #### 1.1 多策略识别版本变更
51
40
 
52
41
  | 策略 | 方法 |
53
42
  |------|------|
54
- | **标记扫描** | grep 搜索版本相关标记,**包括段落中间嵌入的** |
55
- | **需求总表** | 读取需求列表中版本相关列,提取本版本的条目 |
56
- | **全文通读** | 逐章扫描「新增」「变更」「调整」等动作词 |
57
-
58
- #### 1.2 归组到需求单元
59
-
60
- 每个变更点定位到所属的需求单元,记录:
61
- - 需求单元标识(编号、名称或章节)
62
- - 变更内容摘要
63
- - 在文档中的位置
64
- - 变更类型:整体新增 / 局部变更 / 字段级嵌入
43
+ | 标记扫描 | 用 `rg` 搜索版本标记,包含段落中间嵌入的标记 |
44
+ | 需求总表 | 读取版本、更新内容等列,提取本版本条目 |
45
+ | 全文通读 | 逐章识别新增、变更、调整及其完整规则 |
65
46
 
66
- > **[!] 关键:必须识别出「字段级嵌入变更」。**
67
- > 有些需求单元整体是旧版本的,但内部某个字段 / 段落属于新版本变更。
68
- > 仅看需求单元标题会遗漏这类变更。
47
+ 将每个变更定位到需求单元,记录编号/名称、摘要、原文位置与变更类型:整体新增/局部变更/字段级嵌入。旧功能内部的新字段或段落也必须识别,不能只看标题。
69
48
 
70
- #### 1.3 识别散射型变更
49
+ #### 1.2 识别散射型变更
71
50
 
72
- 检查是否有同一功能点散布在多个需求单元中:
73
- - 同一字段在不同页面的展示 / 编辑 / 导出
74
- - 同一业务规则在不同入口的复用
75
- - 同一权限、校验、状态流转、历史数据处理在多个模块重复出现
51
+ 搜索同一字段、规则、权限、校验、状态、历史数据和导出在不同入口的关联位置,记录散射组。后续说明主责及消费者,避免遗漏或重复实现。
76
52
 
77
- 记录每组散射变更,后续 task 拆分和 wave 编排时必须显式处理。
53
+ #### 1.3 读取协作与已有能力
78
54
 
79
- ### Step 2: 输出需求清单 — 覆盖度确认
55
+ - 从团队信息确认谁能承担哪些工作、实际投入、评审/指导责任;计划支持的 Agent 执行方式也单独记录。
56
+ - 有既有开发时核对代码、当前任务、共享契约和证据,区分已完成、部分完成、待核实及尚缺范围。
57
+ - 识别仓库/模块、共享文件、公共能力提供方与消费者;未核实的路径或接口标为待核实。
58
+ - 记录外部服务、环境、样本和产品决定的就绪条件及负责人,不能默认由未确认的外部团队承担。
80
59
 
81
- 输出完整的需求清单,请用户确认无遗漏:
60
+ ### Step 2: 输出需求清单并确认覆盖
82
61
 
83
62
  ```markdown
84
63
  ## <版本> 需求清单
85
64
 
86
65
  ### 扫描统计
87
- - 需求总表中本版本条目: X 个
88
- - 全文扫描发现的变更: Y 个
89
- - 去重后独立需求单元: Z 个
90
66
 
91
- ### 需求列表
67
+ - 总表版本条目:X;全文变更:Y;去重需求单元:Z。
92
68
 
93
- | # | 需求单元 | 功能点 | 变更类型 | 变更摘要 | 文档位置 |
94
- |---|---------|--------|---------|---------|---------|
69
+ ### 需求列表
95
70
 
96
- ### 散射型变更(同一功能点跨多个需求单元)
71
+ | # | 需求单元 | 功能点 | 变更类型 | 变更摘要 | 原文位置 |
72
+ |---|----------|--------|----------|----------|----------|
97
73
 
98
- | 散射组 | 功能点 | 涉及的需求单元 | 建议处理 |
99
- |--------|--------|--------------|---------|
74
+ ### 散射型变更
100
75
 
101
- ### 需求总表 vs 全文扫描差异
76
+ | 散射组 | 功能点 | 涉及需求单元 | 关联位置与处理建议 |
77
+ |--------|--------|--------------|--------------------|
102
78
 
103
- | 来源 | 仅在总表 | 仅在全文 | 两者都有 |
104
- |------|---------|---------|---------|
79
+ ### 总表与全文差异
105
80
 
106
- > 仅在全文中的变更 = 总表未收录的嵌入式变更,最易遗漏。
81
+ | 仅在总表 | 仅在全文 | 两者都有 | 需核实的差异 |
82
+ |----------|----------|----------|--------------|
107
83
  ```
108
84
 
109
- **等待用户确认后再继续。**
85
+ **等待用户确认需求覆盖后,再进入 Wave 与 Task 规划。**
110
86
 
111
- ### Step 3: Task 拆分 — 生成内聚 task 候选
87
+ ### Step 3: 从业务操作划分 Wave
112
88
 
113
- 基于已确认的需求清单,先生成内聚 task 候选。task 可以有多个,但禁止碎拆。
89
+ 先列业务角色、目标与操作,再寻找能停下来验收的有用结果。一个独立操作或一组紧密相关操作均可形成 Wave,数量由业务结果与交付目标决定。
114
90
 
115
- #### 3.1 合并为同一个 task 的信号
91
+ 每个 Wave 写清:
116
92
 
117
- 优先合并为同一个 task:
118
- - 属于同一个可验收业务闭环,例如页面 + 接口 + 状态流转 + 导出完整闭环
119
- - 同一字段、规则、权限、校验或导出链路在多个入口复用
120
- - 同一散射组内的变更如果拆开会导致重复改同一批文件或难以独立验收
121
- - 强依赖同一份数据模型、接口契约或迁移脚本
122
- - 拆开后任一 task 只剩半成品,无法说明自己的验收结果
93
+ - ID/名称、业务角色与目标。
94
+ - 起始条件:可复用的已有能力、数据、上游交付及外部条件。
95
+ - 操作过程与最终结果,覆盖本批次需求、边界和来源。
96
+ - 验收场景、通过条件、集成及业务验收责任;未确认人员写待定。
97
+ - 提测就绪条件与交付顺序。已有能力可作为前提,无需每批重做整个业务流程。
123
98
 
124
- #### 3.2 拆成多个 task 的信号
99
+ 例如“上传招标文件 → 解析提取 → 查看/调整 → 保存”,结果是清单与原文依据可用、保存后能查回并供后续审核消费;这是粒度示例,不固定项目的 Wave 数量或操作。
125
100
 
126
- 可以拆成多个 task:
127
- - 每个 task 都能独立开发、独立自测、说明验收结果
128
- - 只有弱依赖,前置 task 提供稳定接口 / 数据后即可并行
129
- - 技术层差异明显,例如基础迁移、后端契约、前端体验可分阶段完成
130
- - 风险等级不同,需要先交付低风险或核心链路
131
- - 多人并行开发时,边界清晰且交集可控
101
+ 对话中的 Wave 表和规划摘要也要保留具体业务对象、关键操作与可观察结果,让读者只看摘要就知道交付什么。例如“输入产品,必要时选择类目后查到报价负责人”,不要只概括为“找到能力”“完成问答”或“链路可用”。压缩篇幅时保留影响操作的差异;摘要措辞调整不自动改变已确认的 Wave/Task 边界,也不把每个操作示例另拆成 Wave。
132
102
 
133
- #### 3.3 每个 task 候选必须写清
103
+ 纯契约、迁移、公共组件和环境准备作为支撑 Task,标明服务哪个业务 Wave。已有 W0 等工程准备标签可保留历史含义,不能当作业务验收完成。
134
104
 
135
- - task id / 标题
136
- - ✅ 本 task 范围
137
- - ❌ 相关但不在本 task 范围
138
- - 来源需求位置
139
- - 散射组归属
140
- - 依赖 task
141
- - 建议主要 wave
142
- - 可验收结果 / 可提测性
143
- - 风险 / 开放问题
105
+ 格式扩展、专项算法或历史管理按其改变的业务操作与结果判断归属。业务操作的先后与开发排期分开表达,具备输入条件的工作可以并行。
144
106
 
145
- #### 3.4 反碎拆检查
107
+ ### Step 4: 识别实现缺口并拆工作包
146
108
 
147
- 输出 task 候选后,必须自检:
148
- - 有没有 task 只对应一个孤立字段、按钮、接口或页面小块?
149
- - 有没有一个业务闭环被拆成多个互相等待的 task?
150
- - 有没有同一散射组被拆到不同 task 且没有理由?
151
- - 有没有 task 完成后无法说明“验收什么”?
109
+ #### 4.1 拆分与合并依据
152
110
 
153
- 这些情况必须合并或解释理由。
111
+ 优先合并上下文紧密、反复修改同一模型/文件、交接难以稳定或无法分别验证的工作。散射变更由同一主责或有明确契约的小组维护。
154
112
 
155
- ### Step 4: Wave 编排 — 分批提测 / 交付
113
+ 允许按实际技术职责拆包,前提是分别有明确输出、工程验证、交接条件和集成去向。后端能力可通过契约及行为验证交付给页面或工作流消费者,无需每个包都独立提供完整用户体验。
156
114
 
157
- 基于 task 候选编排 waves。wave 是版本级批次,用于组织 task 的提测 / 交付顺序。
115
+ 多人参与、前后端层次、单页或单接口只是观察信号,不能直接决定建 Task。只有需要独立规划、恢复、验证和合入的工作才建立持久任务;包内操作用 Checklist。
158
116
 
159
- #### 4.1 Wave 准则
117
+ #### 4.2 每包的最小信息
160
118
 
161
- 一个 wave 必须写清:
162
- - wave id / 名称
163
- - 目标:这一批完成后测试能验什么
164
- - 包含 task
165
- - 提测范围
166
- - 前置条件:依赖哪些 task / 外部系统 / 数据准备
167
- - 完成条件:哪些验收项通过才算完成
168
- - 可提测性:可独立提测 / 依赖后续 wave / 仅前置能力
119
+ | 信息 | 要回答的问题 |
120
+ |------|--------------|
121
+ | ID、范围与非范围 | 本包改什么,相关范围归谁,来源需求和散射组是什么? |
122
+ | 责任与代码边界 | 谁主责、谁协作,涉及哪些已核实仓库/模块,共享改动由谁维护? |
123
+ | 输入、输出与交接 | 消费什么契约/数据,交付什么,谁接收,如何判断可以接手? |
124
+ | 工程完成标准 | 本包用什么可观察结果证明完成,依据哪份确认范围或契约? |
125
+ | Wave 归属 | 服务哪个业务操作结果,由谁集成并完成 Wave 验收? |
126
+ | 依赖、风险与未决项 | 缺哪个具体交付,影响什么工作,何时须收敛? |
169
127
 
170
- > 如果一批只包含基础设施、迁移、公共组件或接口契约,不能直接标成“可独立提测 wave”。应作为后续 wave 的前置依赖,或并入首个能形成业务验收闭环的 wave。
128
+ 可用短说明、表格或材料指针表达,按协作复杂度展开;不要求每个简单工作包额外复制多份文档。一个 Task 可有协作者,分工清单不自动成为子 Task。
171
129
 
172
- #### 4.2 Task 创建顺序
130
+ #### 4.3 依赖与反碎拆检查
173
131
 
174
- 在输出 task / wave 拆分结果时,必须同时给出明确的 task 创建顺序。创建顺序用于后续 `trellis-extract-prd` 批量生成具体 task,不能只依赖 Task ID、需求文档顺序或人工临时创建顺序。
132
+ 依赖必须写明提供方、消费方、交付内容/契约、接收条件及责任,区分:
175
133
 
176
- 排序规则:
177
- - 先按 wave 分组,同一 wave 的 task 必须连续出现。
178
- - 同一 wave 内按依赖关系排序,前置能力在前。
179
- - 无依赖关系时,按可提测闭环优先级、风险或用户确认的优先级排序。
180
- - 跨 wave 支撑 task 放在它服务的首个 wave 之前,或明确标记为跨 wave 前置项。
134
+ - **可开工**:如契约、样例或 Mock 已足够。
135
+ - **可联调**:如真实服务、版本和环境已具备。
136
+ - **可验收**:如业务数据、样本、产品口径和完整操作路径齐备。
181
137
 
182
- slug 建议使用:
138
+ 仅阻断实际依赖该条件的工作;共享契约未稳定时明确主责与接力,不能把两个修改方按完全独立并行估算。
183
139
 
184
- ```text
185
- <version>-wNN-tNN-<task-slug>
186
- ```
140
+ 检查候选与明确关联的已有父子任务:是否出现无独立输出/验证的字段或步骤包、重复范围、循环等待、无消费者的支撑项、无人收口的业务结果,或过大且上下文不连贯的包。根据实际交接和验证调整,不能凭“规划允许拆分”豁免。
187
141
 
188
- 其中 `wNN` 表示 wave 顺序,`tNN` 表示全版本 task 创建顺序。后续执行 `task.py create --slug` 时,`--slug` 只传上述排序 slug,不要加入日期前缀;`task.py create` 会自动添加 `MM-DD-` 前缀。
142
+ #### 4.4 输出规划及逻辑创建顺序
189
143
 
190
- #### 4.3 输出 task / wave 拆分结果
144
+ 同一 Wave 的新建候选在计划顺序中聚合;组内按依赖与优先级排列。跨 Wave 支撑项标明首个服务 Wave 及后续消费者。创建顺序用于批量建档,不等同于全部工作必须串行开工。
145
+
146
+ 新建 slug 建议为 `<version>-wNN-tNN-<task-slug>`:`wNN` 是 Wave 顺序,`tNN` 是全版本创建顺序。`--slug` 不含日期前缀,`task.py create` 自动添加日期。人员变化或跨日期补建不要求给已有目录改名。
191
147
 
192
148
  ```markdown
193
149
  ## <版本> 任务拆分与 Waves
194
150
 
195
- ### 拆分原则
196
- - <为什么这样合并 / 拆分 task>
151
+ ### 团队约束与拆分依据
197
152
 
198
- ### Task 候选列表
153
+ - <实际职责、投入、已有能力和拆/并理由;未知项单独注明>
199
154
 
200
- | Task ID | Task 名称 | 本 task 范围 | 不在范围 | 来源需求 | 散射组 | 依赖 | 主要 Wave | 可验收结果 | 风险 |
201
- |---------|-----------|-------------|----------|----------|--------|------|-----------|------------|------|
155
+ ### Wave 业务操作与验收
202
156
 
203
- ### Task 创建顺序
157
+ | Wave | 业务角色/目标 | 起始条件 | 操作过程 | 可验收结果/来源 | 包含 Task | 集成与验收责任 | 提测就绪条件 |
158
+ |------|---------------|----------|----------|-----------------|-----------|----------------|--------------|
204
159
 
205
- | 创建序号 | Wave | Wave 内序号 | Task ID | Task 名称 | Slug 建议 | 排序原因 |
206
- |----------|------|-------------|---------|-----------|-----------|----------|
160
+ ### Task 候选与交付
207
161
 
208
- ### Wave 计划
162
+ | Task ID/名称 | 范围/非范围 | 来源/散射组 | 主责/协作者 | 代码边界 | 输入与输出/消费方 | 工程完成标准 | 主要/服务 Wave | 风险与未决项 |
163
+ |---------------|-------------|-------------|--------------|----------|-------------------|--------------|----------------|--------------|
209
164
 
210
- | Wave | 目标 | 包含 task | 提测范围 | 前置条件 | 完成条件 | 可独立提测 |
211
- |------|------|-----------|----------|----------|----------|------------|
165
+ ### 依赖与接力
166
+
167
+ | 提供方 → 消费方 | 交付内容/契约 | 可开工条件 | 可联调条件 | 可验收条件 | 交接责任/阻断影响 |
168
+ |-----------------|---------------|------------|------------|------------|-------------------|
212
169
 
213
170
  ### 需求 -> Task -> Wave 覆盖矩阵
214
171
 
215
- | 需求条目 | 来源位置 | 覆盖 task | 所属 wave | 状态 |
216
- |----------|----------|-----------|-----------|------|
172
+ | 需求条目 | 原文位置 | 主责/配合 Task | Wave/业务结果 | 当前覆盖与证据 |
173
+ |----------|----------|----------------|---------------|----------------|
217
174
 
218
- ### 依赖关系
175
+ ### Task 创建顺序
219
176
 
220
- | Task | 依赖 | 被谁依赖 | 说明 |
221
- |------|------|----------|------|
177
+ | 创建序号 | Wave/支撑归属 | Task ID | Slug 建议 | 依赖与排序原因 | 当前细化/创建范围 |
178
+ |----------|---------------|---------|-----------|----------------|-------------------|
222
179
 
223
- ### 争议 / 待确认
180
+ ### 争议/待确认
224
181
 
225
- - <需要用户确认的拆分争议、提测顺序或范围边界>
182
+ - <范围、分工、操作粒度或交付顺序中仍需决定的项>
226
183
  ```
227
184
 
228
- **等待用户确认 task / wave 拆分后再继续工时评估。**
185
+ **等待用户确认 Wave、Task 边界和协作安排后,再继续工时评估。** 本 Skill 生成规划,不自动创建 Task 或外部任务卡。
229
186
 
230
187
  ### Step 5: 工时评估
231
188
 
232
- 基于确认后的 task / wave 拆分评估工时,而不是只按原始需求单元评估。
189
+ 新计划默认使用**小时(h)区间**,保留 `开发计划-工时评估.md` 入口。按当前人+Agent 的协作方式及净缺口估算,列结构根据实际职责和工作内容裁剪。
233
190
 
234
- 输出表格的列结构**根据项目实际的角色分工来定**(如前端 / 后端 / 全栈 / 测试等),不要预设。
191
+ - 说明工时记录的是工作包作业耗时还是人工投入,同一张表口径一致;人工参与、Agent 自主执行、外部等待分别说明,重叠活动不重复加总。
192
+ - 将实现、自测、联调、验收修复以及必要的设计、评审、指导和交接计入相应阶段;父级汇总不重复计子项工时。
193
+ - 根据同类已验收工作包的可核实记录、实际复用与本包未知项给出区间;仅有任务创建/完成日期不能证明有效工时。无依据时写待估、原因及下一检查点,不为填满表格编造数字。
194
+ - 不将历史人工人天机械乘以 8,或套固定 AI 提速倍率当作当前估算。保留历史原单位和依据,实际开发方式改变后重估剩余工作。
195
+ - 工时与日历交付时间分开;结合依赖、串并行、人员可用小时和等待推导排期,不把各包小时简单相加或除以人数承诺日期。
196
+ - 同一人承担的多个关键路径共享容量;Agent 并行也受共享契约、改动冲突和验证资源限制。
197
+ - 优先级以需求文档和已确认补充决定为依据;已完成范围按证据扣除,接手成本、暂停条件和旧日期重新核实。完成后有可用记录再回填实际值与偏差,逐步校准,不能从提交时间推断人工工时。
235
198
 
236
- 评估原则:
237
- - 如有 AI 编程辅助,标注基准(AI 辅助 vs 纯人工)
238
- - 复用关系明确标注
239
- - 优先级以需求文档为准
240
- - task 的依赖和 wave 的提测顺序必须影响排期
241
- - 半成品 / 前置能力 task 必须说明它服务哪个 wave
199
+ 工时表至少说明工作包、剩余范围、阶段小时区间、合计口径、依据/不确定性;分阶段估算仅在有依据时填写。近期先明确可验证的检查点,远期范围保留依赖和待估条件。目标日期与当前预测分别标注,不能将期望日期写成测算结论。
242
200
 
243
- ### Step 6: 人员分工
201
+ ### Step 6: 校验分工与排期
244
202
 
245
- 按模块边界、复用链和 wave 提测边界分工,遵循:
246
- - 复用链归同一人
247
- - 散射型变更归同一人或同一小组
248
- - 同一 wave 的关键路径要清楚
249
- - 尽量无交集;有交集时明确接口 / 数据 / 文案 / 测试责任边界
203
+ 将候选责任细化成近期可执行安排:谁提供、谁消费、何时交接、谁集成验收。说明可以并行的工作、必须接力的共享修改、关键路径和阻断项的影响。
250
204
 
251
- 输出分工表和排期建议。
205
+ 在 `开发计划-工时评估.md` 输出按实际职责组织的工作包估算和人员安排,至少能看出每人的可用小时、承担工作包、评审/指导/联调投入、交接节点与近期交付;未确认日期标为待定。与候选表共用责任和范围依据,不另造一套个人任务编号。
252
206
 
253
- ### Step 7: 生成产物文件
207
+ 人员替换时分别记录当前主责与历史交付人,保留稳定 ID、原完成状态和证据;只重新估实际剩余范围。估算发现容量或边界不成立时,回到受影响规划作局部调整,不反复确认未变化的决定。
254
208
 
255
- 默认在 `doc/<版本>/` 目录下生成:
209
+ 远期可滚动细化;用户明确要求全版本工作包时覆盖完整确认范围。规划细度与实际建档范围分别写明,不能默认把所有候选物化或擅自省略用户指定范围。
256
210
 
257
- ```text
258
- doc/
259
- └── <版本>/
260
- ├── 需求清单.md
261
- ├── 任务拆分与waves.md
262
- └── 开发计划-工时评估.md
263
- ```
211
+ ### Step 7: 保存产物与交接
264
212
 
265
- 如果用户显式指定产物路径,以用户指定路径为准;后续 `trellis-extract-prd` / `trellis-verify-task` 必须引用这个显式路径。
213
+ 默认保存到 `doc/<版本>/需求清单.md`、`任务拆分与waves.md`、`开发计划-工时评估.md`;显式目录优先。分工、接力和进度视图优先从同一规划派生,不强制增加个人台账。
266
214
 
267
- `任务拆分与waves.md` 是后续单 task PRD 的版本级来源:
268
- - `trellis-extract-prd` 从其中读取 task 候选、wave、来源需求位置和边界
269
- - `trellis-extract-prd` 批量创建 task 时必须按其中的“Task 创建顺序”执行
270
- - `trellis-verify-task` 用它检查“版本需求 -> task -> wave”的覆盖和边界一致性
271
-
272
- ---
215
+ - `trellis-extract-prd` 继承来源、Wave 业务结果、工作包责任与交接,只创建用户指定范围。
216
+ - `trellis-verify-task` 核对原文、规划及已创建的关联任务/子任务,检查覆盖、粒度、责任与集成条件。
217
+ - 工程完成和 Wave 业务验收分别保留证据;规划更新、任务迁移或改派不改变业务完成事实。
273
218
 
274
219
  ## 反模式
275
220
 
276
- - ❌ 只从需求总表提取需求(会漏掉嵌入式变更)
277
- - ❌ 跳过覆盖度确认直接做 task 拆分或工时评估
278
- - ❌ 按文档章节机械拆 task
279
- - ❌ 按页面 / 接口 / 字段碎拆 task,导致一个可验收闭环散落多处
280
- - ❌ 为避免碎拆而整个版本只建一个过大的 task,导致边界和并行开发失控
281
- - ❌ 散射型变更分给不同 task 且没有统一归组理由
282
- - ❌ wave 只按日期、人员或模块排序,没有可提测目标和完成条件
283
- - ❌ 把只有基础设施 / 迁移 / 公共组件的半成品批次标成可提测 wave
284
- - ❌ 生成 task 创建顺序时让同一 wave 的 task 被其他 wave 插开
285
- - ❌ slug 建议缺少稳定排序键,导致目录自然排序无法按 wave 聚合
286
- - ❌ 生成 task / wave 拆分后不等待用户确认,直接做工时评估或创建 task
287
- - ❌ 假设文档有特定格式或特定的角色分工模式
288
- - ❌ 当多个来源的优先级冲突时不明确说明以哪个为准
221
+ - 只看总表/标题,漏掉字段级嵌入或散射变更。
222
+ - 先按人员或技术层分任务,再反推 Wave;每个按钮自动建 Wave,或每人复制一套 Task。
223
+ - 以“每包必须有完整 UI 业务闭环”否定有稳定交接与工程验证的技术分工。
224
+ - 只有 Task 号依赖,没有具体交付、就绪条件和接收人;候选合理却放任实际子任务继续碎拆。
225
+ - 把纯技术准备、自测、合入、任务关闭或元数据整理当成 Wave 业务验收。
226
+ - 忽略共享容量、评审与联调,沿用过期工期或把换负责人当作换需求。
227
+ - 为人员展示或目录自然排序强制改名历史任务,或重复维护多份相互冲突的分工事实。