用途：只读分析 SEED 颜色令牌，基于当前检出的 packages/rootage/color.yaml 查看定义、连接关系、生成结果与对比度，脚本不改变文件与 Git 状态。
令牌地图：指定一个颜色令牌运行 bun skills/seed-token-analysis/scripts/token-map.ts '$color.fg.neutral'。结果 JSON 依次读取：token 中的 canonical 与 state（matched、ambiguous、not-found）；definition 中的 Rootage 源路径、说明与各 mode 原始值；resolvedValues 中各 mode 原始值、alias 连接与最终颜色；dependentTokens 中直接引用该令牌的令牌（不含传递依赖或组合影响）；componentUsages 中组件变体、状态、插槽、属性与依据路径；generatedSurfaces 中按平台与包比较 status、实际 paths 与 expectedPaths（missing 表示未找到生成结果，并非要直接改 Rootage 源）；最后检查 warnings 与 readOnly 是否为 true。token.publicNames 可查看 CSS 变量与公开名称。生成文件仅作发布表面依据，不直接修改。
对比度检查：指定一个前景令牌与一个或多个背景令牌，--background 与 --theme 可重复，半透明背景需加 --backdrop；省略 --theme 时同时检查 light 与 dark，去重后按 light、dark 顺序返回。示例：bun skills/seed-token-analysis/scripts/token-contrast.ts --foreground '$color.fg.warning-contrast' --background '$color.bg.warning-solid' --theme light --theme dark。checks 按背景与主题组合返回 resolved、unresolved、needs-backdrop；#RRGGBBAA 末两位为 alpha，半透明前景先与背景合成再算对比度，半透明背景先与 backdrop 合成，backdrop 也半透明则无法完成计算。顶层 status 为 partial 时不能视为已检查全部组合；minimumRatio 仅为 resolved 组合中最低值，不含 unresolved 与 needs-backdrop；wcag 各布尔值分别对应普通/大文本 AA、AAA 与非文本 3:1。
限制：仅处理颜色令牌，不分析 dimension、typography、shadow 等；令牌地图一次只查一个令牌；对比度检查不计算多个变更的组合影响。需要变更时修改 Rootage 源并遵循仓库生成流程；多令牌或实际 diff 影响用 seed-change-plan，发布 bump 与 changeset 用 seed-changeset 确定。