菜单
当仓库内创建、删除、移动、重命名源码、脚本、配置、测试或 Agent/Skill 等核心项目目录，并且这些变更影响项目结构展示时，要求同步更新根目录 AGENTS.md 中的“当前项目结构”树。docs 目录下任何文件或目录结构变化都不触发本 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
契约治理三件套的「值层」。核对同一个物理契约值（MQ topic/group、OSS bucket、消息字段名/别名、内部 HTTP 路径等）在 .env/.env.example/代码生效点/Java 对端多处是否逐字相等，找出配置漂移与死值，防止消息收不到/文件取不到。本 skill 只比对「同一个值在多处是否一致」，不判断结构/语义是否破坏对端（那是结构层，转 contract-guard），也不改文档。
指导 LLM 如何使用 toLink-Rag 项目的 MQ 消息中台进行消息收发、定义新消息类型以及处理多厂商适配逻辑。
当用户认为当前模块代码实现完毕，且当前分支应为 dev，需要从 dev 基于当前修改创建规范分支、提交并发起合并到 dev 的 GitHub PR 时使用；也用于发布收口，即直接创建 dev -> master 的 release PR，不新建 release 分支。适用于“从 dev 新建分支”“把当前修改提 PR”“实现完成创建 feature/refactor 分支并 PR”“发布新版本”“dev 合并 master”等交付收口场景。本 skill 是交付链终点，并在建分支/提 PR 前执行收口门槛：测试未过、契约文档失同步、acceptance 未提升者拒绝收口。
当用户要求把需求、功能、技术方案、架构改造、故障复盘、项目治理实践或实现过程写成博客/技术文章时必须使用；尤其适用于“写一篇博客”“生成技术博客”“把这个需求写成文章”“根据这个功能写博客”“把项目实现讲清楚”等请求。使用时要基于用户给出的需求和 toLink-Rag 当前仓库的真实代码、文档、契约、配置与测试证据完成分析，默认输出 Markdown 到 `.specs/blog/《博客名称》.md`。文章须采用「少量
把项目里已有的内部组件（如 MQ 中台、解析 pipeline、缓存层、对象存储）抽象成一份「项目自有 skill」，让 AI 每次接入都自动复用该组件的架构边界与约定。读组件真实代码，提炼「架构定位 / 职责边界 / 已落地清单 / 扩展点 / 红线」五要素，按统一原型生成 SKILL.md，登记到 .ai/skills/README.md 注册表并跑校验。
当用户要提 issue、登记 bug、记录新需求时使用；自动识别所属项目，生成结构化 issue 内容，先在 Linear 建主记录、再在 GitHub 建镜像，并双向回链。用户说"提个 issue""记一下这个 bug""把这个需求登记一下""同步到 Linear 和 GitHub""别再依赖 Linear 自动同步"时都应触发，即使没有明确说出"Linear"或"GitHub"。
| name | agents-tree-sync |
| description | 当仓库内创建、删除、移动、重命名源码、脚本、配置、测试或 Agent/Skill 等核心项目目录，并且这些变更影响项目结构展示时，要求同步更新根目录 AGENTS.md 中的“当前项目结构”树。docs 目录下任何文件或目录结构变化都不触发本 skill。 |
| when_to_use | 当用户在非 docs 目录中创建、删除、移动、重命名文件或目录，或这些变更会影响 AGENTS.md 中的非 docs 项目结构树时激活。docs 目录下任何新增、删除、移动、重命名或修改都不激活本 skill。触发示例：'新增 src/core 模块'、'迁移 scripts 脚本'、'删除 tests 子目录'、'重命名 .ai/skills 下的 skill' |
保持根目录 AGENTS.md 中的“当前项目结构”树与仓库源码、脚本、配置、测试、Agent/Skill 等非 docs 核心结构一致。
docs/ 是研发文档沉淀目录。docs/ 下任何文件或目录结构变化，都不要求、也不允许因此同步更新 AGENTS.md。
在以下情况必须同步更新 AGENTS.md：
src/、scripts/、tests/、.ai/skills/ 等非 docs/ 目录新增目录或核心文件docs/ 目录删除目录或核心文件docs/ 目录移动或重命名目录/文件docs/ 目录职责，导致树上的注释不再准确如果只是修改文件内容、没有改变结构，一般不需要更新这棵树。
以下情况不触发本 skill：
docs/ 下新增、删除、移动、重命名任何文件docs/ 下新增、删除、移动、重命名任何目录.specs/ 下任何 feature 临时目录的变化（整目录 git-ignored）docs/ 下文档内容修改docs/ 结构与 AGENTS.md 中展示不一致而想同步目录树AGENTS.md 中的树只维护：
不要把它扩展成完整文件清单。保持“骨架 + 关键入口”的粒度。
AGENTS.md 中的树，删除失效节点。AGENTS.md 目录树。docs/ 目录下任何文件或目录结构变化而同步更新 AGENTS.md。.specs/ 下新增、删除、移动或重命名任何 feature 工作目录，也不要同步更新 AGENTS.md。.git、.venv、.pytest_cache、__pycache__ 等运行时或缓存目录。