docs: 固化 TaskTree CI 环境复用判定

.agents/skills/unidesk-tasktree/SKILL.md

@@ -148,6 +148,25 @@ tasktree workflow start
 - native 阶段完成后，才提交 HWLAB source PR。
 - HWLAB v0.3 PR merge 是唯一正式交付触发。
 - API 与 worker 必须保持不同 Deployment、entrypoint、健康检查和 Secret consumption。
+- API 与 worker 的环境制品复用规则：
+  - 两者都属于 `gitops/reuse.ymal#spec.envArtifactGroups.hwlab-ts-runtime-env`；
+  - 两者共享相同依赖 identity 和环境镜像，但保留各自代码 identity；
+  - catalog bootstrap、失效或依赖环境重建时，最多只允许一个 TaskTree 环境构建；
+  - catalog 健康的 code-only 变更应保持零环境构建，只滚动受影响的独立 workload。
+- TaskTree CI 性能检查使用 HWLAB 仓库内的只读 planner：
+
+```bash
+node scripts/ci-plan.mjs \
+  --lane v03 \
+  --base-ref <base-ref> \
+  --target-ref <target-ref> \
+  --services hwlab-tasktree-api,hwlab-tasktree-worker
+```
+
+  - 两个服务的 `environmentInputHash` 和 `environmentImage` 必须相同；
+  - TaskTree 共享代码变更时，两者仍应同时进入 `affectedServices`；
+  - 环境必须重建时，`buildServices` 只能包含其中一个 TaskTree 服务；
+  - 不使用人工 PipelineRun 或重复 rollout 证明环境复用。
 - 不人工 mirror sync、创建 PipelineRun、执行 Argo sync 或直接修改 Kubernetes workload。
 - 只通过 `$unidesk-cicd` 观察 source commit、artifact、GitOps、Argo 和两个 runtime workload 收敛。
 - 上线后保留 native worker + 本地 dispatcher CLI 的快速开发入口。