文件

T

wangsli和Claude Sonnet 5 c4025083af 落地任务复用治理规则与 worktree 对齐检查 [09-09-trellis-workflow-alignment]

2026-09-09 本地已验证完成、待交审的治理修复，一直未提交：

- 6 个 skill（trellis-before-dev/brainstorm/check/continue/finish-work/start）
  统一改为"先检查当前和直接相关既有任务，复用优先于新建"，取代原来"复杂任务
  先请求新建 task"的默认动作；新增 worktree/active-task 一致性校验步骤。
- project-governance.md 新增两节：Task Reuse（任务复用判据）、Active Task And
  Worktree Alignment（激活任务与实际执行 worktree 一致性检查，防止跨 worktree
  会话把上一个任务的 workflow-state 当成当前任务）。
- workflow.md 的 Request Triage / Parent-Child 章节、no_task 面包屑同步改写。

本地已过 task validate、check-trellis-governance.mjs、check-process-contract.mjs、
audit-docs.mjs、git diff --check；无业务代码改动。

Co-Authored-By: Claude Sonnet 5 <[email protected]>

2026-09-25 20:40:28 +08:00

5.3 KiB

原始文件 Blame 文件历史

执行清单

读取随附官方指南、CLI 版本和当前任务来源，确认不是会话解析故障。
公布最小方案，建立本任务合同；不扩业务或部署范围。
官方 start 激活本 task，回读 current 和 phase。
同步治理 spec、相关五个 skill 及既有交付事实源。
临时 fixture 验证会话隔离与任务切换；验证实际修改根目录和本轮 diff。
记录本地验证、独立复核、平台下一轮注入及提交状态。

验证命令

python3 .trellis/scripts/task.py current --source
python3 .trellis/scripts/get_context.py --mode phase --step 2.1 --platform codex
python3 .trellis/scripts/task.py validate .trellis/tasks/09-09-trellis-workflow-alignment
node scripts/qa/check-trellis-governance.mjs
node scripts/qa/check-process-contract.mjs --baseline --json
node scripts/qa/audit-docs.mjs --check-registry
git diff --check

本轮不运行产品测试或部署；无业务代码更改。会话切换 fixture 使用临时目录和显式测试 context id，不触碰真实付款/恢复任务。

2026-09-09 执行与验证结果

执行根目录：主工作树，产品基线 b918530；本轮主工作树治理修复与 ops-preparation 既有未提交记录物理分离。未复制、修改或提交其恢复/错误解释文档。

官方 start/current --source 回读为本 task，session 来源；phase 2.1 返回主会话实施指引。没有写旧全局指针，没有改会话运行时实现。
临时目录调用官方 common.active_task：同会话 first→second 切换、两会话隔离、finish 清除当前指针但不修改 task 状态、剩余唯一会话 fallback 均通过。fixture 自动清理，没有改真实业务任务。
首轮 fixture 将 finish 后默认 current 应为 none 当作前提而失败；阅读官方实现后确认存在 single-session fallback，修正测试预期并补充核对来源的规约，未为让测试通过修改官方代码。
以当前会话环境手动运行既有 inject-workflow-state.py，断言输出含本 task、inline、trellis-before-dev，不再含旧付款任务标题。此为渲染验证，非新一轮平台实际投递验收。
首轮 governance 报本 task 缺 Scope/Out of Scope/Test Plan 与 metadata scope；已补齐合同并使用官方 set-scope，再跑 PASS。task validate、process contract、diff 检查通过。
docs registry：errors=0、warnings=1，提示 22 个未注册文档。本轮没有新增 docs 文件，未扩范围批量登记或清理该警告。
inline 主会话完成只读差异检查，无独立 reviewer；真实下一轮平台注入待观察。没有新增自动强制拦截，规则与官方解析是两层证据。

实施	发布	验收	等谁/什么
本地治理修复完成，未提交	不适用，不部署	本地运行时/渲染与治理检查通过	下一轮观察真实注入；独立复核未做；提交/推送/归档另批

官方 start 提示当前 main 与 base_branch 相同，未来 archive 的分支/PR 门禁尚未处理。本轮无新建分支或归档授权，不为消警告伪造 branch/PR/完成状态；本 task 保持 in_progress，处于本地验证完成、待交审阶段。下一项 seed 治理未激活或实施。

后续交接更新

用户采纳后续队列建议后，本会话实际收到的平台 workflow-state 已显示 trellis-workflow-alignment，补齐了前轮仅手动渲染、下一轮投递待观察这一项。主会话复核既有 diff 与授权边界，未发现需扩大本次修复的项；独立 reviewer 仍未执行。文件保留待提交，用户“采纳建议”不扩展成提交/推送授权。

通过官方 create 转入 09-09-existing-deploy-seed-separation 的 planning 阶段，仅创建规划合同和只读核对源码；未开始 seed 实现。前段“下一项未激活”为当时状态。后续 seed 产品改动必须独立执行工作树，不叠加到本轮待交审的治理文件。

经验精简：优先复用 task（用户已批准）

本轮用户明确要求更新、精简不合适经验，复用本 task 承载，不再为规则修正规划新目录。已修正 workflow 的“复杂任务先请求新建”、start 的“无当前任务就新建”以及 brainstorm 的“必须先取得新建授权”三个入口，统一为先检查当前和直接相关既有任务。完整归属规则集中在 project-governance 的 Task Reuse，其余入口引用，不为每次小修复制整套文档。

任务归属、工作树隔离、提交拆分分别决定；小修并非一律归当前任务，跨领域有现成归属则回对应 task。新增风险或实质范围仍需批准，纯咨询/微小编辑不强制 task；不批量合并、归档或重开历史任务。

本次实例：迁移状态 SIGPIPE 误判由 09-06-release-gate-integrity 的新增修复阶段承接。seed task 保留已复现证据和依赖链接，撤回“必须独立新建 task”的建议；主工作树与 seed 副本的本 task 记录同步，不迁移产品差异。门禁旧冻结交审材料及旧验收不改，新增阶段仍未实施。

本轮只读主会话检查及文档治理验证；没有独立 reviewer、提交、推送、部署或新任务目录。当前继续激活工作流修复 task，不把经验更新冒充预检产品修复。

5.3 KiB 原始文件 Blame 文件历史 Unescape Escape