flower-trellis 0.6.13-beta.1 → 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-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/.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-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/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;不自行执行生产、外部或破坏性操作。
|
|
@@ -5,11 +5,15 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
|
|
|
5
5
|
|
|
6
6
|
# Trellis Push
|
|
7
7
|
|
|
8
|
-
`trellis-push`
|
|
8
|
+
`trellis-push` 独占 Phase 3.4:精确计划、提交推送、task 进度及 untracked 清理。
|
|
9
9
|
|
|
10
10
|
## 职责与条件入口
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
人工确认或有效 policy_timeout claim 与 started 回执之前,禁止 `git add`、`git commit` 或 `git push`。准备后台等待不执行 Git 写入。
|
|
13
|
+
|
|
14
|
+
最终回复前按 `.trellis/scripts/confirmation.md`:已有授权续接;只看计划/停止、本机制自身开发验证或未决风险保持人工。其余必须 项目 `prepare` 完整计划及精确范围;成功后后台 `wait`,原样完整展示 `display` 并结束回合。失败报告实际原因。提醒仅 `claimed=true`、`source=policy_timeout`、`action=execute_git_plan` 且 started 成功进 Step 4,后记终态。准备不需领取,回执不是人工确认,不扩大范围。
|
|
15
|
+
|
|
16
|
+
普通模式精确计划确认一次后 commit + push;仅用户要求本地提交才 commit-only,不写任务进度。task 普通计划含独立记录提交。
|
|
13
17
|
|
|
14
18
|
- 只提交 planned exact files,保留无关 dirty/staged;不用 `git add .` / `git add -A`,不要求整体 clean。
|
|
15
19
|
- untracked 只接受 `stage=push`,游标不替代证据、计划、确认或 Git 检查;无任务也可普通提交。
|
|
@@ -38,24 +42,24 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
|
|
|
38
42
|
|
|
39
43
|
## Step 1:发现仓库与任务
|
|
40
44
|
|
|
41
|
-
|
|
45
|
+
候选仓库:
|
|
42
46
|
|
|
43
47
|
- 含 `.trellis/` 的父仓根目录。
|
|
44
48
|
- `.trellis/config.yaml` 中 package 路径对应的独立 Git root。
|
|
45
49
|
- 用户明确指定的候选仓库。
|
|
46
50
|
|
|
47
|
-
|
|
51
|
+
Git root 去重;非独立仓库的 package 归父仓。
|
|
48
52
|
|
|
49
|
-
|
|
53
|
+
仓库展示名取匹配 package 名,否则用 Git top-level 目录名。`root`、`parent`、`main repo` 仅为输入别名,不用于展示。
|
|
50
54
|
|
|
51
|
-
|
|
55
|
+
task/untracked 均可选:
|
|
52
56
|
|
|
53
57
|
```bash
|
|
54
58
|
python3 ./.trellis/scripts/task.py current --source || true
|
|
55
59
|
python3 ./.trellis/scripts/task_progress.py status --json || true
|
|
56
60
|
```
|
|
57
61
|
|
|
58
|
-
|
|
62
|
+
有活动任务则计划前读 [task-progress.md](references/task-progress.md),获取文件级状态:
|
|
59
63
|
|
|
60
64
|
```bash
|
|
61
65
|
git status --short --untracked-files=all -- <task-dir>
|
|
@@ -67,7 +71,7 @@ git status --short --untracked-files=all -- <task-dir>
|
|
|
67
71
|
|
|
68
72
|
## Step 2:预检与文件归属
|
|
69
73
|
|
|
70
|
-
|
|
74
|
+
逐仓读取:
|
|
71
75
|
|
|
72
76
|
```bash
|
|
73
77
|
git status --short
|
|
@@ -95,34 +99,33 @@ git rev-list --reverse @{u}..HEAD 2>/dev/null || true
|
|
|
95
99
|
|
|
96
100
|
存在无法归属的历史 ahead 时,先按 [git-special-cases.md](references/git-special-cases.md) 审计候选 GC;仍无法归属则停止。普通路径不运行物理 GC。
|
|
97
101
|
|
|
98
|
-
|
|
102
|
+
业务文件分两组;当前任务记录按下方独立提交:
|
|
99
103
|
|
|
100
104
|
- `planned`:本轮明确归属且准备提交的 exact files。
|
|
101
105
|
- `retained`:当前存在、但本次明确不提交并保持原状的 dirty paths,包含计划外 untracked、unstaged、staged 文件。clean files 不进入该集合。
|
|
102
106
|
|
|
103
107
|
普通模式存在活动任务时,当前任务目录中已存在且可归属的 dirty/untracked 产物不进入业务 `planned`,也不进入 `retained`;它们与预计由 helper 更新的 `<task-dir>/task.json` 组成 Step 5 的任务记录 exact files。其他任务目录和无法归属当前任务的文件仍属于 `retained` 或风险,不得顺带提交。
|
|
104
108
|
|
|
105
|
-
|
|
109
|
+
多仓/生成链先读 [git-special-cases.md](references/git-special-cases.md)。
|
|
106
110
|
|
|
107
|
-
|
|
111
|
+
展示名为“保留未提交的变更(dirty)”,阈值由模板所有;保留 exact paths/状态,摘要不得作 pathspec。未知 ahead、分支/upstream 或归属异常列风险;retained 不默认阻塞。
|
|
108
112
|
|
|
109
|
-
|
|
113
|
+
计划/基线默认留在上下文;跨进程或恢复才存 gitignored runtime。不生成 `retained.md` 等展示附件,不纳入任务产物或提交;runner 沿用原契约。
|
|
110
114
|
|
|
111
|
-
|
|
115
|
+
允许 `retained`;记录并保留计划外 staged set。新增文件须重新计划和确认,不静默扩大范围。
|
|
112
116
|
|
|
113
117
|
## Step 3:展示最小计划
|
|
114
118
|
|
|
115
|
-
确认前禁止 `git add`、`git commit` 或 `git push`。
|
|
116
|
-
|
|
117
119
|
普通模式或用户 `commit-only` 在所有计划数据已经收敛、即将展示用户可见计划时,读取 `references/output-templates.md` 的“计划模板”和“共用展示规则”再渲染;已读、未变化且内容仍可用时直接复用。
|
|
118
120
|
|
|
119
|
-
|
|
121
|
+
模板缺失、不可读或缺章时报 `阻塞`,不得凭记忆重建、缩写或自制替代模板。
|
|
122
|
+
|
|
123
|
+
多仓只确认一次。已展示生成命令和预计 exact files 时,成功且无列表外新 dirty 沿用原确认;内容/hash/统计变化不重问。其它边界变化按 Step 4 重规划。
|
|
120
124
|
|
|
121
|
-
普通多仓只确认一次。计划已展示生成命令和预计 exact files 时,命令成功且没有出现预计列表外的新 dirty path 就沿用原确认;内容、hash 或统计变化不重问。其它计划边界变化仍按 Step 4 重新规划。
|
|
122
125
|
|
|
123
126
|
## Step 4:精确提交与推送
|
|
124
127
|
|
|
125
|
-
|
|
128
|
+
逐仓按序执行,先复核 planned files、分支、HEAD、upstream、冲突、staged、全部 dirty paths 和 retained 摘要;普通推送还须逐个重验计划中已验证 GC 的完整哈希与当前 `@{u}..HEAD`。任一关键条件变化都停止当前执行并重新规划。普通模式仅 `retained` 内容变化时可更新说明。
|
|
126
129
|
|
|
127
130
|
普通精确提交:
|
|
128
131
|
|
|
@@ -160,7 +163,7 @@ git push origin <current-branch>
|
|
|
160
163
|
|
|
161
164
|
untracked 的全部已确认 Git 动作成功后,最后运行 `python3 ./.trellis/scripts/untracked_flow.py clear --reason completed --work-id <work-id>`。清理成功才报告完成链已结束;任一仓库、push 或清理失败都保留状态并报告恢复位置,禁止因部分成功伪造完成。用户 `commit-only` 的已确认动作全部成功时同样可以完成并清理。
|
|
162
165
|
|
|
163
|
-
普通模式、用户 `commit-only` 或 untracked
|
|
166
|
+
普通模式、用户 `commit-only` 或 untracked 展示结果前,读取 `references/output-templates.md` 的“共用展示规则”、“结果模板”和“结果补充规则”;原文未变化且仍可用则复用,变化或缺失才重读。
|
|
164
167
|
|
|
165
168
|
reference 缺失、无法读取或缺少对应章节时停止并报告 `阻塞`,不得凭记忆重建、缩写或自制替代结果。auto-loop 内部 `commit-only` 不读取或渲染该交互式结果模板,只按 Step 4 的失败保留契约向调用方返回逐仓 commits、files、retained、message 和失败位置,由 `trellis-auto-loop` 完成 `record + next`。
|
|
166
169
|
|
|
@@ -46,11 +46,12 @@
|
|
|
46
46
|
- **进度**:completed=<...> | partial=<...> | next=<...>
|
|
47
47
|
- **执行**:<business commit/push -> `task_progress.py write --complete`(含 Close) -> task-record commit -> task-record push>
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
<确认尾注:按下方规则选择后台或人工分支>
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
## 共用展示规则
|
|
53
53
|
|
|
54
|
+
- 最终回复前执行 Step 3:后台模式以调整方式替换占位尾注作为 prepare 的 body,再完整展示返回的 `display`,不同时追加人工必答结尾。人工模式尾注为“本次保持人工确认:<具体原因>。确认执行请回复 `确认`。可调整:`只提交`、`修改 message`、`展开文件`、`展开保留变更`。”
|
|
54
55
|
- 计划与结果须保留模板标题层级、字段顺序及 `- **字段**:值` 列表格式,仅替换占位内容、按条件省略;不得改成摘要表格、裸段落或依赖行尾空格换行,简洁要求不适用于模板结构。
|
|
55
56
|
- 「任务记录」仅普通模式有活动任务时展示,须用与仓库区平级的 `###` 小节,不用方括号条件行代替标题。
|
|
56
57
|
- 计划中单仓 `planned` 不超过 8 个文件时完整列出。
|
|
@@ -21,18 +21,30 @@ description: "从最新 prd.md、design.md、implement.md 生成、刷新、校
|
|
|
21
21
|
- 不要在 `brief.md` 里发明三件套没有表达的新需求。必填字段缺失时写“未明确”,并提示应补充三件套;没有明确技术机制时省略 `Technical Overview`,没有具体风险时省略 `Risks`。
|
|
22
22
|
- `Goal` 保持一句话,`Scope` 只写本轮纳入的行为或改动对象;延期事项归入 `Non-Goals`,不另设栏目,也不把范围、方案和验收写成同义复述。
|
|
23
23
|
- 首次开工评审或用户明确要求查看全貌时,写回 `brief.md` 后必须展示 brief 正文,不要只给文件路径;首次批准后的同步按下方增量规则展示变化。
|
|
24
|
-
-
|
|
24
|
+
- 首次实施前必须展示完整 brief;先按下方“确认模式”选择并实际执行对应分支,再结束回合。已有同一 Brief 的人工批准、有效明确预授权或合法 runner 授权可按其范围续接;其余合资格交互必须先尝试后台准备,不能直接套人工模板停止。未取得人工授权或有效 policy_timeout 领取及 started 回执前,不运行 `task.py start`。
|
|
25
25
|
- “开始做吧”“按你建议来”“可以创建任务”等普通实现或建任务意图不是 Brief 预授权,不能据此跳过确认。
|
|
26
26
|
- 普通交互预授权只依赖当前对话中仍然明确可见的用户表达,不建立跨会话永久偏好,也不写 session runtime;auto-loop 恢复由上方 runner 例外所有。
|
|
27
27
|
- `in_progress` 阶段只读取 brief 和任务材料,不例行重新生成、展示或确认;新会话或压缩恢复同样如此。首次批准后的方案变化按下方增量规则处理,用户明确要求查看时再完整展示。
|
|
28
28
|
- `in_progress` 阶段发现缺失 brief 时,不自动生成未经 review 的 brief;先读取三件套并建议回补。只有用户明确要求当场回补并 review 时,才继续写回 `brief.md`。
|
|
29
29
|
- 不要机械限制 brief 或对话展示长度;信息完整优先,不能截掉会影响实现判断的范围、约束、风险或验收条件。
|
|
30
30
|
|
|
31
|
+
## 确认模式
|
|
32
|
+
|
|
33
|
+
最终 Brief 写回后、输出最终回复前,依序执行:
|
|
34
|
+
|
|
35
|
+
1. 已有内部到期提醒:先按 `.trellis/scripts/confirmation.md` 领取,不重建请求。只有实际 `claimed=true`、`source=policy_timeout`、`action=implement` 且 `started` 记账成功,才运行原 `task.py start` 与 route;回执不代表人工确认。
|
|
36
|
+
2. 有同一 Brief 的有效人工批准、明确预授权或合法 auto-loop action:按对应授权续接,不叠加计时。
|
|
37
|
+
3. 用户明确“只规划 / 不开始 / 展示后停止”、产品决定未收敛、本机制自身开发验证:展示完整 Brief,说明具体原因并保持人工。普通“创建任务 / 开始做”本身不属于显式停止。
|
|
38
|
+
4. 其余普通 Codex / Claude 交互:必须读取 `.trellis/scripts/confirmation.md`,实际执行 项目 `prepare`;不要求用户额外说“开启超时”,也不以尚无领取回执为由跳过准备。`prepared=true` 后用原生后台 terminal/Bash 启动 `wait`,最终回复原样完整展示返回的 `display` 并结束回合。
|
|
39
|
+
5. 禁用、坏配置、能力缺失或工具失败:使用实际返回原因,展示完整 Brief 和人工确认提示;无法读取入口或协议时明确缺失位置。不得未尝试就声称环境不支持,不显示虚构的倒计时。
|
|
40
|
+
|
|
41
|
+
准备和展示只建立等待;业务许可必须在到期后另行领取。人工新消息优先,材料变化使旧许可失效。
|
|
42
|
+
|
|
31
43
|
## 首次确认后的方案变更
|
|
32
44
|
|
|
33
45
|
本节区分首次完整交接及批准后的方案变更,不把规划讨论中的单项决定当成首次开工批准;不新建批准状态文件或从聊天摘要猜测授权。
|
|
34
46
|
|
|
35
|
-
1.
|
|
47
|
+
1. 首次规划仍在收敛时,持续同步三件套并只询问未决产品事项;收敛后由“确认模式”完成准备与完整展示,再等待人工回复或后台到期提醒。
|
|
36
48
|
2. 已确认目标、范围和验收不变的实现细节调整,简述调整并更新必要材料后继续;文档刷新本身不触发重新审批。
|
|
37
49
|
3. 用户明确要求 A→B,且当前指令清楚覆盖变化及其影响、没有新增待决事项时,该指令就是增量决定。先同步受影响三件套及确需更新的 Brief,展示变化说明后继续,不再询问是否确认同一调整。
|
|
38
50
|
4. 新增目标、范围、验收、风险或产品取舍尚未明确决定时,只展示相对已批准方案的变化、影响和待决事项,请用户决定变化部分;未决部分不实施,已确认部分不重复审批。新增权限、生产、真实数据、费用、外部或破坏性边界必须有适用授权,不借泛化调整扩大范围。
|
|
@@ -67,10 +79,7 @@ description: "从最新 prd.md、design.md、implement.md 生成、刷新、校
|
|
|
67
79
|
- `Acceptance`:主要可验证的验收标准;负向范围声明仅在需要回归验证时保留。
|
|
68
80
|
- `Next Step`:只写进入下一阶段后的一个直接动作,不展开完整实施计划。
|
|
69
81
|
6. 写回 `<task>/brief.md`。如果文件已存在,仍用最新三件套派生内容覆盖旧正文。
|
|
70
|
-
7.
|
|
71
|
-
- 经校验的 auto-loop `refresh_brief`:展示后返回 runner,不进入下方交互分支;schema 1 的确认由后续 action 所有。
|
|
72
|
-
- 无有效预授权:展示后结束当前回合,等待用户确认。
|
|
73
|
-
- 有有效预授权:先完整展示,再在同一回合返回主 workflow 执行 `task.py start`,不得省略展示步骤。
|
|
82
|
+
7. 按“确认模式”实际执行准备、后台启动和最终展示;不要先输出固定人工结尾再判断。说明来源文件,保留完整正文。合法 auto-loop `refresh_brief` 展示后返回 runner;有效人工授权或预授权先展示,再返回主 workflow 启动;后台模式展示后结束回合,等待原生提醒,不能在准备回合启动任务。
|
|
74
83
|
|
|
75
84
|
## 模板
|
|
76
85
|
|
|
@@ -112,13 +121,19 @@ description: "从最新 prd.md、design.md、implement.md 生成、刷新、校
|
|
|
112
121
|
|
|
113
122
|
## 展示格式
|
|
114
123
|
|
|
115
|
-
Phase 1.4 review
|
|
124
|
+
Phase 1.4 review 的后台模式:
|
|
125
|
+
|
|
126
|
+
最终回复使用 prepare 返回的完整 `display`(包含完整 Brief、实际秒数、默认动作及取消说明),不要再追加“确认后才开始”的互斥结尾。
|
|
127
|
+
|
|
128
|
+
仅显式人工分支或 prepare/wait 实际失败时:
|
|
116
129
|
|
|
117
130
|
```markdown
|
|
118
131
|
任务交接摘要已更新:<task>/brief.md
|
|
119
132
|
|
|
120
133
|
<brief.md 正文>
|
|
121
134
|
|
|
135
|
+
本次保持人工确认:<明确停止要求、排除条件或实际失败原因>。
|
|
136
|
+
|
|
122
137
|
请确认上述 brief;确认后才运行 `task.py start <task>`。
|
|
123
138
|
```
|
|
124
139
|
|
|
@@ -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/.claude/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/.claude/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;不自行执行生产、外部或破坏性操作。
|
|
@@ -5,11 +5,15 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
|
|
|
5
5
|
|
|
6
6
|
# Trellis Push
|
|
7
7
|
|
|
8
|
-
`trellis-push`
|
|
8
|
+
`trellis-push` 独占 Phase 3.4:精确计划、提交推送、task 进度及 untracked 清理。
|
|
9
9
|
|
|
10
10
|
## 职责与条件入口
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
人工确认或有效 policy_timeout claim 与 started 回执之前,禁止 `git add`、`git commit` 或 `git push`。准备后台等待不执行 Git 写入。
|
|
13
|
+
|
|
14
|
+
最终回复前按 `.trellis/scripts/confirmation.md`:已有授权续接;只看计划/停止、本机制自身开发验证或未决风险保持人工。其余必须 项目 `prepare` 完整计划及精确范围;成功后后台 `wait`,原样完整展示 `display` 并结束回合。失败报告实际原因。提醒仅 `claimed=true`、`source=policy_timeout`、`action=execute_git_plan` 且 started 成功进 Step 4,后记终态。准备不需领取,回执不是人工确认,不扩大范围。
|
|
15
|
+
|
|
16
|
+
普通模式精确计划确认一次后 commit + push;仅用户要求本地提交才 commit-only,不写任务进度。task 普通计划含独立记录提交。
|
|
13
17
|
|
|
14
18
|
- 只提交 planned exact files,保留无关 dirty/staged;不用 `git add .` / `git add -A`,不要求整体 clean。
|
|
15
19
|
- untracked 只接受 `stage=push`,游标不替代证据、计划、确认或 Git 检查;无任务也可普通提交。
|
|
@@ -38,24 +42,24 @@ description: "按确认的精确文件范围提交普通变更或完成已就绪
|
|
|
38
42
|
|
|
39
43
|
## Step 1:发现仓库与任务
|
|
40
44
|
|
|
41
|
-
|
|
45
|
+
候选仓库:
|
|
42
46
|
|
|
43
47
|
- 含 `.trellis/` 的父仓根目录。
|
|
44
48
|
- `.trellis/config.yaml` 中 package 路径对应的独立 Git root。
|
|
45
49
|
- 用户明确指定的候选仓库。
|
|
46
50
|
|
|
47
|
-
|
|
51
|
+
Git root 去重;非独立仓库的 package 归父仓。
|
|
48
52
|
|
|
49
|
-
|
|
53
|
+
仓库展示名取匹配 package 名,否则用 Git top-level 目录名。`root`、`parent`、`main repo` 仅为输入别名,不用于展示。
|
|
50
54
|
|
|
51
|
-
|
|
55
|
+
task/untracked 均可选:
|
|
52
56
|
|
|
53
57
|
```bash
|
|
54
58
|
python3 ./.trellis/scripts/task.py current --source || true
|
|
55
59
|
python3 ./.trellis/scripts/task_progress.py status --json || true
|
|
56
60
|
```
|
|
57
61
|
|
|
58
|
-
|
|
62
|
+
有活动任务则计划前读 [task-progress.md](references/task-progress.md),获取文件级状态:
|
|
59
63
|
|
|
60
64
|
```bash
|
|
61
65
|
git status --short --untracked-files=all -- <task-dir>
|
|
@@ -67,7 +71,7 @@ git status --short --untracked-files=all -- <task-dir>
|
|
|
67
71
|
|
|
68
72
|
## Step 2:预检与文件归属
|
|
69
73
|
|
|
70
|
-
|
|
74
|
+
逐仓读取:
|
|
71
75
|
|
|
72
76
|
```bash
|
|
73
77
|
git status --short
|
|
@@ -95,34 +99,33 @@ git rev-list --reverse @{u}..HEAD 2>/dev/null || true
|
|
|
95
99
|
|
|
96
100
|
存在无法归属的历史 ahead 时,先按 [git-special-cases.md](references/git-special-cases.md) 审计候选 GC;仍无法归属则停止。普通路径不运行物理 GC。
|
|
97
101
|
|
|
98
|
-
|
|
102
|
+
业务文件分两组;当前任务记录按下方独立提交:
|
|
99
103
|
|
|
100
104
|
- `planned`:本轮明确归属且准备提交的 exact files。
|
|
101
105
|
- `retained`:当前存在、但本次明确不提交并保持原状的 dirty paths,包含计划外 untracked、unstaged、staged 文件。clean files 不进入该集合。
|
|
102
106
|
|
|
103
107
|
普通模式存在活动任务时,当前任务目录中已存在且可归属的 dirty/untracked 产物不进入业务 `planned`,也不进入 `retained`;它们与预计由 helper 更新的 `<task-dir>/task.json` 组成 Step 5 的任务记录 exact files。其他任务目录和无法归属当前任务的文件仍属于 `retained` 或风险,不得顺带提交。
|
|
104
108
|
|
|
105
|
-
|
|
109
|
+
多仓/生成链先读 [git-special-cases.md](references/git-special-cases.md)。
|
|
106
110
|
|
|
107
|
-
|
|
111
|
+
展示名为“保留未提交的变更(dirty)”,阈值由模板所有;保留 exact paths/状态,摘要不得作 pathspec。未知 ahead、分支/upstream 或归属异常列风险;retained 不默认阻塞。
|
|
108
112
|
|
|
109
|
-
|
|
113
|
+
计划/基线默认留在上下文;跨进程或恢复才存 gitignored runtime。不生成 `retained.md` 等展示附件,不纳入任务产物或提交;runner 沿用原契约。
|
|
110
114
|
|
|
111
|
-
|
|
115
|
+
允许 `retained`;记录并保留计划外 staged set。新增文件须重新计划和确认,不静默扩大范围。
|
|
112
116
|
|
|
113
117
|
## Step 3:展示最小计划
|
|
114
118
|
|
|
115
|
-
确认前禁止 `git add`、`git commit` 或 `git push`。
|
|
116
|
-
|
|
117
119
|
普通模式或用户 `commit-only` 在所有计划数据已经收敛、即将展示用户可见计划时,读取 `references/output-templates.md` 的“计划模板”和“共用展示规则”再渲染;已读、未变化且内容仍可用时直接复用。
|
|
118
120
|
|
|
119
|
-
|
|
121
|
+
模板缺失、不可读或缺章时报 `阻塞`,不得凭记忆重建、缩写或自制替代模板。
|
|
122
|
+
|
|
123
|
+
多仓只确认一次。已展示生成命令和预计 exact files 时,成功且无列表外新 dirty 沿用原确认;内容/hash/统计变化不重问。其它边界变化按 Step 4 重规划。
|
|
120
124
|
|
|
121
|
-
普通多仓只确认一次。计划已展示生成命令和预计 exact files 时,命令成功且没有出现预计列表外的新 dirty path 就沿用原确认;内容、hash 或统计变化不重问。其它计划边界变化仍按 Step 4 重新规划。
|
|
122
125
|
|
|
123
126
|
## Step 4:精确提交与推送
|
|
124
127
|
|
|
125
|
-
|
|
128
|
+
逐仓按序执行,先复核 planned files、分支、HEAD、upstream、冲突、staged、全部 dirty paths 和 retained 摘要;普通推送还须逐个重验计划中已验证 GC 的完整哈希与当前 `@{u}..HEAD`。任一关键条件变化都停止当前执行并重新规划。普通模式仅 `retained` 内容变化时可更新说明。
|
|
126
129
|
|
|
127
130
|
普通精确提交:
|
|
128
131
|
|
|
@@ -160,7 +163,7 @@ git push origin <current-branch>
|
|
|
160
163
|
|
|
161
164
|
untracked 的全部已确认 Git 动作成功后,最后运行 `python3 ./.trellis/scripts/untracked_flow.py clear --reason completed --work-id <work-id>`。清理成功才报告完成链已结束;任一仓库、push 或清理失败都保留状态并报告恢复位置,禁止因部分成功伪造完成。用户 `commit-only` 的已确认动作全部成功时同样可以完成并清理。
|
|
162
165
|
|
|
163
|
-
普通模式、用户 `commit-only` 或 untracked
|
|
166
|
+
普通模式、用户 `commit-only` 或 untracked 展示结果前,读取 `references/output-templates.md` 的“共用展示规则”、“结果模板”和“结果补充规则”;原文未变化且仍可用则复用,变化或缺失才重读。
|
|
164
167
|
|
|
165
168
|
reference 缺失、无法读取或缺少对应章节时停止并报告 `阻塞`,不得凭记忆重建、缩写或自制替代结果。auto-loop 内部 `commit-only` 不读取或渲染该交互式结果模板,只按 Step 4 的失败保留契约向调用方返回逐仓 commits、files、retained、message 和失败位置,由 `trellis-auto-loop` 完成 `record + next`。
|
|
166
169
|
|
|
@@ -46,11 +46,12 @@
|
|
|
46
46
|
- **进度**:completed=<...> | partial=<...> | next=<...>
|
|
47
47
|
- **执行**:<business commit/push -> `task_progress.py write --complete`(含 Close) -> task-record commit -> task-record push>
|
|
48
48
|
|
|
49
|
-
|
|
49
|
+
<确认尾注:按下方规则选择后台或人工分支>
|
|
50
50
|
```
|
|
51
51
|
|
|
52
52
|
## 共用展示规则
|
|
53
53
|
|
|
54
|
+
- 最终回复前执行 Step 3:后台模式以调整方式替换占位尾注作为 prepare 的 body,再完整展示返回的 `display`,不同时追加人工必答结尾。人工模式尾注为“本次保持人工确认:<具体原因>。确认执行请回复 `确认`。可调整:`只提交`、`修改 message`、`展开文件`、`展开保留变更`。”
|
|
54
55
|
- 计划与结果须保留模板标题层级、字段顺序及 `- **字段**:值` 列表格式,仅替换占位内容、按条件省略;不得改成摘要表格、裸段落或依赖行尾空格换行,简洁要求不适用于模板结构。
|
|
55
56
|
- 「任务记录」仅普通模式有活动任务时展示,须用与仓库区平级的 `###` 小节,不用方括号条件行代替标题。
|
|
56
57
|
- 计划中单仓 `planned` 不超过 8 个文件时完整列出。
|