docs: 迁移 UniDesk 现场调试技能

This commit is contained in:
Codex
2026-07-15 10:24:51 +02:00
parent dcffd2e8c7
commit 0479222e3b
18 changed files with 387 additions and 17 deletions
+5
View File
@@ -28,6 +28,11 @@ description: UniDesk YAML-first 运维正规化技能。用户提到 ymal-first/
- 先执行 `git status --short --branch``git pull --ff-only origin master`;保留并绕开无关并行修改。
- 源码、配置、部署类正规化默认在独立 `.worktree/<task>` 中做;轻量 skill/docs/reference 收敛可按项目规则直接在主 worktree 做。
- YAML 是 source of truth。不得新增隐藏代码默认值、schema 数值硬限制、合同测试或测试硬编码策略。
- `$unidesk-daddev` P2 调试例外不改变 YAML-first 终态:
- 可对运行面做最小、可逆 patch 以验证根因或临时恢复;
- patch 不得反向成为配置真相、第二 authority 或自动交付成功证据;
- 验证成立后必须把变化收敛到 owning YAML、parser/renderer 或源码,
经正常 PR 与自动 CI/CD/GitOps 交付,并撤销 patch 或确认其已被声明式交付覆盖。
- 代码校验只保证字段能被正确读取和渲染:类型、必填、枚举键名、引用存在性。版本号、namespace、endpoint、容量、冷却时间、回退窗口等数值以 YAML 为准。
- YAML 文件名、YAML 解析函数名和 YAML 渲染函数名不得携带具体 node/lane 名称或版本实例(例如 `JD01``D601``v03``jd01-v03`)。node/lane/version 只能作为 YAML 变量、selector、target key、template value 或 CLI 参数参与渲染;可复用文件和代码入口必须按职责命名。
- 避免“超级配置”。当一个能力同时涉及 target/lane、runtime、scenario、prompt、report、publicExposure、Secret、CI/CD 等不同职责时,按职责拆分到 owning YAMLroot YAML 只保存归属和 `configRefs`/path 引用,不承载全部细节。