dev-manager-tauri/.claude/rules/onboarding-sync.md
lanrtop 7595c37d22
All checks were successful
Push & PR Check / check (push) Successful in 1m3s
test(onboarding): 托管模板指纹测试,改内容未升版本即失败
全托管文件(envoy.md / SKILL.md)按内容覆盖,但 verify_onboarding 只凭
capability-packs.json 版本判落后——只改内容忘升 BASE_ONBOARDING_PACK_VERSION
时 verify 永远 ready,子项目收不到更新。升版规则此前只有文档约束。

- 新增 managed_template_fingerprints_track_versions:「版本号 → 摘要」登记表
  TEMPLATE_FINGERPRINTS 钉住 resources/onboarding/**(↔ BASE 版本)与
  AGENTS / git-workflow 管理块(↔ 块首 version);摘要前 CRLF→LF 归一化
- capability-packs.json 与 BASE 相等复用既有断言,补可读报错
- onboarding-sync.md 说明该测试

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 01:49:36 +09:00

1.0 KiB
Raw Permalink Blame History

globs
src-tauri/resources/onboarding/**

修改接入包模板时,检查 docs/templates/agents-meta-rules.md 是否需要同步更新——两者描述同一套元规则,必须保持一致(单一事实来源:tmpl 是分发实体,docs/templates/ 是设计草案)。

改模板内容必须同步升级 ONBOARDING_MANAGED_START version="x.y.z" 版本号——版本是分发引擎唯一的升级信号,内容变了版本不动,批量分发会全部 skipped(2026-07-06 实测踩坑)。模板改完后跑 cargo test onboarding 确认版本相关测试通过。

该规则已由指纹测试 managed_template_fingerprints_track_versions(onboarding.rs)机器校验:resources/onboarding/** 任何内容变化须升 BASE_ONBOARDING_PACK_VERSION 与模板 capability-packs.json 版本,管理块内容变化另须升块首 version,再按测试报错把新摘要填回 TEMPLATE_FINGERPRINTS。

分发到子项目需要重建安装炼境(模板打包在二进制资源里),再调 apply_onboarding_pack。