菜单
Use when regenerating `stats/comp_names_zh.json`, debugging Chinese comp names, or displaying comp name in new code (must go through `utils/comp_localize.ts`, never raw `c.name`). Triggers: "中国比赛中文", "localizeCompName", "comp_names_zh", "fetch_comp_names_zh", "比赛名本地化", "stripWcaPrefix", "localizeCity", "CITY_ZH".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when writing/editing CSS color values, backgrounds, borders, text colors, or dark/light theme behavior. shadcn-style token system + color-mix derivations + dark-locked page list. Triggers: "颜色", "color", "background", "background-color", "border", "text color", "--background", "--foreground", "--muted", "--accent", "dark mode", "light mode", "theme", "主题", "暗色", "深色", "dark/light", "shadcn", "hex", "rgba", "color-mix", "#888", "#aaa", "#fff", "prefers-color-scheme", "data-theme".
Use when user wants to fill in /code/architecture 第 11 节的日历 + 列表 — 从 JSON 最后一条日期之后开始, 把每个有 commit 的日子补上中英 1 行总结 (日历); 每个新页面/路由上线都加进 TIMELINE 数组 (列表)。Triggers: "/timeline-update", "更新 timeline", "补日历", "补 timeline", "update commit calendar".
给 /sim 加一个新魔方「模拟器」=站内 3D 渲染 + 转角动画 + 拖拽转动的新「类型」(不是一次性 HTML 页面)。当用户说"造某某魔方模拟器""给 /sim 加 X 魔方""新魔方类型""X cube simulator"时用。覆盖 SQ1/Ivy 模板契约、必改文件、Three.js 几何、拖拽转动(raycast+方向)、招式对接 solver、必踩的坑。区分:造"求解器"引擎走 skill new-substep-solver;本 skill 只管 /sim 的渲染+动画+交互集成。Triggers "造魔方模拟器", "造X魔方模拟器", "枫叶魔方模拟器", "给 /sim 加魔方", "sim 加魔方", "新魔方类型", "add puzzle to sim", "X cube simulator", "/sim 新增魔方", "魔方模拟器", "sim 拖拽转动".
Use when AI/脚本管理 alg DB (create/update/del/reorder/batch-validate/dedup) 免 OAuth。X-Admin-Key 通道 + 4 个 admin endpoints + 直 SQL playbook。Triggers: "alg admin", "X-Admin-Key", "reorder cases", "del alg case", "alg dup", "批量校验 alg", "AdminCaseEditor", "alg_cases SQL".
用户要造一个新求解器时用。**先分流**:3x3 子阶段 / 大状态空间(需 Rust+WASM+大表+真题统计管道)= 范本 block222,完整流程 solver/VARIANT_PLAYBOOK.md;非 WCA 小状态整解(可整枚举,如枫叶 Ivy 29,160 态)= 纯 TS 全 BFS,**不碰 Rust/WASM/管道**,范本 packages/client/lib/ivy-solver.ts(见正文 §0)。Triggers: "造个 X 求解器", "新求解器", "枫叶魔方求解器", "ivy 求解器", "非 wca 求解器", "小魔方求解器", "roux s1 求解器", "eoline 求解器", "petrus 求解器", "new substep solver", "加一个 step solver", "块求解器", "新变体", "new variant solver".
Use when touching WCA competition JSON (upcoming_comps/all_past_comps), their consumers, or any comp picker/search UI. Triggers: "比赛 JSON", "upcoming_comps", "all_past_comps", "competition schema", "比赛数据源", "比赛搜索", "CompPicker", "comp picker", "搜比赛".
| name | comp-names-zh |
| description | Use when regenerating `stats/comp_names_zh.json`, debugging Chinese comp names, or rendering a competition name anywhere in the UI (must go through `lib/comp-localize.ts`, never raw `c.name`; the year in the name must not duplicate a date shown next to it). Triggers: "中国比赛中文", "localizeCompName", "comp_names_zh", "fetch_comp_names_zh", "比赛名本地化", "stripWcaPrefix", "CompCell", "比赛名年份", "比赛名重复年份", "stripCompYear", "localizeCity", "CITY_ZH". |
前端显示规则全在 core/packages/client/lib/comp-localize.ts 的 JSDoc（localizeCompName / stripWcaPrefix）。新代码渲染比赛名一律走它，禁止裸 c.name。compNameZh() 命中前先 await loadFlagData()。
比赛年份已经显示在页面上（同行日期列 / 卡片日期 / 年份分组标题）时，比赛名里就不再出现年号：夹江公开赛2026 + 2026-07-25 → 显示 夹江公开赛。
<CompCell … date={comp.start_date} />；date 必填（string | null），逼你表态。localizeCompName(id, name, isZh, { date })。null / 不传 —— 那里年号是唯一的区分信息。stripCompYear，禁在调用点手写 /\s*20\d\d\s*$/ 之类正则。守卫：写入即拦 .claude/hooks/block-comp-name-year-regex.ps1 + CI tests/comp-year-single-source.test.ts。stats/comp_names_zh.json由 core/packages/stats-build/src/bin/fetch_comp_names_zh.ts 生成（在 core/packages/stats-build 下跑）。
npx tsx src/bin/fetch_comp_names_zh.ts # 全量
npx tsx src/bin/fetch_comp_names_zh.ts --refresh # 增量（清第 1 页 + WCA API 缓存）
name 和 short_name，值是 cubing.com 中文名。_alias_to_wca_id_candidates（原始 / 去 "Open" / 去 "Cubing" 前缀）→ 失败回退 start_date + country=CN；强差异老比赛靠 ALIAS_TO_WCA_ID_OVERRIDE 硬编码。.comp_names_zh_cache/（.gitignore）。/competition/ 切到 /live/，scraper 正则两种都要收。~DD（同月）/ ~MM-DD（同年跨月）/ ~YYYY-MM-DD（跨年，如 2025-12-31~2026-01-01）—— 正则三种都要兼容。name（全名）vs short_name（短名）必须都作 key，否则 all_past_comps.json（用 name）查不到。Deploy Core 是否失败、dist/_assets/*.js 是否含新代码。lib/city-localize.ts::localizeCity(city, isZh)，新增城市直接往 CITY_ZH 加键。