flower-trellis 0.6.13-beta.0 → 0.6.13-beta.10
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.
- package/enhancements/0.6/.agents/skills/trellis-check-all/SKILL.md +4 -4
- package/enhancements/0.6/.agents/skills/trellis-check-all/references/findings-and-reporting.md +2 -2
- package/enhancements/0.6/.agents/skills/trellis-check-all/references/repair-and-recheck.md +4 -4
- package/enhancements/0.6/.agents/skills/trellis-check-all/references/reporting-and-disposition.md +9 -5
- package/enhancements/0.6/.agents/skills/trellis-extract-prd/SKILL.md +47 -15
- package/enhancements/0.6/.agents/skills/trellis-plan-version/SKILL.md +127 -188
- package/enhancements/0.6/.agents/skills/trellis-push/SKILL.md +22 -19
- package/enhancements/0.6/.agents/skills/trellis-push/references/output-templates.md +2 -1
- package/enhancements/0.6/.agents/skills/trellis-task-brief/SKILL.md +22 -7
- package/enhancements/0.6/.agents/skills/trellis-verify-task/SKILL.md +100 -62
- package/enhancements/0.6/.claude/skills/trellis-check-all/SKILL.md +4 -4
- package/enhancements/0.6/.claude/skills/trellis-check-all/references/findings-and-reporting.md +2 -2
- package/enhancements/0.6/.claude/skills/trellis-check-all/references/repair-and-recheck.md +4 -4
- package/enhancements/0.6/.claude/skills/trellis-check-all/references/reporting-and-disposition.md +9 -5
- package/enhancements/0.6/.claude/skills/trellis-extract-prd/SKILL.md +47 -15
- package/enhancements/0.6/.claude/skills/trellis-plan-version/SKILL.md +127 -188
- package/enhancements/0.6/.claude/skills/trellis-push/SKILL.md +22 -19
- package/enhancements/0.6/.claude/skills/trellis-push/references/output-templates.md +2 -1
- package/enhancements/0.6/.claude/skills/trellis-task-brief/SKILL.md +22 -7
- package/enhancements/0.6/.claude/skills/trellis-verify-task/SKILL.md +100 -62
- package/enhancements/0.6/overrides/conflicts.json +106 -40
- package/enhancements/0.6/overrides/patches/skills/trellis-brainstorm/planning-handoff/content.md +1 -1
- package/enhancements/0.6/overrides/patches/skills/trellis-brainstorm/planning-handoff/review-content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/phase-ownership/phase-2-check-content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/states-in-progress/common-content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/states-planning/common-content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/task-brief-review/phase-1-activate-content.md +2 -2
- package/enhancements/0.6/scripts/confirmation.md +66 -0
- package/enhancements/0.6/scripts/confirmation_policy.py +340 -0
- package/enhancements/MANIFEST.json +4 -2
- package/package.json +5 -3
- package/src/assets/flower_confirmation.py +182 -0
- package/src/assets/flower_confirmation_hook.py +57 -0
- package/src/assets/flower_confirmation_runtime/__init__.py +1 -0
- package/src/assets/flower_confirmation_runtime/claude.py +238 -0
- package/src/assets/flower_confirmation_runtime/codex.py +328 -0
- package/src/assets/flower_confirmation_runtime/runtime.py +436 -0
- package/src/assets/flower_confirmation_runtime/store.py +350 -0
- package/src/assets/flower_confirmation_runtime/transport.py +198 -0
- package/src/assets/flower_session_start.py +18 -13
- package/src/assets/flower_tui_lifetime.py +265 -0
- package/src/builtin-plugins/skill-garden/content-adapter.js +44 -1
- package/src/builtin-plugins/skill-garden/provider.js +7 -1
- package/src/builtin-plugins/skill-garden/uninstall.js +13 -5
- package/src/cli.js +1 -3
- package/src/commands/plugin.js +8 -1
- package/src/commands/uninstall.js +2 -0
- package/src/lib/config-preserver.js +1 -1
- package/src/lib/confirmation-lifecycle.js +51 -0
- package/src/lib/confirmation-uninstall.js +17 -0
- package/src/lib/flower-assets.js +28 -6
- package/src/lib/legacy-confirmation-config.js +225 -0
- package/src/lib/patch-engine.js +32 -44
- package/src/lib/platform-patch-adapters.js +15 -2
- package/src/lib/toml-default-adapter.js +1 -1
- package/src/lib/trellis-control.js +2 -0
- package/src/lib/update-transaction.js +4 -0
- package/src/patches/bundles/flower-platform-integration.json +4 -1
- package/src/patches/platforms/claude/confirmation-hooks/patch.json +112 -0
- package/src/patches/platforms/codex/confirmation-hooks/patch.json +61 -0
- package/src/patches/platforms/legacy-confirmation/patch.json +20 -0
- package/src/plugin/application-service.js +2 -0
- package/src/plugin/install/patch-planner.js +10 -0
- package/src/uninstall-patches/bundles/confirmation.json +5 -0
- package/src/uninstall-patches/patches/confirmation/patch.json +178 -0
|
@@ -4,14 +4,14 @@ description: "统一 Check-All:按行为影响选择 light/full,审查规划
|
|
|
4
4
|
---
|
|
5
5
|
# Check All 统一入口
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
本入口检查:做对了、假设成立、做全了。未命中的 profile/低频细则不预读。
|
|
8
8
|
|
|
9
9
|
## 默认流程
|
|
10
10
|
|
|
11
|
-
1.
|
|
11
|
+
1. 先单独完整读取 [reporting-and-disposition.md](references/reporting-and-disposition.md),确定最终回复前的后台准备/人工分支;不得批量截断该入口。再读 [depth-routing.md](references/depth-routing.md) 生成 `check_profile`,由它选择 light/full。
|
|
12
12
|
2. `effective_depth=light` 读 [light-profile.md](references/light-profile.md),full 读 [full-profile.md](references/full-profile.md)。两个 profile 共用 [verification.md](references/verification.md),复用当前有效验证证据;范围无法闭合时单向升级 full。
|
|
13
13
|
3. 按 profile 审查三个维度:task 的 PRD/可选 design/implement(untracked 为 N/A)、实现假设、完整性与项目规范。同一追踪与验证复用,保留独立验收判断。
|
|
14
|
-
4.
|
|
14
|
+
4. 命中下表时读细则;审查及允许的 DOC 处理后,按已读 reporting 执行准备、展示和分流。
|
|
15
15
|
|
|
16
16
|
## 按条件加载
|
|
17
17
|
|
|
@@ -27,7 +27,7 @@ description: "统一 Check-All:按行为影响选择 light/full,审查规划
|
|
|
27
27
|
|
|
28
28
|
- 默认 **audit-only collect-all**:读取、搜索、运行无业务写入的验证;不直接修复普通代码、配置、测试或任务规格语义。低风险事实漂移进入 `DOC-*` 通道,是唯一自修例外,须符合专项证据与写入边界;用户明确绝对只读时也不写 DOC。
|
|
29
29
|
- 分类先于严重度:主路径与非兜底契约问题为 `CHK-*`;失败、异常、防御保护路径问题为 `FBK-*`;可唯一证明的事实漂移候选为 `DOC-*`。两类代码问题都按实际影响评 P0/P1/P2;具体准入交给 fallback reference,不报告泛化“更健壮”偏好。
|
|
30
|
-
-
|
|
30
|
+
- 同根因合并并列全独立问题;报告前由 reporting owner 准备后台或人工确认,`修复全部` 覆盖 CHK/FBK。接受不能从摘要、dirty 状态或无关历史推断。
|
|
31
31
|
- 只在业务决策、前提失效或必需验证涉及未授权生产/外部/破坏性副作用时中途暂停;报告已完成范围和必要缺口。`[上线后验证]` 保留且不阻断,不代执行。
|
|
32
32
|
- 所有检查都从本入口进入;`trellis-route` 只决定 inline/subagent。inline 主会话可处理合规 DOC;subagent 只读返回 `CHK-*` / `FBK-*` / `DOC-*` 候选、画像和证据,不编辑、不补测试、不选择修复范围、不使用 workspace-write `trellis-check`。
|
|
33
33
|
- untracked helper 只存游标:未处置 findings 或新编辑回 `implement`;通过且 disposition 继续才 `advance --stage spec`,明确停止保持 check。它不证明检查或风险接受已完成。
|
package/enhancements/0.6/.agents/skills/trellis-check-all/references/findings-and-reporting.md
CHANGED
|
@@ -57,7 +57,7 @@
|
|
|
57
57
|
- 后续重检完整展示新增、实质变化、接受失效及仍待处置的问题;未变化且接受仍有效的问题只汇总数量,计入报告总数与接受数,不重复字段。无须展开的通道省略问题区块。
|
|
58
58
|
- 恢复会话、验证进展和 Update-Spec 内部沿用有效接受记录,不主动复述;Push 按其输出 reference 汇总。用户要求详情时再展开指定问题的原报告与当前处置。
|
|
59
59
|
- 原报告或接受依据无法恢复时,说明缺口并针对受影响项目补核,不凭摘要伪报通过或要求全部重接受。复用现有对话或任务记录,不新增展示次数、状态文件或报告附件。
|
|
60
|
-
- 接受后按 `reporting-and-disposition.md` 的 Gate
|
|
60
|
+
- 接受后按 `reporting-and-disposition.md` 的 Gate 推进;明确“仅接受、不继续”时只更新处置。仍有未处置问题或阻塞时说明剩余项,交由 reporting owner 决定后台准备或人工停止,不在本文件另设人工必答门槛。接受风险不替代 Push 的精确计划确认。
|
|
61
61
|
|
|
62
62
|
## 输出:统一检查报告
|
|
63
63
|
|
|
@@ -157,7 +157,7 @@ interactive 完成检查与允许的 DOC 修复后,先自然说明实际改动
|
|
|
157
157
|
|
|
158
158
|
## 修复与重检
|
|
159
159
|
|
|
160
|
-
用户选择 `修复全部`、混合精确问题 ID
|
|
160
|
+
用户选择 `修复全部`、混合精确问题 ID 或其它明确修复范围,或 reporting owner 验证 policy_timeout claim 与 started 后,必须先读取 `references/repair-and-recheck.md`;没有上述授权不加载。
|
|
161
161
|
|
|
162
162
|
修复完成后输出:
|
|
163
163
|
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
# Repair And Recheck
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
仅在用户选择或 reporting 验证 claim/started 后读取;其余只读。
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
范围为用户选择的 `修复全部`/精确 ID,或有效后台回执的全部项:
|
|
6
6
|
|
|
7
|
-
本修复续行优先于新需求分类和 Active Task Scope Guard
|
|
7
|
+
本修复续行优先于新需求分类和 Active Task Scope Guard:按受检事项、报告证据和选定范围归属;跨模块、既有缺陷或标题/Brief 未列明不构成新需求。不得因此新建或纳管任务,也不得重走首次 Brief 确认;材料同步沿用 `trellis-task-brief` 增量规则。
|
|
8
8
|
|
|
9
9
|
1. 指针缺失时先按既有恢复规则找回受检事项,不以新建任务代替恢复;无法唯一确定归属时只补核该信息。主会话复用当前 task 已有的合法 implement route;untracked 则重新直接读取个人 pref。不存在合法 route 时进入 `trellis-route(target=implement)`,由其统一解析选择或内置缺省。
|
|
10
10
|
2. 修复过程中不对每个问题重复确认。
|
|
11
11
|
3. 新增业务歧义、破坏性风险、超出所选修复范围,或跨越已批准的候选、费用或生产操作边界时才暂停;一次说明变化及受影响问题,只确认尚未决定的增量,不重复审批已选修复。
|
|
12
|
-
4. 完成定向验证后复用当前 check route 重新执行 Check-All
|
|
12
|
+
4. 完成定向验证后复用当前 check route 重新执行 Check-All;后台回执在重检结束后记 completed,不以定向验证代替重检。
|
|
13
13
|
5. 原 ID 沿用,新根因递增。后续按当前 diff 选深度:原 finding、修复路径、引用/回归和定向证据均闭合时可 light;范围扩大、契约/基线变化、未知 dirty 或证据失效时 full。
|
|
14
14
|
|
|
15
15
|
完成后返回 `references/reporting-and-disposition.md`,加载 `references/findings-and-reporting.md` 的修复结果模板,再按既有 Gate 分流。
|
package/enhancements/0.6/.agents/skills/trellis-check-all/references/reporting-and-disposition.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Reporting And Disposition
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
本文件拥有报告与分流;按实际分支读取:
|
|
4
4
|
|
|
5
5
|
- full 报告、存在 CHK/FBK/DOC、风险接受或修复重检,以及其它未通过/阻塞/部分验证结果:读 `references/findings-and-reporting.md`,保留完整模型、分类分区、证据和增量展示;未变化的有效已接受问题不重复展开。
|
|
6
6
|
- validated auto-loop:读 `references/auto-loop-return.md`,匹配 action 的 record 成功后立即 next;不渲染交互报告。
|
|
7
7
|
- 普通 light strict pass:只执行下方简短格式,不读取上述细则。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
默认对话报告;明确导出或已有交付约定才保存附件。Maven/runner 沿用机器证据;不以链接替代正文。
|
|
10
10
|
|
|
11
11
|
## Light 通过报告
|
|
12
12
|
|
|
@@ -40,16 +40,20 @@ untracked helper 不存检查证据或风险接受。通过且按下方 Gate 默
|
|
|
40
40
|
|
|
41
41
|
## Interactive Post-Check Stop Gate
|
|
42
42
|
|
|
43
|
-
非 validated auto-loop
|
|
43
|
+
非 validated auto-loop 最终回复前按以下 Gate 准备与展示;接受状态不重贴报告:
|
|
44
44
|
|
|
45
45
|
1. 先识别当前事项最新有效的明确停止要求:`只检查`、`只读检查`、`检查后停止`、`暂不收尾`、`仅接受、不继续` 等。停止收尾,不运行 Update-Spec 或生成 Git 计划;同一事项后续明确继续可解除该限制。普通“检查一下”不等于只检查后停止,不从无关历史或摘要猜测限制。
|
|
46
|
-
2.
|
|
46
|
+
2. blocked、阻断型部分验证或未决实质风险(`[上线后验证]` 除外)报告并保持人工,不进入 Spec/Git。普通 CHK/FBK 进入“后台处置”,不因检查或 Git 请求自行修复/接受风险。
|
|
47
47
|
3. 没有有效停止要求且 strict pass,或全部 findings 已有效接受时,默认同轮继续;通过条件沿用已加载 findings reference 的风险接受规则和本文件验证阶段,完整登记的 `[上线后验证]` 不阻断。报告或简短确认后同轮进入 Update-Spec,`no-op|written` 再到 Push,`needs-review` 停止。无需 direct Git intent 或额外回复“继续”,通过不授权 Git 写入。
|
|
48
48
|
4. 只从当前完成链证据识别 direct Git intent,保留 push / 用户主动 `commit-only` 选择;不从无关历史、摘要、dirty 状态或 auto-loop action 推断。风险接受沿用 findings reference 的证据规则。
|
|
49
49
|
|
|
50
|
+
### 后台处置
|
|
51
|
+
|
|
52
|
+
最终回复前读取 `.trellis/scripts/confirmation.md`:普通待处置项必须 项目 `prepare` 完整报告/全部 findings/版本,成功后后台 `wait`,原样完整展示 `display`。实际失败说明原因;只检查、停止、本机制自身开发验证等排除项保持人工。提醒仅 `claimed=true`、`source=policy_timeout`、`action=repair_all_and_recheck` 且 started 成功才修复重检并记终态。准备不需领取。
|
|
53
|
+
|
|
50
54
|
### 交互式下一步引导
|
|
51
55
|
|
|
52
|
-
|
|
56
|
+
interactive 标准报告末尾必须输出 `### 下一步`,并按首个命中分支给出主动作:
|
|
53
57
|
|
|
54
58
|
1. 有未处置 findings:提示 `修复全部`、精确 ID、接受当前报告全部风险、`接受风险 <ID> 并继续` 或 `仅保留报告`;不逐项重复确认。
|
|
55
59
|
2. 有 blocked、阻断型部分验证或未标记 `[上线后验证]` 的实质风险:指出所需决策、授权或验证,完成后重跑 Check-All;不自行执行生产、外部或破坏性操作。
|
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: trellis-extract-prd
|
|
3
|
-
description: "Extract a
|
|
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
|
-
|
|
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
|
|
16
|
-
4. **wave
|
|
15
|
+
3. **task 是内聚工作包** — 有明确输出、工程验证、消费方及集成去向;允许有稳定交接的技术分工。单包无需覆盖整个用户操作链,包内字段、按钮和测试步骤用 Checklist
|
|
16
|
+
4. **wave 对应业务操作结果** — 继承业务角色、起始条件、操作及可验收结果,说明本包贡献和集成责任。Wave 业务验收与 Task 工程完成分别判断,不新增任务状态或强制 Wave 目录
|
|
17
17
|
5. **文案原封不动** — 原始文档中出现的用户可见文案(按钮文字、提示语、Toast、弹窗内容、表头、placeholder 等)必须**逐字引用**,禁止改写、缩略或意译
|
|
18
18
|
6. **标注出处** — 每条需求 / AC 标注来源位置(文档行号、章节编号或页码)
|
|
19
|
-
7.
|
|
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
|
-
-
|
|
64
|
-
-
|
|
64
|
+
- 当前主责、协作者、已有完成范围与历史交付证据
|
|
65
|
+
- 已核实的仓库/模块边界、共享契约的维护责任
|
|
66
|
+
- 依赖提供方、具体输入/输出、消费方与接收条件
|
|
67
|
+
- 可开工/可联调/可验收前提、本包工程完成标准
|
|
65
68
|
- Task 创建顺序和 slug 建议(如存在)
|
|
66
69
|
|
|
67
70
|
如果用户要求批量生成多个 task:
|
|
68
71
|
- 必须优先按版本规划产物中的「Task 创建顺序」执行。
|
|
69
72
|
- 如果版本规划产物没有「Task 创建顺序」,必须先补齐或请用户确认顺序;不要按需求文档顺序、Task ID 字面顺序或临时判断直接创建。
|
|
70
|
-
-
|
|
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
|
-
|
|
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-`
|
|
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
|
-
- ❌
|
|
293
|
+
- ❌ 按人员或技术层自动复制 Task,或将无独立输出/验证的字段、按钮、测试步骤变成持久任务
|
|
294
|
+
- ❌ 要求每个有稳定交接的技术工作包独立提供整个业务操作链
|
|
295
|
+
- ❌ 将协作安排、Mock 成功或工程完成标准伪装成原始业务 AC 或 Wave 已验收
|
|
264
296
|
- ❌ 未找到版本规划产物时自行编造 wave id 或 Task ID
|
|
265
297
|
- ❌ 把 wave 当成独立 task 目录或 `task.py` 状态
|
|
266
298
|
- ❌ 批量创建 task 时忽略版本规划的「Task 创建顺序」
|
|
267
|
-
- ❌
|
|
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 |
|
|
307
|
+
| `trellis-plan-version` | skill | 全文需求扫描 → 业务操作 Wave → 工作包、交接与容量规划 | 版本规划阶段 |
|
|
276
308
|
| `trellis-brainstorm` | skill(上游) | 对话式需求发现(**无原始文档时**) | 需求模糊时 |
|
|
277
|
-
| `trellis-extract-prd` | skill(本技能) |
|
|
278
|
-
| `trellis-verify-task` | skill |
|
|
309
|
+
| `trellis-extract-prd` | skill(本技能) | 提取原文与工作包 Scope,继承 Wave 业务结果、责任、交接及工程标准 | 任务开发前、有正式需求文档时 |
|
|
310
|
+
| `trellis-verify-task` | skill | 校验原文、三件套、版本规划和实际关联任务的覆盖、粒度及协作条件 | PRD / Design / Implement 生成后 |
|