Repository navigation
customization/index 的 src/ 目录树与后缀表同样画着 #512 删掉的 agents/ 与 *.agent.ts（#984 的同型孪生页） #988
Description
Activity
🔒 认领(/pm-dispatch R35)— session
session_01VHrPAGEgFDoHjphqYG4BMa,分支claude/issue-988-customization-tree。文件面:
content/docs/customization/index{,.zh-Hans,.zh-Hant}.mdx的目录树(:28)、后缀表(:50)与 :15 表格(「Copilot skills and agent wiring」)——fresh main 重定位。裁定:①沿 PR #991 全套口径:整树逐目录对账(删 agents/、补该页缺的 datasets/hooks/mappings/docs/interfaces、注释按实况)、后缀表清 *.agent.ts;②修好后把本页三语加进 #991 建立的 PRODUCT_TREE_DOCS 与 TREE_DIAGRAM_DOCS 两个守卫列表(#991 注释已预指本单),两阶段红→绿验证;③:15 表格措辞按 skills barrel 实况;④ai-skills.mdx:10 的合法否定式不误伤;#595 不预判;三语同步;zh 内链不带锚。
Generated by Claude Code
✅ 验收通过 —— PR #995 已转 ready 并挂 auto-merge(8/9 绿,Build and Test 平台恢复后重跑排队中,由 auto-merge 把关合并)。
验收要点:
- 整树 18 项三语对账沿 docs(getting-started): 把 for-developers 的 src/ 目录树按实况重画，并让 docs-drift 守卫看得懂目录树 (#984) #991 全套口径(删 1 补 5、注释按实况),:15 表格按 skills barrel 写实。
- 守卫扩面的结构性理解:一处登记覆盖双列表(TREE_DIAGRAM_DOCS 由 PRODUCT_TREE_DOCS 展开而来,重复登记=重名用例)+ 两个防踩坑注释(入列有 inline 门槛、否定式字面量也会被判失实)——为后来者立了规矩。
- 红阶段 6 条分属两种断言且如实照录与模板预设的差异(3 条触发的是 vacuity 而非 missing-dir,因旧文档压根无 inline 路径)——不把实际红说成预设红。
- blocked 判定与平台故障证据链是教科书级:三 job 死在 checkout 之前(Getting action download info: Service Unavailable)、推送树/路径解析两条 PM 假设逐一排除、零改动重试下 Analyze Code 由红转绿为直接证据、4 次重试后停手避免占 runner 并留证据链于 PR 评论——「红与我无关」的论证与克制俱佳,记档。
- PM 侧收尾:平台恢复后重跑,link-check 已转绿,Build and Test 排队中;PR 正文的消毒器绕行说明(尖括号空格)亦是可复用惯例。
零越界发现。本单落地后 R35 收官。
Generated by Claude Code
来源：#984 实施过程中的卫星命中。#984 的边界只覆盖
getting-started/for-developers三语页，本页与它行集互斥，按 Prime Directive #10 另立。逐处
content/docs/customization/index.mdx（.zh-Hans/.zh-Hant三语同址，行号一致）：├── agents/ # AI agentssrc/agents/不存在。#512 移除了两个 app 自带 copilot 与整个目录（能力面按 ADR-0063 §2 收敛为 skills-only），find src -name '*.agent.ts'零命中*.agent.ts同一段树另有缺项（未逐条判定，留给 triage）：
datasets/（#977 / PR #987 清 cube 词汇时没覆盖到本页的树）、hooks/、mappings/、docs/、interfaces/都不在树上。:15 的目录表格把 AI skills 一节描述为 “Copilot skills and agent wiring”，其中 agent wiring 已不存在。为什么没被守卫拦住
test/docs-drift.test.ts原本的目录守卫有两层盲区（TREE_DOCS 只含维护者文档；正则要求src/前缀，而树里逐行写作├── agents/）。#984 的 PR 两条都补了——新增产品文档的 inlinesrc/x/扫描与 ASCII 目录树解析——但扫描面按 #984 的边界只列了 for-developers 三语页。本页文本修好后，把三语加进守卫的PRODUCT_TREE_DOCS/TREE_DIAGRAM_DOCS即被覆盖（守卫里已留注释指向本单）。注意：不要顺手把 content/docs 全量纳入守卫
content/docs/customization/ai-skills.mdx:10也出现src/agents/，但那是正确的否定式表述（“there is nosrc/agents/directory”）。inline 形式的 “列出即须存在” 规则在任意产品文档散文上并不成立，这正是守卫按页白名单而非遍历 content/docs 的原因。Refs #984 #512 #977