Menu
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", "搜比赛".
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
给 /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 adding/editing user-visible text in the React client (core/packages/client). 站点只服 en + zh-Hans(简体);繁体已移除。文案统一走 tr({en,zh}) / <T en zh /> / useT() 的 t(zh,en) / t('ns.key')+en.json/zh.json。禁内联 isZh/i18n.language 文案三元(CI ratchet + PreToolUse hook 双守)。右上角 lang+theme 用 <HeaderToggles />。Triggers: "中英双语", "双语", "i18n", "translate", "翻译", "add Chinese/English", "isZh", "tr(", "useT", "LangToggle", "HeaderToggles", "主题切换", "右上角", "en.json", "zh.json", "useTranslation", new page, new user-facing string.
Use when user asks how mainstream/major sites or '业界/大厂' handle something (i18n、SEO/路由、定价、某 UX 模式、某功能) and expects AI to already know which sites to check. 按用途从下表挑 6-10 个,跨「巨头 + 本站近邻(开发者工具/SaaS/AI)」两类,然后亲自 WebFetch/WebSearch 核实再下结论,禁凭记忆。Triggers: "主流网站", "大厂", "业界怎么做", "别的网站怎么做", "对标", "benchmark", "mainstream sites", "how do big sites", "industry standard".
用户要更新 /scramble/stats(打乱难度 / 步数分布)的数据时执行本地手动增量刷新管道(按需触发,非定时)。覆盖三阶阶段难度(十字/F2L/EO/DR 等)+ 非 3x3 整解最优步数(二阶/金字塔/斜转/SQ1)+ 三阶整解最优 HTM(333 方法,cubeopt WASM,solver/333opt)三条管道。只能本地跑(三阶需 solver 34GB 表 / 333 需 cubeopt 表)。Triggers: "更新统计", "更新打乱统计", "重跑打乱统计", "更新打乱分布", "更新打乱难度", "update scramble stats", "全部刷新统计", "更新十字统计", "重跑十字统计", "跑十字管道", "更新 puzzle 统计", "更新二阶/金字塔/斜转统计", "更新 sq1 统计", "更新 SQ1 统计", "更新 sq1 分布", "刷新 sq1 精确分布", "sq1 精确分布", "sq1 精确档", "跑SQ1怪物", "跑 sq1 怪物", "啃怪物", "啃 sq1 怪物", "sq1 怪物", "grind sq1 monsters", "补 xcross 变体", "双色底 10f xcross", "backfill_xcross_variant", "pseudo_f2leo 回填", "难打乱补变体", "更新333统计", "更新 333 统计", "更新 333 整解统计", "333 整解最优", "333 HTM 分布", "333opt".
Use when user wants to fill in /code/architecture 第 11 节的日历 + 列表 — 从 JSON 最后一条日期之后开始, 把每个有 commit 的日子补上中英 1 行总结 (日历); 每个新页面/路由上线都加进 TIMELINE 数组 (列表)。Triggers: "/timeline-update", "更新 timeline", "补日历", "补 timeline", "update commit calendar".
Use when raw WCA result value (centiseconds/FMC/MBLD encoding) → display string. Single entry: utils/wca_format_result.ts. Triggers: "WCA 成绩", "成绩格式化", "formatWcaResult", "centiseconds", "FMC", "MBLD", "333mbf", "333fm", "DNF", "DNS", "0.28", "33.00", "slice(1,3)", "padStart(10", 渲染 WCA 成绩 / 纪录值 / PR / 比赛纪录.
| name | comp-data-schema |
| description | 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", "搜比赛". |
所有比赛相关静态 JSON 都在 /stats/ 下，前端通过 serveRepoRoot Vite 插件在本地 serve。生产由 GH Actions 自动 commit，不要手改。
| JSON | 生成器 | 触发 | 用途 |
|---|---|---|---|
/stats/upcoming_comps.json | fetch_upcoming_comps.ts（stats-build） | .github/workflows/update_upcoming.yml（每天 20:00 UTC） | UpcomingComps Top 模式（只含有顶尖选手参赛的比赛 + cubing.com 中国比赛） |
/stats/all_upcoming_comps.json | 同上脚本第二段 | 同上 | Globe upcoming 模式 + UpcomingComps All 模式（WCA 全球全量 upcoming） |
/stats/all_past_comps.json | core/packages/stats-build/src/bin/gen_all_comps.ts | .github/workflows/stats.yml（每周日 20:00 UTC） | Globe history 模式（WCA 历史所有已结束比赛） |
upcoming_comps.json（Top 模式专用）updated_at（ISO）、total_cubers_tracked（整数）、competitions（数组）id、name / name_zh、city / city_zh、country（ISO alpha-2）、start_date / end_date、events（短名数组，见 SHORT_TO_EVENT_ID）、competitor_limit、cubing_china_url?、top_cubersid、name（英文，可含括号中文 Yiheng Wang (王艺衡)）、events（含 wr: 'current'|'former'|null）all_upcoming_comps.json（Globe + All 模式）纯数组，每条：id、name、city、country（ISO alpha-2）、start_date、end_date、events（短名）、competitor_limit、latitude_degrees、longitude_degrees、url
all_past_comps.json（History 模式）纯数组（~14k 条），每条：id、name、city、country、latitude_degrees、longitude_degrees、start_date、end_date、events（短名）。无 url — 前端从 id 反推 https://www.worldcubeassociation.org/competitions/{id}。
components/CompPicker.tsx —— 文本输入 + 自动补全下拉，允许自由文本（非 WCA 比赛仍可手填）utils/comp_search.ts::loadComps() —— 合并 all_past_comps + all_upcoming_comps（按 id 去重），按需懒加载，模块级缓存。不要再写一份本地搜索/缓存。onPick(comp) 一次性回填 name / id / country / date 等字段（参考 ReconSubmitPage applyPickedComp）isZh 时显示 compNameZh(c.name)（country_flags.ts），落空则回退英文utils/date_range.ts::formatDateRangeIsocountry === 'TW' 特判：旗子用 /tools/assets/images/ChineseTaipei.svg，不用 flag-iconsSHORT_TO_EVENT_ID（UpcomingCompsPage） / EVENT_DISPLAY_ORDER（fetch_upcoming_comps.ts）countryCounts / wrCountryCounts 里的 iso === 'TW' ? 'CN' : iso）/competitions 分页会出现跨页重复：分页中途 WCA API 排序会漂移（新增 / cancel 状态改变），同一 id 跨页重复。build_all_upcoming_comps 必须按 id 去重（已在 fetch_upcoming_comps.ts 处理）。新写任何分页聚合 WCA 数据的脚本都要记得这一点。upcomingGeojson 里的 upcomingIds 逻辑。