7595c37d22
All checks were successful
Push & PR Check / check (push) Successful in 1m3s
全托管文件（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>
11 lines
1.0 KiB
Markdown
11 lines
1.0 KiB
Markdown
---
|
||
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`。
|