文件
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

23 行
1.9 KiB
Markdown
原始文件 Blame 文件历史

此文件含有模棱两可的 Unicode 字符
此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。
# 设计与依据
## 官方依据
- 已安装 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 明确选择下一项已获批工作。不改其他任务的验收或状态,不删除既有未跟踪目录。