docs(rectification): record skill bump identity pitfalls

The registry packagePath points at versions/<version>/, but the root
SKILL.md copy makes it easy to hash the package root instead. Hashing
the root pulls the entire versions/ subtree into the digest and still
returns a value, so the mistake surfaces only as a failing gate later.
Records BUG-459 and corrects the task brief's D-2 table, which listed
the root SKILL.md as the hash target.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LVapmh2oGNyr6ECHKjPJY8

docs/BUG_HISTORY.md

@@ -7038,3 +7038,19 @@
 - 相关记录：BUG-455、BUG-457
 - 复发自：无
 - 修复版本：`test(billing): make renewal timing deterministic`
+
+## BUG-459 | Skill 升版身份同步不完整：SHA 目标目录易错且身份分散在五处
+
+- 状态：resolved
+- 首次发现：2026-08-31
+- 最近更新：2026-08-31
+- 影响面：`skills/skill-package-registry.json`、`skills/jyotish-birth-time-rectification/**`、`RECTIFICATION_SKILL_VERSION`、`frontend/tests/skill-registry.test.ts`、`openRectificationCase`
+- 用户现象：升版后新建 Case 直接失败（`skill_registry_version_mismatch`），或 `skill-registry.test.ts` 在发布门禁处失败。
+- 触发条件：升级 rectification Skill 版本时只改了部分身份位点；或对 Skill 根目录而非 `versions/<version>/` 计算 SHA256。
+- 根因：Skill 身份分散在五处——版本目录 `SKILL.md` frontmatter、根目录 `SKILL.md` 副本、registry 条目的 `version`/`sha256`/`packagePath`、`RECTIFICATION_SKILL_VERSION` 常量、测试内硬编码 SHA。registry 的 `packagePath` 指向 `versions/<version>/`，但根目录存在同名 `SKILL.md` 副本，容易让人误以为 SHA 应对根目录计算；根目录含 `versions/` 整棵子树，对它计算会把全部历史版本吃进哈希，**且能正常返回一个值、不会立刻报错**。`openRectificationCase`（`v9/case-service.ts`）校验 registry active 版本必须等于 `RECTIFICATION_SKILL_VERSION`，任一处不同步即导致新建 Case 整体失败。
+- 修复：升版按固定顺序执行——先建 `versions/<new>/` 并改完全部字节（含 frontmatter 与根目录副本），**最后**统一对 `versions/<new>/` 调用 `computeSkillPackageSha256()`，再回填 registry 与测试。10.0.13 → 10.0.14 按此流程完成。
+- 验证：对 `versions/10.0.14/` 实算 SHA 与 registry、`skill-registry.test.ts` 三处一致；registry active 条目唯一；根目录与版本目录 `SKILL.md` 字节一致；`rectification-*` 与 `skill-registry` 套件 730 项 0 失败；`tsc --noEmit` 通过。未进行真实 staging smoke。
+- 防复发：SHA256 只能对 registry `packagePath` 指向的目录计算，绝不对 Skill 根目录计算；改字节与算 SHA 不得交错，必须先定稿再统一重算；升版必须在同一变更内同步全部五处身份位点；`skill-registry.test.ts` 是发布门禁，不得跳过。存量 Case 绑定各自的 `skill_version`，`resolveExact` 对 `deprecated` 放行，因此升版不需要数据迁移，但旧 Case 不会获得新版 prompt 约束。
+- 相关记录：BUG-456
+- 复发自：无（提交 `797a423a` 曾出现同类的"改了 Skill 字节但未刷新 registry hash"，当时未单独立项）
+- 修复版本：Skill `10.0.14`