docs: require compact sentinel trigger output

This commit is contained in:
Codex
2026-07-08 08:33:06 +02:00
parent bc7406ecbd
commit 9ad3bbb4b4
+2
View File
@@ -87,6 +87,8 @@ OA Event Flow 的高频 trace 统计不得把每个 `trace-stats-updated` 投影
branch-follower 的 gate 与 TaskRun drill-down 默认输出必须能直接作为 target-side 性能证据使用,不能稳定触发 stdout dump。CI gate 应返回有界的 PipelineRun 总耗时、慢 TaskRun 对象名、阶段 timeline 和性能摘要;成功 TaskRun drill-down 默认只返回容器状态、日志字节数和 `node-cicd-timing` 摘要,不把成功日志正文塞进 JSON。失败、等待或显式 full/raw drill-down 才展开日志 tail。
`web-probe sentinel control-plane trigger-current --confirm --wait` 的成功路径必须默认输出 compact closeout summary,至少包含 node/lane、source commit、PipelineRun 名称与状态、GitOps revision、Argo sync/health、runtime ready、public route readiness 和 PaC/status/history drill-down;成功时不得稳定触发全局 stdout guard。阻塞或失败路径仍应展开 status diagnosis、recovery next 和必要 drill-down,不得为了压缩输出隐藏失败原因。
全局 stdout guard 不能只返回 dump 元数据。对已知高频长输出命令,bounded wrapper 的 `summary` 必须保留可直接 closeout 的命令特定字段,同时把完整 payload 留在 dump/raw drill-down 中。例如 `debug dispatch ... provider.upgrade` 超阈值时应保留 dispatch task、wait task、plan host root、当前/目标 gateway 版本、scheduler 结果和最终 promoted container 的 `version``restartPolicy``pidMode``heartbeatTimestamp``provider triage --full` 超阈值时应保留 `decision``scope``retryable`、failed/degraded/healthy scopes、signal counts、recommended cross-checks 和问题信号预览。新增会稳定超阈值的诊断命令时,优先补命令特定 compact summary,而不是扩大全局 stdout 阈值。
本地或远端 `AGENTS.md``CLAUDE.md``SKILL.md` 或同类 agent 入口文档超过 `10 KiB`、超过 YAML dump 阈值,或被 CLI/SSH/trans 读取时触发自动 dump,不能只把 dump 文件路径当成继续工作的正常入口。该现象表示入口文档已经过长,必须按 `docs-spec` 把入口文件拆成短索引:只保留 P0 规则摘要、关键命令入口和指向权威文档的链接;具体流程、背景、判定标准和长篇约束迁入对应职责文件。`SKILL.md` 拆到 `references/` 后禁止再堆成 `references/full.md``all.md``guide.md` 或其他变相超级 Markdown;必须按职责、生命周期和读取场景拆分成多个可选择的 reference,并在 `SKILL.md` 写清“何时读取哪个文件”。拆分后入口文档、skill 和长期参考必须互相交叉引用,避免同一规则在多个位置重复展开或产生第二真相。