Menu
仓库架构文档同步。当文件结构发生变化（新增/删除/移动文件或目录）时，必须使用此技能更新仓库元数据和架构文档。
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
代码构建全链路质量门禁。当你完成代码修改后，必须使用此技能运行构建检查确保代码质量。适用于任何前端代码变更后的验证。
依赖关系优先的 AI Review 总调度 Skill。通过“机械门禁 + LLM 判读 + 人工兜底”输出可执行评审结论。
开发日志记录规范。每次完成代码修改后，必须使用此技能记录开发日志到 docs/dev_logs/ 目录。当你完成任何代码变更、Bug 修复、功能开发或重构时，使用此技能。
本地开发全链路 SOP。接到任何开发任务时，按此流程从需求理解到 Git 管理完整执行，串联所有子 Skills 形成闭环。
通用模块化治理 Skill。用于通过机械量化脚本检查模块边界、依赖方向、循环依赖与变更风险，并以 PASS/REFINE/BLOCK 输出可修复反馈。适用于 LLM 分治式开发中的框架校验、自动 review 闭环、以及模块重构验收。
Git 管理规范。出现阶段性成果或准备进行大改动时，使用此技能建立可回滚、可追溯的版本控制节奏。
| name | repo-structure-sync |
| description | 仓库架构文档同步。当文件结构发生变化（新增/删除/移动文件或目录）时，必须使用此技能更新仓库元数据和架构文档。 |
docs/architecture/repo-metadata.json 是仓库结构元数据的 source of truth，repository-structure.md 是其自动生成的人类可读版本。
本技能通过 MCP Server repo-metadata 提供的工具直接操作，无需拼终端命令。
以下操作后必须同步元数据：
调用 MCP 工具 repo_metadata_scan：
repo_metadata_scan({ update: true })
自动发现新增/删除的路径并更新 repo-metadata.json。
对于扫描发现的新增条目（description 为空），调用 repo_metadata_batch_set：
repo_metadata_batch_set({
items: [
{ path: "新增路径1", description: "一句话描述" },
{ path: "新增路径2", description: "一句话描述" }
]
})
或单条设置：
repo_metadata_set({ path: "xxx", description: "描述" })
调用 repo_metadata_generate_md：
repo_metadata_generate_md({})
更新 repository-structure.md 中的目录树（只展开 2 层）。
repo_metadata_sync_db({ direction: "json-to-pg" })
repository-structure.md 中除了 <!-- REPO-TREE-START --> 到 <!-- REPO-TREE-END --> 之间的自动生成内容外，其他章节（技术栈、开发命令等）仍需手动维护。
| 工具 | 用途 |
|---|---|
repo_metadata_scan | 扫描目录变化（update: true 自动更新 JSON） |
repo_metadata_get | 获取单条元数据 |
repo_metadata_set | 设置/更新描述 |
repo_metadata_batch_set | 批量补写描述 |
repo_metadata_list | 列出/查询条目（支持过滤） |
repo_metadata_delete | 删除条目（级联删除子路径） |
repo_metadata_generate_md | 生成 repository-structure.md |
repo_metadata_sync_db | JSON ⇄ PG 同步 |
如果 MCP 工具不可用，仍可通过终端运行：
node scripts/repo-metadata/scripts/scan.mjs --update
node scripts/repo-metadata/scripts/crud.mjs batch-set < descriptions.json
node scripts/repo-metadata/scripts/generate-structure-md.mjs
<!-- REPO-TREE-START --> 到 <!-- REPO-TREE-END --> 之间的内容config.scanIgnore 控制哪些路径不被扫描