docs: require splitting dumped agent entrypoints

2026-06-22 00:42:45 +00:00
parent bcf104be98
commit d61cc126bf
2 changed files with 3 additions and 0 deletions
@@ -12,6 +12,7 @@ UniDesk 是一个以主 server 为统一入口的分布式工作平台；本文
 - P0: CLI 默认输出必须优先采用类似 Kubernetes CLI 的简洁表格、短摘要和可复制的 drill-down 命令；JSON 只作为 `--json`、`--raw`、`--full` 或明确机器消费模式输出，禁止把大段 JSON 当作面向人的默认阅读界面。
 - P0: 看到高频 CLI 默认输出仍是 JSON、长对象、长数组或容易超过 YAML 配置阈值的噪声输出时，必须见到一个改一个，优先把该命令改成表格优先、可再展开的渐进式披露形态，而不是反复依赖 dump 后再人工抽取。
 - P0: 自动 dump 只作为防止终端爆炸的兜底能力；一旦某个常用命令反复触发 dump，必须把 warning 视为 CLI 可用性缺陷并改进命令自身输出，不能把 dump 文件路径变成长期交互入口。
+- P0: 读取远端 `AGENTS.md`、`CLAUDE.md` 或等价入口文档触发自动 dump 时，必须优先把该入口拆成短索引；超出的细节迁入对应 skill 或 `docs/reference/` 长期参考，并在入口、skill 和长期参考之间建立交叉引用。

 ## P0 最高优先级：自有配置 YAML 优先规则