From 1eb9dfcca82927254b2519c8b96878d5439fa14e Mon Sep 17 00:00:00 2001 From: Codex Date: Fri, 17 Jul 2026 05:07:50 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=B0=86=E5=BE=AE=E6=9C=8D=E5=8A=A1?= =?UTF-8?q?=E5=86=85=E9=83=A8=E5=8D=95=E5=85=83=E6=B5=8B=E8=AF=95=E5=BD=92?= =?UTF-8?q?=E5=85=A5=20L0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .agents/skills/unidesk-devlevel/SKILL.md | 12 +++++++----- .agents/skills/unidesk-temporal/SKILL.md | 2 +- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/.agents/skills/unidesk-devlevel/SKILL.md b/.agents/skills/unidesk-devlevel/SKILL.md index f9e62467..c9148c82 100644 --- a/.agents/skills/unidesk-devlevel/SKILL.md +++ b/.agents/skills/unidesk-devlevel/SKILL.md @@ -3,8 +3,8 @@ name: unidesk-devlevel description: >- UniDesk 四种开发与部署方式，定义 L0 Function、L1 Native、L2 Development 和 L3 Production 的运行形态。用户提到 devlevel、开发等级、多级调试、 - native-first、CLI 直调函数、native 前后端、开发集群、生产集群开发方式， - 或要求问题优先低等级小回环再逐级回归时使用。 + native-first、CLI 直调函数、微服务内部单元测试、native 前后端、开发集群、 + 生产集群开发方式，或要求问题优先低等级小回环再逐级回归时使用。 --- # UniDesk 开发等级 @@ -15,7 +15,7 @@ description: >- | 等级 | 名称 | 调用路径 | | --- | --- | --- | -| L0 | Function | `CLI -> native function` | +| L0 | Function | `CLI -> native function`；单个微服务内部单元测试 | | L1 | Native | `CLI -> native API -> native Worker`；`web-probe -> native Web` | | L2 | Development | `CLI -> dev K8s API -> dev Worker`；`web-probe -> dev Web` | | L3 | Production | `CLI -> prod K8s API -> prod Worker`；`web-probe -> prod Web` | @@ -29,8 +29,10 @@ description: >- - 不启动 API、Worker、Temporal、Web 或 Kubernetes workload。 - 用项目 CLI 直接调用 native function、dispatcher、repository 或本地执行器。 -- 适合函数逻辑、配置解析、数据转换、领域服务和本地文件操作的快速开发。 +- 单个微服务内部、不启动服务进程且不跨服务通信的单元测试和组件测试属于 L0。 +- 适合函数逻辑、配置解析、数据转换、领域服务、微服务内部单元和本地文件操作的快速开发。 - 只加载当前功能需要的本地依赖。 +- 测试一旦跨越 API、Worker、网络、进程或前后端边界，就使用 L1。 ## L1 Native @@ -70,7 +72,7 @@ description: >- ## 问题处理方式 - 遇到问题时，先选择能够复现根因的最低等级，建立最快的小回环。 -- 纯函数、解析和领域逻辑问题优先降到 L0。 +- 纯函数、解析、领域逻辑和单个微服务内部单元问题优先降到 L0。 - API、Worker、Workflow、前后端联调问题优先降到 L1。 - 只有依赖开发集群容器、网络、SecretRef 或共享服务时才留在 L2。 - 只有生产环境特有的数据、流量、配置或外部依赖问题才留在 L3。 diff --git a/.agents/skills/unidesk-temporal/SKILL.md b/.agents/skills/unidesk-temporal/SKILL.md index a8dfc988..4515a72f 100644 --- a/.agents/skills/unidesk-temporal/SKILL.md +++ b/.agents/skills/unidesk-temporal/SKILL.md @@ -127,7 +127,7 @@ trans NC01:k3s kubectl -n temporal get service temporal-frontend \ ## Temporal 应用的 Native-first 闭环 - 使用 `$unidesk-devlevel` 表达应用当前采用的开发方式： - - dispatcher/function 属于 L0； + - dispatcher/function 和单个微服务内部单元测试属于 L0； - native API、Worker 和 Web 属于 L1； - 开发集群 API/Worker/Web 属于 L2； - 生产集群 API/Worker/Web 属于 L3；