用途:根据仓库资料,adr-sync 用于将 ADR(架构决策记录)的散文式声明转化为可执行验证声明,并确认 ADR 确实接入了真实检查。ADR markdown 仍为唯一事实来源,技能仅添加或更新轻量 frontmatter 中的验证声明,直接指向仓库中真实可执行项。
主要能力:为 ADR 补写/更新 frontmatter 中的 validate 声明(如 cargo_tests、audits、smoke);优先使用常规测试(cargo test -- --list 中的精确测试名),其次内置 ADR 审计,再是 .github/fixtures/ 下的 smoke 夹具,脚本仅作最后手段;运行仓库原生 ADR 编译/检查命令;对缺少真实检查的声明明确报告缺口。
使用方式:参数可为单个 ADR 路径或目录,省略时默认 docs/ADRs/。示例:/rna-mcp:adr-sync docs/ADRs/001-event-bus-extraction-pipeline.md 和 /rna-mcp:adr-sync docs/ADRs。可运行命令:repo-native-alignment adr compile --repo .、repo-native-alignment adr compile --repo . --check、repo-native-alignment adr validate --repo .。若命令尚不可用,应作为阻塞项报告,不得模拟成功。
限制与禁止:不得虚构不存在的测试名、脚本或验证;不得在 ADR 源中引入不透明的证据 ID 或注册表层;不得在常规测试可诚实表达时默认使用 .github/scripts;缺少必要检查时不得标记 ADR 为完全合规;不得把执行细节从 frontmatter 移入散文。具体可用检查名称、命令可用性及仓库结构需以实际项目为准,资料未提供更多细节。