SuperAPI AI 工具集

review-tokens-pr

通用与其它

查看项目

更新于 10-15 20:13

技能介绍

用途:在审查 pharos-tokens 的 PR 时使用,提供按优先级排序的详尽检查清单,前五项不通过则不予合并。

主要能力与检查项:

  1. DTCG 格式:每个 token 需有 $value、$type、$description;$type 与值匹配(如 OKLCH 字符串用 color,rem/px 用 dimension,ms 用 duration);.tokens.json 为合法 JSON 且可解析。
  2. 命名:token 路径遵循既有层级(color.{neutral,primary,semantic.,base}、spacing.、radius.、font.、shadow.、z.、duration.、easing.);颜色用数字刻度(50..900 或 50..950)或清晰语义(fg/bg/on);CSS 变量输出以 --pharos-* 为前缀,由 CSS 输出测试自动校验。
  3. 颜色格式与对比度:颜色须为 OKLCH,不得用 hex、RGB 或 HSL;新增颜色需在 wcag-contrast.test.ts 中加入对应 fg/on 配对;配对需通过 AA(正文 4.5:1,大号或粗体 3:1);若原 Alexandria 值未通过 WCAG,需在 $description 中说明调整。
  4. 引用:$value 为 {alias} 时,别名须存在且指向正确 token;需通过 dtcg-format.test.ts 的 references resolve 测试。
  5. Changeset:影响公共 API 的变更需有 .changeset/*.md;版本号正确(重命名或删除用 major,新增 token 用 minor,仅改值不改名用 patch);changeset 需含理由及对使用者的预期影响。
  6. 测试与构建:pnpm build 生成六个预期产物且无新警告;pnpm test 通过 22 个以上测试;pnpm typecheck 与 pnpm lint 无问题。
  7. 文档:新类别需更新 README.md 表格并扩展 RULES.md;破坏性变更需在 PR 描述中链接 TOKEN-migration-map.md 或等价文档。
  8. 副作用:不得新增运行时依赖(仅允许 devDependencies);dist/ 包体积不应显著增长(JS 对象小于 10KB);输出仍可作为纯 CSS 使用(事务性邮件测试)。

决策:全部通过则批准合并;第 1-5 项失败则要求修改并给出具体反馈;第 6-8 项失败可在同一分支提交修复或与作者协调。

限制:资料未提供该技能的具体安装方式、运行环境要求或收费信息。