Skip to content

getting-started/for-developers 的 src/ 目录树仍画着 #512 删掉的 agents/,后缀表也仍列 *.agent.ts;docs-drift 的目录守卫看不到 content/docs #984

Description

@yinlianghui

来源:#977 实施(PR 见下)过程中的卫星命中。那一单只点了本页第 41 行的 cubes/,已随 PR 改为 datasets/;同一段目录树里紧邻的另一条同型残留没有动,按 Prime Directive #10 另立。

逐处

content/docs/getting-started/for-developers.mdx(三语同址,行号一致):

现文 事实
38 目录树里的 ├── agents/ # AI agents src/agents/ 不存在#512 移除了两个 app 自带的 copilot 与整个目录(能力面按 ADR-0063 §2 收敛为 skills-only),find src -name '*.agent.ts' 零命中。docs-drift.test.ts 的目录守卫注释里把这条写成已修完的历史,而它在本页仍然活着
52 附近 后缀表的一行 `` *.agent.ts AI agent ``

顺带一提(同一段树,未逐行核):该树画了 objects/ actions/ flows/ agents/ skills/ apps/,views/,pages/ dashboards/,reports/,datasets/ profiles/,sharing/ translations/ data/,而 src/ 下真实还有 hooks/interfaces/mappings/docs/ 四个目录未出现。缺项和幻影不是同一类问题,是否要补由 triage 定。

为什么没被守卫拦住

test/docs-drift.test.ts 里的「maintainer docs do not point at directories that no longer exist」正是为这一类写的,它的注释甚至同时点名了 src/agents/src/cubes/。但它的扫描面 TREE_DOCS 只有 9 个维护者文档(README.mdAGENTS.mddocs/*),不含 content/docs/ 下的产品文档;而且它的正则是 \bsrc/([a-z][a-z0-9_]*)/,本页的树逐行写成 ├── agents/ 而没有 src/ 前缀,即使把文件加进去也匹配不到。所以这是守卫的两层盲区叠在一起,不是它判错。

修复面因此有两半:改文本,以及让守卫能看见这一页(要么把产品文档里的目录树纳入扫描面并解析 ASCII 树的条目,要么在本页把树写成守卫认得的形式)。

边界

Refs #977 #512

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationpm:dispatchedDispatched to a dev agent by /pm-dispatch

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions