docs: 明确低等级优先排错回环

2026-07-17 04:57:05 +02:00
parent 6f8e8544c0
commit fccc704f3e
5 changed files with 21 additions and 3 deletions
@@ -17,6 +17,7 @@ HWLAB G14 和 AgentRun CI/CD 的受控入口。任何 PR 监控、Tekton/Argo、
 - `$unidesk-devlevel` 用 L2 Development 和 L3 Production 描述两种集群部署方式：
  - 本 skill 负责这两种方式的自动交付、运行面操作和事故处理；
  - L0 Function 与 L1 Native 不使用 CI/CD。
+  - 能在 L0/L1 复现和修复的问题，不用反复 L2/L3 rollout 代替快速小回环；修复后再通过正常自动链回归对应集群方式。

 ## 高频入口

@@ -11,6 +11,7 @@ description: UniDesk 分布式敏捷开发流程，覆盖真实运行面探测
 - `$unidesk-devlevel` 定义 L0-L3 四种可反复使用的开发方式：
  - 本 skill 只在某一级需要跨 host 观察、最小可逆实验、故障收敛或真实入口复测时接管现场闭环；
  - 不把现场修复过程解释成等级变化。
+  - 遇到 L2/L3 问题时，优先把根因缩小到可复现的最低等级做小回环；修复后再逐级回归到原问题运行面。

 ## DAD-DEV SPEC

@@ -3,7 +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 开发等级
@@ -66,6 +67,20 @@ description: >-
 - 调试 L2/L3 问题时，可以随时回到 L0/L1 做更快的局部实验。
 - 不因为项目已经部署到 L2/L3 而跳过日常 L0/L1 开发。

+## 问题处理方式
+
+- 遇到问题时，先选择能够复现根因的最低等级，建立最快的小回环。
+- 纯函数、解析和领域逻辑问题优先降到 L0。
+- API、Worker、Workflow、前后端联调问题优先降到 L1。
+- 只有依赖开发集群容器、网络、SecretRef 或共享服务时才留在 L2。
+- 只有生产环境特有的数据、流量、配置或外部依赖问题才留在 L3。
+- 低等级无法复现时，逐级增加真实运行面因素，不在高等级连续滚动试错。
+- 修复在低等级稳定后，再逐级回归到问题原来出现的最高等级：
+  - L0 修复的 L3 问题，依次回归 L0、L1、L2、L3；
+  - L1 修复的 L2 问题，依次回归 L1、L2；
+  - 回归只覆盖受影响路径和必要依赖。
+- 这个顺序只用于问题处理，不改变四种开发方式可以自由选择和反复使用的定义。
+
 ## 项目适配

 - 项目仓库的 `AGENTS.md`、owning YAML、正式 CLI 和领域 skill 决定实际命令。
@@ -1,4 +1,4 @@
 interface:
  display_name: "UniDesk 开发等级"
-  short_description: "区分函数、native、开发集群和生产集群开发方式"
-  default_prompt: "使用 $unidesk-devlevel 为当前任务选择合适的开发或部署方式。"
+  short_description: "定义四种开发方式，并优先用低等级小回环排错后逐级回归"
+  default_prompt: "使用 $unidesk-devlevel 选择开发方式；遇到问题时先在最低可复现等级做小回环，再逐级回归。"
@@ -12,6 +12,7 @@ description: UniDesk Web 开发与受控浏览器验证技能。用户提到 Web
  - L2 使用 development semantic origin；
  - L3 使用 production semantic origin；
  - 本 skill 负责各运行面的浏览器操作，不解释项目处于哪个等级。
+  - 页面问题优先在可复现的最低等级快速修复，再按 L1、L2、L3 中实际受影响的运行面逐级回归。

 ## 快速规则