| 元规则：按需建档机制 |
用户首次描述某工具用法/工作流时，AI 必须立即落档，杜绝重复描述 |
打开 |
| 备份与开发日志 |
改代码前必做的备份 + 全程开发日志记录规范 |
打开 |
| Rule — 修 bug 必走全字典扫描（防补丁不彻底家族） |
每修一个 ISSUE 后必扫所有同模式 — 防止"修了触发点，漏了姊妹 |
打开 |
| Cloudflare Pages 部署指引 |
MkDocs site 发布到 Cloudflare Pages 的一次性配置 + 后续 push 自动部署 |
打开 |
| 批量 rm untracked 文件 — 安全清单（防误删新建文档） |
ISSUE-0079 复盘 — rm untracked 前必先 git add 新建文档 + dry-run 看清单 |
打开 |
| 扫描类计数 — countByQuery 优先 / 警惕 50k 窗口家族 bug |
任何 selectByQuery({limit, order:id desc}) + 循环计数 都是隐性 bug；4 次复发的家族 |
打开 |
| 数据提取质量防御 — 写入/读取/存量三层防污染（共享池必备） |
ISSUE-0080 phone 误抓 GPS 坐标教训；任何字段抽取都要三层防御 |
打开 |
| 文档目录规范 — 什么在根 / 什么在 docs/ |
repo 根目录与 docs/ 二分规则；防文档散落破坏五层漏斗结构 |
打开 |
| Fix-Regression 防御 — 修 A 不要引入 B，修 B 不要引入 C |
修 bug 前必做 impact-trace 列举所有触发路径；兜底文案不假定单一原因；同文件改动追踪 |
打开 |
| GitHub 推送规则 |
首次推送到 github + 日常同步策略 + 推哪些不推哪些 |
打开 |
| 分组聚合取代表 — 必须按 score，不能取"第一个 |
useMemo / Map.set 分组去重时取"第一遇到的"是隐性 bug；要按价值 score 选最佳代表 |
打开 |
| Rule — 独立 agent 审查（消除作者 anchor bias） |
关键代码必须由没参与原始实现的独立 agent 复核 |
打开 |
| Rule — MV3 持久化陷阱清单（每次 background 改动跑一遍） |
setTimeout / module-let / SW kill 等 MV3 通用陷阱的自查清单 |
打开 |
| Rule — 禁止阉割式修复（功能不工作 ≠ 删功能） |
遇到「点了没反应」不能用 disabled / sortable:false / hidden 偷懒 — 99% 是「客户端能做但要写代码」，不是真做不到 |
打开 |
| 每版本沉淀检查表 — 何时必建 ISSUE / wiki / SPEC |
版本完成 commit 前的强制自查清单，防"小修不归档"积累成历史空白 |
打开 |
| Rule — 重构后语义清单（防 hook 化丢副作用） |
大重构（hook 抽取 / 组件拆分 / 模块化）后必做的副作用语义对账，防丢 useEffect/setState 的次生行为 |
打开 |
| Rule — React 前端 lifecycle 清单 |
useEffect cleanup / unmount race / setInterval 在组件内 等 React 通用陷阱 |
打开 |
| 抓取 pipeline 决策表 / mstage 标签速查 |
SPEC-004 多阶段抓取 — 每种 mstage 标签的含义、UI 颜色、DB 行为速查；改 UI 或逻辑前必看 |
打开 |
| 改设置项 / UI 文案 — 前置自查 |
改 settings 字段或调度相关 label/helper 前的必做检查 |
打开 |
| 信号维度纪律 — 页级信号不能升级到站级状态 |
状态机 / 缓存 / 黑名单设计时区分 row / URL / domain / global 维度；错位升级 = 隐性 bug |
打开 |
| Rule — 待办登记（"想做但先不做"的归宿） |
用户/AI 想到要做但当前不做的事情如何登记，确保不遗忘 |
打开 |
| UI 改动前置自查清单 |
改 UI 文案 / 颜色 / chip / 渲染逻辑前，必跑的"扫描所有重复渲染点"清单 — 防"改了 A 漏了 B |
打开 |
| UI 列维度一致性 — 同一行各列必须看同一对象 |
列 A 看 row 字段、列 B 看 URL/全局聚合 是隐性 bug；同一行视觉上必然矛盾 |
打开 |
| 用户反馈前置查询 — 先查 INDEX 再动代码 |
用户报 bug / 提需求时，按反馈类型给具体 grep 命令清单，防直接读代码错过历史 |
打开 |
| 版本发布流程 |
每次版本更新的标准动作 — 从「准备」到「发布」的完整流程 |
打开 |
| 版本发布铁律 — 项目版本更新总规范 |
改设置页/调度逻辑/文案前必读；第七章 MV3 持久化陷阱 16 条铁律 |
打开 |
| 中文标点 → Edit 工具兜底方案 |
含中文标点的旧 JSX/TS 改不动时，用 Python 切片替换 |
打开 |