hyb-oa/.trellis/tasks/archive/2026-07/07-26-trellis-upgrade-project-audit/implement.md

Trellis 升级实施清单

执行步骤

• 将全局 Trellis CLI 升级到 0.6.9。
• 临时隔离并恢复 .claude/settings.local.json，避免 Claude 平台误检测。
• 以 --create-new --migrate 升级项目 Trellis 模板和 runtime。
• 保留 session_auto_commit: false 与 codex.dispatch_mode: inline。
• 合并上游 workflow，并恢复 hyb-oa Trellis-first overlay。
• 保留项目 .trellis/.gitignore 的本地 workspace 排除规则。
• 保留项目 AGENTS.md，不追加重复的通用英文托管块。
• 删除冲突 .new 副本和迁移遗留的旧拼写 skill。
• 运行升级后 task/context/hooks/governance 验证。
• 运行完整本地质量门禁并记录结果。
• 评估并更新稳定 spec。
• 形成中文提交。
• 完成 Trellis task 归档。

验证结果

• Trellis CLI、项目版本与 npm latest 均为 0.6.9；升级后 dry-run 稳定。
• Python 3.9.2 compileall、task validate/current/list 与 Trellis runtime 基本命令通过。
• bash scripts/check-minimal.sh 退出码为 0：Prisma validate、服务端 985/985、前端 typecheck/build、功能矩阵均通过。
• 非阻断提示仅有既有 punycode deprecated 与 Browserslist 数据陈旧提示。

验证命令

• trellis --version
• python3 ./.trellis/scripts/get_context.py
• python3 ./.trellis/scripts/task.py validate .trellis/tasks/07-26-trellis-upgrade-project-audit
• node scripts/qa/check-trellis-governance.mjs
• node scripts/qa/audit-docs.mjs --check-registry
• node scripts/qa/check-process-contract.mjs --baseline --json
• bash scripts/check-minimal.sh
• git diff --check

回滚点

• CLI：重新安装升级前的 0.6.8。
• 项目：回退本任务升级提交；.trellis/.backup-* 只用于本地临时核对，不纳入提交。
• 若 hooks 或 task runtime 验证失败，停止后续业务工作，不以旧 workflow 混用新 runtime。