From 5ecff66f8355f2a47eb89b4cf21a695ef4d2a32c Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 28 May 2026 08:26:05 +0000 Subject: [PATCH] docs: clarify gate minimalism principle --- docs/reference/staff-reference.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/reference/staff-reference.md b/docs/reference/staff-reference.md index 54981cb1..c66223bc 100644 --- a/docs/reference/staff-reference.md +++ b/docs/reference/staff-reference.md @@ -41,6 +41,12 @@ - 对证据不足的判断，要明确写出缺口，而不是用猜测补全。 - 如果一个想法只会增加内部复杂度，却不能降低外部痛点、提升交付速度或改善可观测性，就应优先拒绝或收窄。 +## 门禁最小化原则 + +不要滑向不必要的复杂门禁是 UniDesk 治理的通用原则，适用于 CI/CD、部署、文档治理、issue/PR 流程、runner 调度和运行面治理。优先用固定边界、唯一真相源、标准入口、清晰命名、长期参考文档和验收 checklist 收敛共识，不把每个设计约定、观测项、回滚手册或临时纠偏都升级成新的 preflight、guard、gate 或报告生成器。 + +旧门禁阻碍最新决策时，默认处理是删除或从当前调用链移除，而不是继续做兼容性迁移、fallback、legacy mode、双路径绕行或在旧门禁上叠加例外。新增门禁前必须能说明它覆盖的明确高价值风险、为什么文档/结构/标准入口不足以自然收敛、失败信号如何保持低噪声，以及未来什么条件下可以删除。 + ## 战略纠偏工作法 当发现执行结果可能偏离用户真实目标时，幕僚先做态势分析和证据溯源，再推动决议传达，不直接替代指挥官排班或接管执行。结论必须区分三件事：目标是否被误读、传达链路是否失真、运行态是否真的偏离。