文件
hyb-oa/.trellis/tasks/09-09-trellis-workflow-alignment/design.md
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

1.9 KiB
原始文件 Blame 文件历史

设计与依据

官方依据

  • 已安装 CLI:0.6.16。本轮使用随附指南,不声称已核对在线最新版本。
  • .agents/skills/trellis-meta/references/local-architecture/task-system.md:active task 为会话级状态,官方 start/current/finish 管理,不依赖旧全局 .current-task。
  • .agents/skills/trellis-meta/references/local-architecture/context-injection.md:workflow-state 从当前状态选块;收到的上一轮注入不代替切换后的读取。
  • .agents/skills/trellis-meta/references/customize-local/overview.md:先 current --source,最小修改项目文件,不编辑全局 npm 缓存。

根因与修复

实际恢复 task 与当时 current 返回的付款 task 不一致;官方会话解析正常,不能将旧 .current-task 不存在诊断为运行时损坏。工作迁移到隔离副本后,也未把相应命令的 cwd 和 task 核验作为固定入口。

采用既有 project-governance 记录完整合同,start/continue/before-dev/check/finish 各加短检查。工作范围或 cwd 变化时,从实际执行根目录读取 current --source;获批任务不匹配则用 start 显式切换并回读 task/phase。没有稳定身份时报告降级,不手写共享指针,不以 CLI 退出 0 代替回读成功。

验证始终在实际修改副本运行。主工作树 phase 和隔离副本验证分别记录;不把副本更新称为已集成。finish 清空会话指针与 archive 完成任务不同,未获授权不归档。保持 inline,无需开启子代理或改 hooks。

这是 AI 执行合同修复,不宣称新增了自动强制拦截。真正下一轮平台注入需观察下一轮消息;本轮可验证官方读取和渲染结果。

回退

仅撤销本 task 的治理文本差异;会话指针若要恢复,使用官方 start 明确选择下一项已获批工作。不改其他任务的验收或状态,不删除既有未跟踪目录。