菜单
Use when regenerating `stats/scramble/*.json` or touching `core/packages/scramble-stats-build/` / `core/packages/client/app/[lang]/scramble/stats/`. Covers CSV 列名、pair rotation 记号、WCA 配色、UI 朝向→底色。Triggers: "scramble-stats-build", "distribution.json", "打乱分布", "scramble_stats".
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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".
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".
| name | scramble-stats-build |
| description | Use when regenerating `stats/scramble/*.json` or touching `core/packages/scramble-stats-build/` / `core/packages/client/app/[lang]/scramble/stats/`. Covers CSV 列名、pair rotation 记号、WCA 配色、UI 朝向→底色。Triggers: "scramble-stats-build", "distribution.json", "打乱分布", "scramble_stats". |
把 D:\cube\solver 产的 7 份 CSV 聚合成 stats/scramble/distribution.json,给 /scramble-stats 用。支持多个 set(WCA 历史 + state-based 数据集),UI 上 dropdown 切换。某个变体 CSV 缺失时跳过(打 [skip] <key>: missing CSV ... 警告,不再抛错),回填后再纳入。
pnpm --filter @cuberoot/scramble-stats-build build
config.yml 是 sets: 数组,每项一个 csv_dir + scrambles_txt,例如:
sets:
- key: wca
label: WCA
csv_dir: D:/cube/scramble/wca_scramble/stats
scrambles_txt: D:/cube/scramble/wca_scramble/wca_scrambles_no_wide_move.txt
- key: xcross_2_col_10f
label: 10-step XCross dual-color states
label_zh: 双色底 XCross 10步状态
csv_dir: D:/cube/scramble/xcross_2_col_10f/stat
scrambles_txt: D:/cube/scramble/xcross_2_col_10f/scrambles.txt
CSV 数据全 gitignored(D:/cube/scramble/),几百 MB 永不进 git。config.yml 也 gitignored,只 commit config.yml.example。
D:/cube/scramble/<set>/:所有打乱数据(无论是 WCA 真实历史 or 由状态空间穷举/采样产生的合成 scramble),都放这里。每个 set 一个子目录,内含 stat/ + scrambles.txt(+ 可选 README.md)。state2scramble 等中间工具留在 D:/cube/solver/ 或 D:/cube/solver_wip/,不进数据目录| 文件 | id 列 | stages | angles |
|---|---|---|---|
std.csv | id | cross xcross xxcross xxxcross xxxxcross | z0 z2 z3 z1 x3 x1 |
eo.csv | id | eo_cross … eo_xxxxcross（5 阶段） | 同上 |
pair.csv | id | cross_pair xcross_pair xxcross_pair xxxcross_pair（4 阶段） | 同上 |
pseudo.csv | id | pseudo_cross … pseudo_xxxcross | z0,z2,z3,z1,x3,x1 |
pseudo_pair.csv | id | pseudo_cross_pseudo_pair … | 同上 |
f2leo.csv | id | f2leo_cross f2leo_xcross f2leo_xxcross f2leo_xxxcross（4 阶段,无 xxxxcross） | 同上 |
pseudo_f2leo.csv | id | pseudo_f2leo_cross pseudo_f2leo_xcross pseudo_f2leo_xxcross pseudo_f2leo_xxxcross（4 阶段,无 xxxxcross） | 同上 |
列名 = ${stage}_${angle},全部变体表头已统一为 id + _z0/_z2/_z3/_z1/_x3/_x1(2026-05-29 把 pair 从老的 scramble+rotation 记号一并归一)。列物理顺序按 /solver UI 排(None / z2 / z' / z / x' / x),标签按 z^n / x^n 标准 cubing 记号(_z0=Y, _z2=W, _z3=O, _z1=R, _x3=G, _x1=B)。pair.csv 样本数比其他小(~112k vs 1.2M)是老快照残留,待回填。
z0/'' 黄 #FEFE00 z1/z 红 #EE0000 z2/z2 白 #555555（cream 底显示深灰）
z3/z' 橙 #FFA100 x1/x 蓝 #0000F2 x3/x' 绿 #00D800
UI 绝不暴露 z0/z1/x1，只用颜色名（黄/红/白/橙/蓝/绿 或 Y/R/W/O/B/G）。
颜色子集直方图，key = 按字母序排好的颜色字母串（B<G<O<R<W<Y）。共 13 个 key：
B G O R W Y —— single 模式 6 选 1WY BG OR —— dual 模式只允许 3 对相反色BGOR ORWY BGWY —— quad 模式排除一对相反色BGORWY —— cn 全中立每个直方图 = 逐行对选中颜色集合取 min 步数的计数分布。
core/packages/scramble-stats-build/src/build.ts（VARIANTS + angleToColor 映射；SUBSET_KEYS = sizes 1/2/4/6）core/packages/client/app/[lang]/scramble/stats/page.tsx（COLOR_LETTERS / COLOR_HEX / DUAL_PAIRS 在这里）core/packages/client/app/[lang]/scramble/stats/_components/DiscreteHistogram.tsx（自写的离散整数 SVG，不要改用 components/wca-stats/DistributionChart.tsx）landing.css 的 Claude 浅色系；wca_stats.css 的暗棕不要污染