| name | agents-tree-sync |
| description | 当仓库内创建、删除、移动、重命名源码模块、脚本、配置、测试或 Agent/Skill 等核心项目目录，并且这些变更影响项目结构展示时，要求同步更新 AGENTS.md（= .ai/prompts/project.md）中的"当前项目结构"树。docs 目录下任何文件或目录结构变化都不触发本 skill。 |
| when_to_use | 当用户在非 docs 目录中创建、删除、移动、重命名文件或目录，或这些变更会影响 AGENTS.md 中的非 docs 项目结构树时激活。docs 目录下任何新增、删除、移动、重命名或修改都不激活本 skill。触发示例：'新增 link-service 子模块'、'迁移 scripts 脚本'、'删除某 link-* 模块'、'重命名 .ai/skills 下的 skill' |
AGENTS Tree Sync
目标
保持 AGENTS.md（与 CLAUDE.md 同为 .ai/prompts/project.md 的 symlink）中"当前项目结构"树与仓库源码模块、脚本、配置、测试、Agent/Skill 等非 docs 核心结构一致。
docs/ 是研发文档沉淀目录。docs/ 下任何文件或目录结构变化，都不要求、也不允许因此同步更新结构树。
触发规则
在以下情况必须同步更新结构树：
- 在
link-api/、link-service/、link-model/、link-mapper/、link-core/、link-components/、scripts/、.ai/skills/ 等非 docs/ 目录新增目录或核心文件
- 在非
docs/ 目录删除目录或核心文件
- 在非
docs/ 目录移动或重命名目录/文件
- 调整非
docs/ 目录职责，导致树上的注释不再准确
如果只是修改文件内容、没有改变结构，一般不需要更新这棵树。
以下情况不触发本 skill：
docs/ 下新增、删除、移动、重命名任何文件或目录.specs/ 下任何 feature 临时目录的变化（整目录 git-ignored）docs/ 下文档内容修改- 仅因
docs/ 结构与结构树展示不一致而想同步
更新范围
结构树只维护：
- 整体目录骨架（Maven 多模块 + 关键顶层目录）
- 核心入口
- 必要的简短注释
不要把它扩展成完整文件清单。保持"骨架 + 关键入口"的粒度。
同步步骤
- 完成文件/目录变更后，重新检查当前仓库结构。
- 对照
.ai/prompts/project.md 中"当前项目结构"树，删除失效节点。
- 补充新增节点，保持现有缩进和树形符号风格一致。
- 如果目录职责发生变化，同时修正行尾注释。
- 在最终回复中明确说明：已同步更新结构树。
约束
- 不要为了"绝对完整"把所有测试文件、临时文件、IDE 文件都列出来。
- 不要因为
docs/ 目录下任何文件或目录结构变化而同步更新结构树。
- 即使用户在
.specs/ 下新增、删除、移动或重命名任何 feature 工作目录，也不要同步更新结构树。
- 继续省略
.git、target、.idea、.vscode 等运行时或缓存目录。
- 优先保留用户当前已确认的展示风格，只做最小必要修改。
- 如果用户明确要求"不要更新"，则遵从用户要求。
