# 倉頡 Skill v2.5.0 发布说明

> 发布日期：2026-08-30

v2.5.0 把「从长内容中拆出很多平铺 Skill」升级为「先维护一份 Capability Bundle，
再按场景编译交付形态」。这个版本的重点不是增加更多文档，而是让蒸馏结果更少、
更容易安装，也更容易更新、修复和评测。

## 核心升级

- **Capability Bundle 单一事实源**：能力卡、元数据、关联和去向集中在
  `books/<slug>/.cangjie/capabilities/`，避免 single 与 pack 各自演进后产生偏差。
- **single / compact pack 双输出**：`single` 用一个路由入口承载整本内容；
  `pack` 保留一个路由入口，只把通过晋级门的少数能力拆成独立 Skill。
- **统一 CLI**：`scripts/cangjie.py` 提供 `doctor` / `compile` / `replan-output` /
  `update` / `repair` / `rollback` / `eval` / `benchmark` 等入口。
- **确定性与可回滚**：引入内容寻址缓存、编译不变量、写锁、staging 校验、
  手工修改检测、发布前快照和 rollback。
- **增量更新与修复**：支持源文档 diff、影响分析、事务性补丁、失败案例诊断和防过拟合修复。
- **评测与基准链路**：包含触发评测、匿名输出对比、静态 A 类指标和 Naval 试点资产。
- **Registry v2 + 官网**：新 schema 能表达输出模式、入口数和能力数；官网同步展示，
  原有 Registry v1 条目无需改造。
- **官网依赖安全升级**：Astro 7.2.9、js-yaml 5.4.1，发布时 `npm audit` 为 0 vulnerabilities。

## 兼容性

- 不破坏现有 Registry v1 条目和 legacy pack。
- 新产物建议使用 Registry v2；字段迁移见
  [`docs/migrations/2026-08-25-v2.0-to-v2.1.md`](https://github.com/kangarooking/cangjie-skill/blob/v2.5.0/docs/migrations/2026-08-25-v2.0-to-v2.1.md)。
- 官网子项目许可证已与根仓库统一为 MIT。

## 文档与社群一致性

- 英文 `README.md` 与中文 `README.zh-CN.md` 均引用同一个
  `assets/wecom-cangjie-group-qr.png`。
- 二维码文件以中文 README 当前展示的版本为准，本次发布不使用本地分支中的另一张图覆盖它。

## 验证边界

本版本发布前执行 schema、Bundle、编译确定性、Registry、网站测试与构建校验。
真实 Agent 宿主上的盲测结果具有 host-specific 属性，不把静态评测误表述为所有宿主的通用效果。