用途:让设计文档与代码库保持一致。它从文档中提取文件引用与实现声明,对照实际源代码进行验证,识别差异,自动应用安全更新,并将不安全变更标记为需人工审核。
主要能力:解析模块与文档范围;读取 design.config.json 获取模块与包路径;提取文件引用、导出、实现声明、架构描述、指标与依赖;验证文件存在性、导出、函数签名、行数、依赖、架构结构与性能指标;生成包含摘要、严重问题、警告、安全更新和待人工审核项的同步报告;更新 frontmatter 中的 last-synced 时间戳与同步状态。
使用方式:基本检查(仅检查)使用 /design-sync effect-type-registry;自动更新使用 /design-sync effect-type-registry --auto-update;同步指定文档使用 /design-sync effect-type-registry observability.md。参数:module 为必填,可填模块名或 all;doc 可选,默认模块内全部文档;auto-update 默认 false;check-only 在未设置 auto-update 时默认 true。
适用场景:验证文档准确性、代码变更后、last-synced 过期时。可与 /design-validate、/design-update、/design-review、/design-report 配合使用。
限制:需先配置 design.config.json;文档不存在或模块未配置时会报错;不安全更新不会自动应用,需人工审核;具体实现细节需加载 instructions.md、analysis-strategies.md、update-operations.md、examples.md 等支持文档。