diff --git a/.agents/skills/unidesk-tasktree/SKILL.md b/.agents/skills/unidesk-tasktree/SKILL.md
index 883c4318..a1057c90 100644
--- a/.agents/skills/unidesk-tasktree/SKILL.md
+++ b/.agents/skills/unidesk-tasktree/SKILL.md
@@ -104,6 +104,18 @@ tasktree workflow start
   - 同一 dispatcher DTO 携带内容进入 API；
   - API Pod 不挂载调用端文件系统。
 - 线上模式要求 `HWLAB_TASKTREE_API_URL` 或显式 `--api-url`，并在原命令末尾增加 `--overapi`。
+- 部署态 `--overapi` 验收遵循以下入口判定：
+  - 选定 node 后只读取 `config/hwlab-node-lanes.yaml#lanes.<lane>.targets.<node>` 的 target 级入口；
+  - 禁止回退到 lane template 的默认 IP 或其他 node 的 URL；
+  - 公网 Cloud API 需要 HWLAB session 时，裸 CLI 的未认证响应不能判定 TaskTree API Pod 故障；
+  - 直连 smoke 在已部署 API Pod 内执行该 Pod 自带的同版本仓库 CLI，并把 `--api-url` 指向 localhost API；
+  - repo root、Deployment、container 和 port 必须从当前 runtime spec、Pod 启动合同与 owning YAML 解析，不写死一次性路径；
+  - 输出只保留 operation、HTTP status、group id 和 task/subtask/report/milestone 计数，不回显报告正文。
+- Temporal 部署态 smoke 使用临时 TaskGroup 与 Task：
+  - 通过同一 `--overapi` 入口创建；
+  - 启动 workflow 并确认 run id、完成状态与 report id；
+  - 使用 shell trap 或等价 finally 在成功或失败时删除临时 TaskGroup；
+  - 禁止为 smoke 改写正式导入组的任务状态或报告计数。
 
 ## 自动交付