docs: prioritize visibility fixes

2026-05-31 05:32:54 +00:00
parent f01f840628
commit 3d6be3dc57
1 changed files with 5 additions and 0 deletions
@@ -2,6 +2,11 @@

 UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文件是项目顶级索引，也承担 `scripts/cli.ts` 的 CLI 使用说明入口。

+## P0 最高优先级：可见性先修
+
+- P0: 可见性问题是所有任务的优先级最高基础设施问题；无论当前正在开发、发布、排障、写文档、跑 CI/CD 还是做远端透传，只要遇到会遮蔽状态、耗时、失败原因、任务进度、日志尾部、trace、命令结果或关键证据的可见性缺口，必须先修复可见性再继续原任务，避免后续反复踩坑和浪费时间。
+- P0: 可见性修复优先采用低摩擦、短反馈、可复用的 CLI/日志/状态输出改进；不得把不可见问题包装成临时人工记忆、长日志全量 dump、重复大回环 CI/CD 试错或额外旧门禁。
+
 ## P0 最高优先级：最新要求与旧门禁清除

 - P0: 用户最新明确要求优先于旧测试、旧门禁、旧预检、旧断言、旧 guard 和旧 gate；开发过程中遇到任何阻碍最新目标的旧测试、旧门禁、旧预检或旧断言，一律拆除，禁止继续维护、修补、叠例外或用兼容路径绕行。