القائمة
Use when rendering country flags anywhere in UI (JSX or popup innerHTML). Single entry point: utils/flag.tsx. TW special case (WCA uses Chinese Taipei SVG not flag-icons default) is handled there — do not hand-write. Triggers: "国旗", "flag", "flag-icons", "ChineseTaipei", "台湾国旗".
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
给 /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 | country-flag |
| description | Use when rendering country flags anywhere in UI (JSX or popup innerHTML). Single entry point: utils/flag.tsx. TW special case (WCA uses Chinese Taipei SVG not flag-icons default) is handled there — do not hand-write. Triggers: "国旗", "flag", "flag-icons", "ChineseTaipei", "台湾国旗". |
唯一入口：core/packages/client/components/Flag.tsx。TW 特判只在这里。
<Flag iso2="us" className="cuber-flag" /> // JSX
flagHtml(iso2, { spanClassName: 'flag-span', imgClassName: 'flag-img' }) // innerHTML / MapLibre popup
country 字段是全名（"China"），upcoming JSON 是 iso2（"CN"），直接传进来都行。className 同时给 img 和 span；span/img 需要不同类（历史原因）时用 spanClassName / imgClassName 覆盖。flagInfo(iso2OrCountry) 返回 {kind:'img',...} 或 {kind:'span',...}，想完全自定义渲染时再直接用。iso2 === 'tw' ? <img .../> : <span .../> —— 就是要消灭这个/tools/assets/images/ChineseTaipei.svg —— 路径只应出现在 Flag.tsxFlag.tsx 给 TW <img> 恒定挂低特异度 .cr-flag-img(globals.css,1.33em 宽 / height:auto),裸 Flag 或传错类名都不会撑成 640×480;调用方显式设宽的类按源序覆盖。别删这个兜底,也别在 per-page CSS 重定义 .cr-flag-img。spanClassName="country-flag" imgClassName="country-flag-ct"。尺寸/圆角规则唯一来源 = 全局 app/globals.css(client)/src/index.css(Vite)。禁止任何 per-page CSS 重新定义 .country-flag / .country-flag-ct —— 裸类名(无页面前缀)重复定义会静默全局覆盖,导致改全局一处不生效(曾在 _wca_stats.css 踩过,已清)。.country-flag 加 border-radius。<img> computed width;先确认 .cr-flag-img 兜底已在 stylesheet(改 globals.css 后 dev 不重编需重启/build),再查 className 是否写反或加了页面前缀盖掉了尺寸。MapLibre popup 挂在 map 容器外，页面前缀 CSS（.globe-page .flag-span）不生效。在 popup 里用国旗要单独写 .maplibregl-popup .flag-span / .flag-img 规则（尺寸、vertical-align 等）。
recon_utils.flagClass(iso2) → 拿 fi fi-xx 字符串（TW 不管）country_flags.countryToIso2(wcaCountry) / personFlagIso2(wcaId) / compFlagIso2(compId) → 从 WCA 文本或 id 反查 iso2拿到 iso2 后仍然走 <Flag> / flagHtml 渲染（统一处理 TW）。
任何渲染 WCA 比赛名 的地方,前面必须有该比赛举办国国旗,走 <CompCell compId compName isZh />(components/CompCell/),内部 compFlagIso2 + localizeCompName。页面挂载时必须 loadFlagData() 一次,否则旗 / 中文名都 miss。裸 c.name / compId 直显是 bug。
选手名同理:本页含 person 列必须 iso2 + <Flag>,见 cuber-name-display。