Skip to content

[PR] docs: slim AGENTS.md — KDD full text to reference/design-decisions.md, triage table to reference/triage.md - #5934

Merged
ranxianglei merged 2 commits into
2026-11-08_architecture-docsfrom
2026-11-08_agents-md-slim
Nov 8, 2026
Merged

ranxianglei merged 2 commits into
2026-11-08_architecture-docsfrom
2026-11-08_agents-md-slim

Conversation

@ranxianglei

Copy link
Copy Markdown
Owner

(ai: sglang-gpu0/qwen3.8-27b)

AGENTS.md 太大了(76 KB),按 owner 批准(2026-11-08)瘦身为 50.6 KB(−34%)。规则零丢失:这是一次搬家 + 压缩,不是删规则;KDD 编号一个没动。

改了什么

  1. KDD 分两级,编号 = 公共 API,原样保留(1–18)
  2. Issue 分类与标签规则整节搬进 reference/triage.md(p1 口径、总账讨论链接留在 AGENTS.md §4 正文)。
  3. E2E / Release 细则收敛为指向既有 reference/testing.md / reference/release.md 的硬规则行(细则本来就在那两个文件里)。
  4. 锚点未动:被 reference/* 反向引用的 6 个 heading(#4-git-safety-rules-mandatory、#5-release-workflow、#3-development-standards、#environment-variable-discipline-2030、#7-review--auto-merge-discipline 等)文本原样保留,#anchor 链接全部仍有效。

请审的点

  • Tier B 的 1–3 行摘要是我提炼的操作性后果,请逐条审是否合意(全文在 reference/design-decisions.md 可对照,编号一一对应)。
  • 其余节(Kernel Boundary / Pi-Subagents / Install-Lane / §4 / §7.4 / §7.5)只做语句压缩,规则句逐字保留。

数据

文件 前 后
AGENTS.md 76,231 B 50,644 B(−34%)
reference/design-decisions.md — 29,755 B(新,KDD 全文台账)
reference/triage.md — 2,522 B(新,标签分类表)

纯文档:无代码、无配置面、无 wire 变化。

合并顺序

本 PR 叠在 #5924(architecture-docs 分支)之上:#5920 → #5924 → 本 PR。三个都合入 master 即全部生效;若本 PR 先被挑走,rebase 到 master 即可(文件不相交,无预期冲突)。

…, triage table to reference/triage.md (owner request 2026-11-08)
@ranxianglei ranxianglei changed the title docs: slim AGENTS.md — KDD full text to reference/design-decisions.md, triage table to reference/triage.md [PR] docs: slim AGENTS.md — KDD full text to reference/design-decisions.md, triage table to reference/triage.md Nov 8, 2026
…deps; src/server/ + src/storage/ in module map, architecture-docs CI lane)
@ranxianglei
ranxianglei merged commit 372d63c into 2026-11-08_architecture-docs Nov 8, 2026
15 checks passed
@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

(ai: qwen3.8-27b)

结论:这条文档线已经全部落地并合入 master,无需再做任何改动。 以下是我刚拉取的实时核实结果(非凭记忆):

  • PR [PR] docs: land the stacked docs on master + add docs/README navigation page #5936 已合入:GitHub API 返回 state=closed, merged=true,合入时间 2026-11-08T08:40:25Z(本地 16:40,约在我被唤醒前 7 分钟),merge commit f2ce676989。
  • 交付物全部在 master 上(逐项核对 origin/master 树):
    • 第 1 项「搬运」:架构文档体系(hub docs/architecture.md[+zh] + 8 个模块页 en/zh + 全套 svg/png 图)、reference/design-decisions.md、reference/triage.md、瘦身后的 AGENTS.md、architecture-docs CI 守卫(tools/check-architecture-docs.mjs + .github/workflows/ci.yml)。
    • 第 2 项「新增」:docs/README.md + docs/README.zh-CN.md 双语导航落地页,以及 docs/index.md / index.zh-CN.md 各一行目录条目。
  • 链接零 404:两个 README 的全部相对链接逐一解析通过(en 25 / zh 25),含正文预告的 2 条 architecture 链接——已随本次合入在 master 上同在。
  • CI 绿:[PR] docs: land the stacked docs on master + add docs/README navigation page #5936 head 的 49 个 check-run = 37 success + 12 skipped,0 失败。

剩余一件可选收尾(我未代做):正文提到合入后三个 feature 分支可删(2026-11-08_docs-centralization / 2026-11-08_architecture-docs / 2026-11-08_agents-md-slim)。这属于你仓库的分支清理、且是「即可删除」的许可而非指令,我没有擅自删;需要的话说一声我下一条直接清掉。


结构化八问

  1. 是什么问题:把此前按 GitHub 语义只合进 feature 分支尖端的文档栈(架构文档体系 + AGENTS.md 瘦身)搬上 master,并按 owner 指令补一个 docs/README 双语导航落地页。
  2. 什么原因导致的:[PR] docs: live architecture hub — overall diagram + module pages with diagrams + file-map CI guard #5924/[PR] docs: slim AGENTS.md — KDD full text to reference/design-decisions.md, triage table to reference/triage.md #5934 两次合并落到了 feature 分支尖端而非 master,master 停在 [PR] docs: batch-migrate 14 root-level documents into docs/ (consolidation + master index + redirect placeholders) | docs: 14 个根级文档一次性迁入 docs/(集中 + 总目录 + 重定向占位) #5920,导致架构文档与瘦身尚未对 master 生效——是合并目标分支选择的产物,非代码缺陷。
  3. 影响范围与严重程度:纯文档,无代码/配置/wire 变化;仅影响 master 上的文档可读性与导航,属内部实现层、无运行时用户面影响。
  4. 怎么修复的:以 master 为 base、feature 分支尖端 + README 新提交为 head 开一个 PR,一次合入即把整条文档线对齐 master(第 1 项搬运零新内容 + 唯一新增为 README 导航页)。
  5. 是否有回归问题:无。逐条核对被触碰路径的既有行为——文档搬家保留根目录重定向桩、index 条目齐全、architecture-docs 守卫在位且链接全解析;无语义漂移、fail-fast 变吞错、阈值/时序/输出格式变化。
  6. 是否破坏缓存:不涉及(纯文档,不触碰缓存/重试/游标/去重键)。
  7. 是否改了设计方向:不涉及架构转向;仅确立「docs/ 为唯一文档 hub + reference/ 放施工流程」的布局规约(已由 [PR] docs: batch-migrate 14 root-level documents into docs/ (consolidation + master index + redirect placeholders) | docs: 14 个根级文档一次性迁入 docs/(集中 + 总目录 + 重定向占位) #5920/[PR] docs: live architecture hub — overall diagram + module pages with diagrams + file-map CI guard #5924 定稿,本 PR 将其落地)。
  8. 是否引入了新的配置:不涉及(无 env/config/CLI/默认值变更)。

判定:收工。 交付物已合入且验证齐全,master 与 feature 分支已对齐;仅剩上面那条可选的分支清理待你点头。

@ranxianglei

Copy link
Copy Markdown
Owner Author

🤖 Powered by ework · qwen3.8-27b

[bot] 🏷 (ai: qwen3.8-27b)

更正:我上一条核实报告发错线程了——它属于「把文档栈搬上 master + 新增 docs/README 导航页」那条线(GitHub PR #5936),误贴到了本线程(AGENTS.md 瘦身,对应 GitHub #5934)。报告里的结论(文档线已合入 master、CI 绿、链接零 404)本身属实,但归属以 GitHub PR #5936 为准。已补发到正确线程,抱歉造成混淆。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant