菜单
Use when adding / editing 运维命令 or AI 提示词模板 to /code/ops page (db/build/deploy/backup/prompt 5 类). DB-backed:走 X-Admin-Key 端点 (`api.cuberoot.me/v1/ops/commands`),非源码改动。Triggers: "加运维命令", "ops command", "runbook 加一条", "/code/ops", "加到运维页", "OpsPage", "加提示词", "prompt 模板", "ops_commands".
用 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 | ops-runbook |
| description | Use when adding / editing 运维命令 or AI 提示词模板 to /code/ops page (db/build/deploy/backup/prompt 5 类). DB-backed:走 X-Admin-Key 端点 (`api.cuberoot.me/v1/ops/commands`),非源码改动。Triggers: "加运维命令", "ops command", "runbook 加一条", "/code/ops", "加到运维页", "OpsPage", "加提示词", "prompt 模板", "ops_commands". |
/code/ops 命令存在 PG ops_commands 表,不是源码硬编码。改一条 = 调 admin API,不需要 commit + deploy。
KEY=$(grep -oP 'ADMIN_API_KEY\*\* \| `\K[^`]+' D:/cube/cuberoot.me/.password.md)
curl -X POST -H "X-Admin-Key: $KEY" -H 'Content-Type: application/json' \
https://api.cuberoot.me/v1/ops/commands \
-d '{
"id": "unique-kebab",
"category": "db",
"cwd": "core/",
"chips": [{"zh":"~25 min","en":"~25 min"}],
"title_zh": "...", "title_en": "...",
"desc_zh": "...", "desc_en": "...",
"cmd": "pnpm --filter @cuberoot/foo exec tsx src/bin/x.ts",
"variants": [{
"zh": {"label":"...","note":"..."},
"en": {"label":"...","note":"..."},
"cmd": "..."
}]
}'
category 决定 rail/标签/过滤色;prompt 类 cmd 渲染会去掉 $ shell prefix + 改 sans 字体。
| 操作 | 方法 | 路径 |
|---|---|---|
| 列全部 | GET | /v1/ops/commands (public, 5min cache) |
| 改 | PUT | /v1/ops/commands/:id (不能改 category, 要换分类先 DELETE 再 POST) |
| 删 | DELETE | /v1/ops/commands/:id |
| 重排 | PUT | /v1/ops/commands/reorder body {category, ids: string[]} (该 category 全部 id 的新顺序) |
prod base https://api.cuberoot.me;本地 dev 需 vite proxy 改指 127.0.0.1:3001 (默认指 prod)。
提示词模板 (用户常对 AI 重复说的指令) 放 category='prompt':
cmd 字段直接放完整中文提示词,多行用 \n 分隔,可含 [填] 类占位$ shell prefix + 用 sans 字体 + 紫色 rail (跟 shell 命令视觉区分)CATEGORIES 数组 + migration CHECK 约束 + client CATEGORIES + 加色 + 加 lucide 图标pnpm dev / npm run 这种通用命令不进 ops,放各包 READMEssh root@cuberoot 'PGPASSWORD=314159 psql -U cuberoot cuberoot_db -c "SELECT id, category, title_zh FROM ops_commands ORDER BY category, position"'
本地 dev (5433 pwd dev):
$env:PGPASSWORD='dev'; docker exec -i pg13 psql -U postgres cuberoot_db -c "..."
migrations/0010_ops_commands.sql + 0011_seed_ops_commands.sql,见 src/db/schema.pg.sql 第 21 节。