From bdadf078d50645f2a19501779ce4de77289461bd Mon Sep 17 00:00:00 2001
From: Codex <codex@local>
Date: Fri, 17 Jul 2026 11:26:00 +0200
Subject: [PATCH] =?UTF-8?q?docs:=20=E5=9B=BA=E5=8C=96=20TaskTree=20CI=20?=
 =?UTF-8?q?=E7=8E=AF=E5=A2=83=E5=A4=8D=E7=94=A8=E5=88=A4=E5=AE=9A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .agents/skills/unidesk-tasktree/SKILL.md | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/.agents/skills/unidesk-tasktree/SKILL.md b/.agents/skills/unidesk-tasktree/SKILL.md
index 6cad228b..8814923f 100644
--- a/.agents/skills/unidesk-tasktree/SKILL.md
+++ b/.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 的快速开发入口。