add-token-category

用途：在 pharos-tokens 中新增一个真正全新的令牌类别（如动画时间线、边框宽度、透明度刻度），且该类别无法归入现有五类。资料强调这很少必要，开始前应先与维护者确认。

主要能力与流程：

1. 先确认无法归入现有类别：animation/transition 的 duration 与 easing 已在 shadow.tokens.json；border-width 可放入 radius.tokens.json 或新建 border.tokens.json；opacity 以别名形式存在于 color.tokens.json（如 oklch(... / 0.5)）；breakpoints 不属于 Pharos 令牌，应放在消费方（Tailwind 配置）。
2. 创建 DTCG 文件 src/<category>.tokens.json，结构为 { "<category>": { "tokenName": { "$value": "...", "$type": "...", "$description": "..." } } }。有效 $type：color、dimension、duration、cubicBezier、fontFamily、fontWeight、number、shadow、strokeStyle、transition、typography、border、gradient。
3. 注册：Style Dictionary 已使用 src/**/*.tokens.json 作为源，新文件自动被识别，无需修改 build/style-dictionary.config.mjs。
4. 扩展测试：若类别有特定校验（如动画时长须在 50ms 到 1000ms 之间），在 tests/<category>.test.ts 添加测试。
5. 文档：更新 README.md 的 “Token structure” 表；视情况更新 RULES.md；若工作流变化则更新 AGENTS.md。
6. 版本：新类别属于 minor 版本提升（新增令牌且不破坏现有令牌），添加对应 changeset。
7. 通知消费方：在可使用新类别的仓库（pharos-react、alexandria-*）开 issue 说明可用令牌。

限制：资料未提供具体命令、安装方式、收费或平台信息；仅适用于 pharos-tokens 项目，且需维护者确认后才应执行。