flower-trellis 0.6.13-beta.0 → 0.6.13-beta.2
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/README.md +39 -0
- 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 +1 -3
- package/enhancements/0.6/.agents/skills/trellis-check-all/references/reporting-and-disposition.md +3 -3
- 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 +2 -1
- package/enhancements/0.6/.agents/skills/trellis-task-brief/SKILL.md +6 -1
- package/enhancements/0.6/.agents/skills/trellis-verify-task/SKILL.md +100 -62
- 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 +1 -3
- package/enhancements/0.6/.claude/skills/trellis-check-all/references/reporting-and-disposition.md +3 -3
- 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 +2 -1
- package/enhancements/0.6/.claude/skills/trellis-task-brief/SKILL.md +6 -1
- package/enhancements/0.6/.claude/skills/trellis-verify-task/SKILL.md +100 -62
- package/enhancements/0.6/overrides/conflicts.json +8 -7
- package/enhancements/0.6/overrides/patches/skills/trellis-brainstorm/planning-handoff/content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/intent-routing/phase-summary/guardrail-content.md +1 -1
- package/enhancements/0.6/overrides/patches/workflow/phase-ownership/phase-2-check-content.md +2 -2
- 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 +25 -0
- package/enhancements/0.6/scripts/confirmation.py +427 -0
- package/enhancements/MANIFEST.json +4 -2
- package/package.json +3 -3
- package/src/assets/confirmation_process.py +146 -0
- package/src/assets/flower_session_start.py +40 -5
- package/src/builtin-plugins/skill-garden/content-adapter.js +3 -0
- package/src/cli.js +9 -4
- package/src/commands/session.js +42 -0
- package/src/constants.js +7 -0
- package/src/lib/config-preserver.js +1 -1
- package/src/lib/confirmation-harnesses.js +107 -0
- package/src/lib/confirmation-ipc.js +59 -0
- package/src/lib/confirmation-mcp.js +73 -0
- package/src/lib/confirmation-server.js +123 -0
- package/src/lib/confirmation-session.js +170 -0
- package/src/lib/confirmation-snapshot.js +58 -0
- package/src/lib/confirmation-state.js +243 -0
- package/src/lib/copy-scripts.js +12 -5
- package/src/lib/global-trellis-sync.js +2 -10
- package/src/lib/npm-node-shim.js +36 -0
package/README.md
CHANGED
|
@@ -105,6 +105,7 @@ flower-trellis -v
|
|
|
105
105
|
| `telemetry` | 查询、启用或停用用户级匿名安装遥测 |
|
|
106
106
|
| `plugin` | 管理 Flower Plugin、Marketplace 来源、GitLab 授权和作者校验 |
|
|
107
107
|
| `worktree` | 创建独立 Git 工作区,准备目标本地工具 |
|
|
108
|
+
| `session` | 通过统一前台入口启动 Codex / Claude,接入会话内限时确认 |
|
|
108
109
|
| `uninstall` | 移除 Trellis 本体并清理强化包残留(支持 `-y` / `--dry-run`) |
|
|
109
110
|
| `<其它命令>` | 原样透传给 Trellis,覆盖其现有及未来子命令 |
|
|
110
111
|
| `-v` / `-h` | 打印版本 / 帮助 |
|
|
@@ -124,6 +125,44 @@ flower-trellis -v
|
|
|
124
125
|
|
|
125
126
|
未指定平台时,交互模式会弹出多选菜单(默认勾选 Claude Code + Codex);也可直接传 `--claude` / `--codex` / `--cursor` / `--devin` / `--zcode` / `--trae` / `--omp` / `--grok` / `--kimi` / `--snow` 等指定,或用 `-y` 跳过菜单。`--windsurf` 仍作为 Devin 的旧别名透传给 Trellis。其余未识别的 flag(如 `-u`、`-f`、`--template`、`--with-statusline`)一律透传给 Trellis。
|
|
126
127
|
|
|
128
|
+
## 限时确认
|
|
129
|
+
|
|
130
|
+
项目安装或更新到包含确认协议的强化包后,通过统一入口启动交互会话:
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
ftl session -- codex
|
|
134
|
+
ftl session -- claude
|
|
135
|
+
ftl session --target ../my-project -- codex --model <模型>
|
|
136
|
+
```
|
|
137
|
+
|
|
138
|
+
`--` 后的原参数完整交给 Harness。入口仅为本次会话注册一个 MCP `wait` 工具,精确允许该等待工具;保留其它工具和权限,不写用户全局 MCP 配置。接口基线为 Codex 0.167.0、Claude Code 2.1.293,且须通过当前会话身份、工具发现和进程约束验证。原生命令继续可用,非交互、不同工作目录或独立配置模式回到人工确认;其他 Harness 和尚未验证的操作系统不启用自动模式。
|
|
139
|
+
|
|
140
|
+
Brief 首次开工、Check-All 问题处置、Push 提交计划在能力有效时默认开启。入口完整展示冻结方案、默认动作及秒数后开始等待;Brief 默认开工,检查默认修复当前全部待处置项并重检,提交沿用有效计划的 commit + push,明确 commit-only 时才仅本地提交。Spec 未决事项和新业务取舍仍由用户决定。
|
|
141
|
+
|
|
142
|
+
在 `.trellis/config.yaml` 调整秒数;省略字段采用下列默认值,更新会保留该配置:
|
|
143
|
+
|
|
144
|
+
```yaml
|
|
145
|
+
confirmation_timeout:
|
|
146
|
+
enabled: true
|
|
147
|
+
brief:
|
|
148
|
+
enabled: true
|
|
149
|
+
base_seconds: 100
|
|
150
|
+
threshold_chars: 1000
|
|
151
|
+
increment_chars: 500
|
|
152
|
+
increment_seconds: 30
|
|
153
|
+
check:
|
|
154
|
+
enabled: true
|
|
155
|
+
base_seconds: 100
|
|
156
|
+
increment_seconds: 30
|
|
157
|
+
push:
|
|
158
|
+
enabled: true
|
|
159
|
+
seconds: 200
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
Brief 超过1000字后每500字加30秒,不足一档按一档;文件首尾空白不计字。检查第一条100秒、之后每条加30秒,零条不等待。项目或单类 `enabled: false` 可关闭;损坏配置和超出工具预算会保持人工确认,不截短等待时间。
|
|
163
|
+
|
|
164
|
+
任何真实按键会先撤销尚未领取的默认决定,再交给原生界面;工具已返回而尚未领取时也可取消。材料或 Git 基线变化后必须重新展示。关闭入口会取消本次等待并结束自有 CLI 和辅助进程,重开不会补跑;已开始的副作用按实际结果报告。最小审计保存在项目 gitignored `.trellis/.runtime/confirmations/`,没有持久唤醒任务,等待期间不轮询模型。
|
|
165
|
+
|
|
127
166
|
## 并行工作区
|
|
128
167
|
|
|
129
168
|
先查看创建计划,再使用返回的指纹确认。任务参数可选,省略时只创建和准备工作区:
|
package/enhancements/0.6/.agents/skills/trellis-check-all/references/findings-and-reporting.md
CHANGED
|
@@ -63,7 +63,7 @@
|
|
|
63
63
|
|
|
64
64
|
按“接受后的增量展示”在对话中报告。不得为缩短回复、留存结论或同步任务状态新建 `check-report.md` 等附件或用链接代替应展示内容。
|
|
65
65
|
|
|
66
|
-
|
|
66
|
+
仅用户明确导出或交付约定时保存附件。Maven、auto-loop 沿用机器证据契约,不另建 Markdown;已有报告不删除或复制。
|
|
67
67
|
|
|
68
68
|
interactive 完成检查与允许的 DOC 修复后,先自然说明实际改动、行为影响和结论,再展示证据与问题:
|
|
69
69
|
|
|
@@ -157,7 +157,7 @@ interactive 完成检查与允许的 DOC 修复后,先自然说明实际改动
|
|
|
157
157
|
|
|
158
158
|
## 修复与重检
|
|
159
159
|
|
|
160
|
-
用户选择 `修复全部`、混合精确问题 ID
|
|
160
|
+
用户选择 `修复全部`、混合精确问题 ID 或其它明确修复范围,或取得有效 check claim 后,必须先读取 `references/repair-and-recheck.md` 执行修复续行;人工路径未选择时不加载。
|
|
161
161
|
|
|
162
162
|
修复完成后输出:
|
|
163
163
|
|
|
@@ -1,8 +1,6 @@
|
|
|
1
1
|
# Repair And Recheck
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
用户选择 `修复全部`、混合精确问题 ID 或其它明确修复范围后:
|
|
3
|
+
仅在用户选定当前报告修复范围或取得有效 check claim 后读取;否则保持只读。
|
|
6
4
|
|
|
7
5
|
本修复续行优先于新需求分类和 Active Task Scope Guard:归属依据是受检事项、报告证据和用户选定范围。问题跨模块、属于既有缺陷或未写入任务标题/Brief,不单独构成新需求;不得因此新建或纳管任务,也不得重走首次 Brief 确认。必要材料同步沿用 `trellis-task-brief` 的增量规则。
|
|
8
6
|
|
package/enhancements/0.6/.agents/skills/trellis-check-all/references/reporting-and-disposition.md
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
- validated auto-loop:读 `references/auto-loop-return.md`,匹配 action 的 record 成功后立即 next;不渲染交互报告。
|
|
7
7
|
- 普通 light strict pass:只执行下方简短格式,不读取上述细则。
|
|
8
8
|
|
|
9
|
-
|
|
9
|
+
默认只在对话中报告,不新建报告附件;受控跨进程确认仅按 `.trellis/scripts/confirmation.md` 使用 gitignored runtime。导出须用户明确要求或交付约定;Maven 与 runner 沿用机器证据。不得用链接代替应展示内容。
|
|
10
10
|
|
|
11
11
|
## Light 通过报告
|
|
12
12
|
|
|
@@ -43,7 +43,7 @@ untracked helper 不存检查证据或风险接受。通过且按下方 Gate 默
|
|
|
43
43
|
非 validated auto-loop 先按本文件输出标准报告或接受状态的简短确认,再依序分流;不重贴已有报告:
|
|
44
44
|
|
|
45
45
|
1. 先识别当前事项最新有效的明确停止要求:`只检查`、`只读检查`、`检查后停止`、`暂不收尾`、`仅接受、不继续` 等。停止收尾,不运行 Update-Spec 或生成 Git 计划;同一事项后续明确继续可解除该限制。普通“检查一下”不等于只检查后停止,不从无关历史或摘要猜测限制。
|
|
46
|
-
2. 未处置 `CHK-*` / `FBK-*`、blocked、阻断型部分验证或其它未接受实质风险(`[上线后验证]`
|
|
46
|
+
2. 未处置 `CHK-*` / `FBK-*`、blocked、阻断型部分验证或其它未接受实质风险(`[上线后验证]` 除外)时,不运行 Update-Spec 或生成 Git 计划。受控会话没有停止/只读要求、全部当前项可修复时,按 `.trellis/scripts/confirmation.md` 冻结完整报告和全部待处置 ID;有效 check claim 选择修复全部并重检,新业务取舍暂停。无有效 claim 时报告并停止等待人工选择;任何超时均不接受风险。受控例外以外,普通代码问题始终由用户选择修复范围;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
|
|
|
@@ -51,7 +51,7 @@ untracked helper 不存检查证据或风险接受。通过且按下方 Gate 默
|
|
|
51
51
|
|
|
52
52
|
所有 interactive 标准报告都必须在末尾输出 `### 下一步`,并按以下首个命中分支给出一个明确主动作:
|
|
53
53
|
|
|
54
|
-
1. 有未处置 findings:提示 `修复全部`、精确 ID、接受当前报告全部风险、`接受风险 <ID> 并继续` 或
|
|
54
|
+
1. 有未处置 findings:提示 `修复全部`、精确 ID、接受当前报告全部风险、`接受风险 <ID> 并继续` 或 `仅保留报告`;不逐项重复确认。受控分支说明默认动作和时长后按协议等待,不能写成已修复。
|
|
55
55
|
2. 有 blocked、阻断型部分验证或未标记 `[上线后验证]` 的实质风险:指出所需决策、授权或验证,完成后重跑 Check-All;不自行执行生产、外部或破坏性操作。
|
|
56
56
|
3. 有有效的明确停止要求且检查通过:说明已按要求停止,之后明确继续才恢复收尾。
|
|
57
57
|
4. 无有效停止要求且 strict pass / 已接受风险通过:说明本轮正在进入 `trellis-update-spec`,不要求用户再次回复“继续”;Git 计划确认仍由 Push 执行。
|
|
@@ -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 生成后 |
|