菜单
Use when user wants to fill in /code/architecture 第 11 节的日历 + 列表 — 从 JSON 最后一条日期之后开始, 把每个有 commit 的日子补上中英 1 行总结 (日历); 每个新页面/路由上线都加进 TIMELINE 数组 (列表)。Triggers: "/timeline-update", "更新 timeline", "补日历", "补 timeline", "update commit calendar".
用 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".
给 /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 | timeline-update |
| description | Use when user wants to fill in /code/architecture 第 11 节的日历 + 列表 — 从 JSON 最后一条日期之后开始, 把每个有 commit 的日子补上中英 1 行总结 (日历); 每个新页面/路由上线都加进 TIMELINE 数组 (列表)。Triggers: "/timeline-update", "更新 timeline", "补日历", "补 timeline", "update commit calendar". |
两个视图:
core/packages/client/app/[lang]/code/architecture/timeline_commits.json (升序, 每天 1 行 {date, zh, en})app/[lang]/code/architecture/_lib/arch-data.tsx 里 TIMELINE (降序 newest-first, 产品级 changelog)!一天六件大事 / 同天五件 / 单日七项 / X 页两天上线 —— 标题只写做了什么,绝不写"几件";body 要列就平铺 + 串,不加"同天 N 件:"前缀一天打了 116 个提交 / 第二天就… / 比提交数 —— 只讲用户能感知的产品变化chore: update upcoming/wca 之类) 也要写, 用据实一句「刷新近期比赛数据 / 中文赛名 / WCA 统计」, 这是事实不是填充废话。真有开发的日子禁泛词 (小修 / 持续迭代 / 收尾 / 微调) — 钻 diff 写具体组件反例 → 正例(必照此口径):
名次和玩出花:可以分解项目组合→名次和可拆分到各项目;计时器接入真实 WCA 打乱一天六件大事:英文网址去前缀、繁体全覆盖…→英文网址去前缀、繁体中文移除、桥式训练器上线速拧计时器正式上线,第二天一天打了 116 个提交→速拧计时器重写上线,随后补齐盲拧 / 蓝牙 / 3D / 观察时间
timeline_commits.json 最后日期 → git log --format='%ad' --date=short --since=<LAST+1d> | sort | uniq -c 列每个待调研日git log --format='%ai|%H|%s' --since=DAY --until=DAY --no-merges^Merge (零非 merge 提交) 的日子。cron / 构建噪音 (chore: update upcoming/wca, ci: rebuild SPA, ^backup:, ^Update .*\.(md|html|json)$) 不再是 SKIP 理由: 同日有真实改动→只写改动、忽略噪音; 整天只有这些→写一句据实数据/构建刷新, 仍不留空update / 1 / i18n / 单字 → git show --stat HASH + git show HASH -- <key-file> 看实际改动。大日 (>20 commits) 里常藏整页新增, 漏掉 = entry 写错+ 串多主题, 写组件名 (/recon, GlobePage 等), 中文标点, 无 emoji, 无句号收尾, 厂商身份 → "自有云服务器"。禁子编号 ((1)..(8)) 和嵌套括号细节 (行数 / commit hash / 子组件清单) — 那些进 TIMELINE expand。日历一句话只列主题词, 哪怕一天 8 件也保持"+串"扁平。看到 entry 长得像段落 = 改grep -nE "id:|href:" LandingPage.tsx + grep -nE "path=" App.tsx 防漏interface TLEntry {
date: string; // 'YYYY-MM-DD' / 'YYYY-MM' / 'YYYY-MM-DD ~ DD'
tag: 'migration' | 'dx' | 'feature' | 'infra';
zh: { title: string; body: string; expand: string };
en: { title: string; body: string; expand: string };
}
tag: migration 换栈/迁数据 · dx 开发流程 · feature 新页/新模块 · infra 部署/CI/SSL
新条目插数组最前, 改完跑 pnpm --filter @cuberoot/client typecheck
日历当前 135 条 (每个有非 merge 提交的日子全覆盖, 含纯 cron 日), TIMELINE 当前 44 条 (产品事件, 约 1 周一件)。新 batch 大概率 1-3 件值得进 TIMELINE。宁多勿少, 用户翻列表想看每个新页的上线日。
/code/architecture 第 11 节: