메뉴
当仓库内创建、删除、移动、重命名源码模块、脚本、配置、测试或 Agent/Skill 等核心项目目录，并且这些变更影响项目结构展示时，要求同步更新 AGENTS.md（= .ai/prompts/project.md）中的"当前项目结构"树。docs 目录下任何文件或目录结构变化都不触发本 skill。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
当用户要求基于某个需求、功能、改造、技术方案或项目实践生成博客文章时使用；必须结合用户给出的完整需求、当前项目真实实现逻辑、业务场景和代码/文档上下文做深入分析，输出通俗易懂且专业的 Markdown 博客到 `.specs/blog/《博客名称》.md`。
当修改 AGENTS.md/CLAUDE.md、docs/api、docs/internals、docs/ops，或代码变更影响这些文档记录的 API、MySQL schema、MQ 契约、Redis 缓存、OSS、错误码、模块架构、配置时，检查并同步更新对应文档，保证项目文档自动维护。
MySQL 建表与字段规范（面向 Java 管理端业务：用户、LLM 配置、数据集、知识文件、解析任务）。统一命名、索引、字段类型、时间戳、引擎字符集与注释要求，便于研发与 DBA 评审落地。
SpringDoc OpenAPI 3 中文注解生成工作流。为 Spring Boot Controller 和 DTO 生成符合企业级规范的中文 Swagger 注解（@Tag、@Operation、@Parameter、@Schema）。
brief.md 和 acceptance.feature 已冻结后，生成 .specs/<需求名>/technical_design.md；必须基于真实 Java 代码、组件文档和契约。
为 toLink-Service 的 HTTP 接口构建并执行全面的 curl 黑盒测试。分析待测接口与边界条件，必要时直连数据库或经接口造数，对本地已启动服务发起 curl 请求，断言响应，最终在对话中返回测试结果汇总。
| 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.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/ 结构与结构树展示不一致而想同步结构树只维护：
不要把它扩展成完整文件清单。保持"骨架 + 关键入口"的粒度。
.ai/prompts/project.md 中"当前项目结构"树，删除失效节点。docs/ 目录下任何文件或目录结构变化而同步更新结构树。.specs/ 下新增、删除、移动或重命名任何 feature 工作目录，也不要同步更新结构树。.git、target、.idea、.vscode 等运行时或缓存目录。