القائمة
Shopline chill 扫雷 Web 游戏项目开发指南。修改代码、实现功能、修复 bug、 重构或讨论架构时使用。先读 docs/PROJECT.md 的 Current Task 与 docs/REVIEW-LOG.md。 硬性约束：src/**/*.ts 单文件 ≤800 行；core 无 DOM；规则只在 core。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | minesweeper |
| description | Shopline chill 扫雷 Web 游戏项目开发指南。修改代码、实现功能、修复 bug、 重构或讨论架构时使用。先读 docs/PROJECT.md 的 Current Task 与 docs/REVIEW-LOG.md。 硬性约束：src/**/*.ts 单文件 ≤800 行；core 无 DOM；规则只在 core。 |
docs/PROJECT.md — Current Task、TODO、迭代约定docs/REVIEW-LOG.md — 最近 Review 结论docs/SPEC.md — 经典规则（冲突时 SPEC 优先）docs/MODES.md — classic / hex / endless 模式说明docs/ARCHITECTURE.md — 技术栈与分层docs/MODULES.md — 模块接口与导出docs/CODE-OPTIMIZATION-PLAN.md — 模块化拆分方案与验收（重构时必读）专项方案（按需）：
docs/TUTORIAL-PLAN.md — 新手教程（固定盘、Canvas 引导、不计榜）docs/DIFFICULTY-PRESET-PLAN.md — 无尽难度四档 preset、排位锁专家docs/MOBILE-TOUCH-INPUT-PLAN.md — 移动端触摸映射docs/ENDLESS-HUD-FEEDBACK-UX-PLAN.md — HUD 视觉变更（与 refactor 分离）/admin/*）SIGNET_SDK_URL）；本地 dev 可用 ACCESS_USERNAME / ACCESS_PASSWORDJWT_SECRET；环境变量见 .env.examplevercel-web-scripts：services/auth/、app/auth/vercel-2fa/callback/game-client/app/admin-chrome.ts每个 TODO 子项：
docs/REVIEW-LOG.mddocs/PROJECT.md 勾选与 Current Tasksrc/core/ 禁止 document / windowsrc/core/src/ui/renderer/ 只做绘制与 hit-testsrc/ui/game-canvas/src/**/*.ts 每个文件 ≤ 800 行，无例外create.ts）目标 ≤ 200 行；单职责子模块目标 ≤ 400 行find src -name '*.ts' -exec wc -l {} + | awk '$1 > 800 {print}'
若有输出 → 必须拆分后才能合并。
clamp01、easeOutCubic、roundedRectPath、loadRuntimeImage 等只放在 src/ui/primitives/function clamp01 等（rg 'function clamp01' src/ 仅应命中 primitives/math.ts）| 类型 | 要求 |
|---|---|
| 纯重构 | 零行为变更；npm run build 通过；不改 SPEC 可见 UX |
| 功能 / UX | 先改对应 docs/*.md，再改代码；不与 refactor 混在同一 PR |
| 层 | 允许 | 禁止 |
|---|---|---|
core/ | 纯函数、数据结构、模式规则 | DOM、Canvas |
ui/primitives/ | 数学、路径、资源加载 | 游戏状态、业务逻辑 |
ui/renderer/ | 棋盘格绘制、hit-test | 事件监听、计时器 |
ui/game-canvas/ | RAF、输入、HUD 编排、overlay | 布雷、胜负 |
ui/hud-feedback/、ui/cell-fx/ | 纯 Canvas drawer | 模块级可变状态 |
app/ | 路由、session 编排、Lab 面板注册 | 复杂绘制（应调 ui drawer） |
(ctx, …) => void，无闭包状态CanvasRuntimeState（game-canvas/runtime/state.ts）(ctx, w, h, tMs, …) => void，内部只调 Drawer@deprecated import from '…'文件出现以下任一情况时 必须拆分：
| 原集中区 | 拆到 |
|---|---|
game-canvas/create.ts | hud/、overlay/、runtime/、input/、shell/、layout/ |
hud-feedback-fx.ts | ui/hud-feedback/* |
cell-fx.ts | ui/cell-fx/* + ui/cell-fx/gallery/* |
asset-gallery/cell-effects.ts | cell-effect-live-previews.ts、cell-effect-frame-grid.ts、瘦入口 |
glyphs/geometry.ts | shard-shapes.ts、solid-mesh.ts、glyph-canvas.ts、shard-motion.ts |
asset-gallery.ts | asset-gallery-data.ts、asset-gallery-panels.ts、asset-gallery-shell.ts |
core/ai/moves.ts | core/ai/moves/* |
game-canvas/hud/score-hud.ts → drawScoreHud 等ui/cell-fx/gallery/* 或 runtime cell-fx drawerapp/asset-gallery/ 内维护第二套 Score/Combo/LifeLoss 绘制createGameCanvas() 持有唯一 CanvasRuntimeState 实例(rt, ctx, …) 或 (ctx, state, now) 纯函数读写，不在 drawer 文件用模块级 letsrc/core/ → modes/endless, ai/moves, board, engine
src/ui/primitives/ → math, path, assets
src/ui/renderer/ → board, cells（纯绘制）
src/ui/game-canvas/ → create.ts, hud/, overlay/, runtime/, input/, shell/
src/ui/hud-feedback/→ score-pop, combo-burst, …
src/ui/cell-fx/ → board-overlays, gallery/
src/app/ → app.ts, game-session/, asset-gallery/
构建：
npm run build 通过find 命令）分层：
core/ 无 DOMcore/，且已同步 SPEC.md / MODES.mdMODULES.md / ARCHITECTURE.md重构额外：
createGameCanvas、mountEffectPanels 等）不变primitives/ 外重复定义玩法（Endless 手测，功能改动时）：
MOBILE-TOUCH-INPUT-PLAN.md）SPEC.md / MODES.md 版本表，再改代码MODULES.md 与 ARCHITECTURE.mdCODE-OPTIMIZATION-PLAN.md，完成后更新该文档勾选完整 Phase 计划、风险缓解与历史行数数据见 docs/CODE-OPTIMIZATION-PLAN.md v0.4。