auditlisted

# BeatOS 检修 三段式只读审查。用户可指定子阶段（`runtime` / `code` / `drift` / `all`）； 未指定时先问，或按 `drift → code → runtime` 顺序执行（最便宜的先）。 ## 通用原则 - **只读**。任何阶段都不修改源码、不动 git。 - **现场推断目录结构**，不要假设具体路径。每次开始前： 1. `git log --oneline -10` 了解近况 2. `ls` 仓库根，识别顶层结构 3. Read `CLAUDE.md` 头部 + 任何顶层 `conventions/` 或 `docs/` 索引 4. 用 Glob/Grep 现场列出要审查的模块/包，不要硬编码包名 - **引用项目自有规范，不复述**。`CLAUDE.md` 已在上下文里；critical rules、架构红线、命名约定全部以它和 `conventions/` 为准。本 skill 永远不复制粘贴那些条目。 - **区分有意未完成 vs 漂移**。任何看似"未完成"的代码先 grep `ROADMAP.md` 和 `CHANGELOG.md`，如已追踪则标 *tracked* 跳过。 - **每条结论必须含 `file:line`**，方便点开。 - **报告写到 `reports/audits/<phase>/<timestamp>/report.md`**（目录不存在则创建；建议把 `reports/` 加入 `.gitignore`）。报告末尾必须有"建议下一步"清单：立即修 / 转 issue / 接受/搁置。 - **跑前清理**：进入任何阶段前，列出对应 `reports/audits/<phase>/` 下条目数，超过 5 个则保留最近 5 个、提示用户删除更旧的。 - **token 自控**：单次会话使用过半时收尾写报告，不要硬撑到中断。 ## 截图与日志策略 - 默认**不截图**。运行时探索首选 accessibility snapshot（结构化文本，便宜）。 - 截图仅用于：视觉布局/层叠/溢出疑似异常、需要附证据到报告。单次审查 ≤3 张。 - 截图存到 `reports/audits/runtime/<timestamp>/shot-N.png`，或 base64 inline 嵌入报告（你选低成本的一种）。 - 日志：跑完运行时操作后 tail 项目日志目录最近 N 行（先 `ls` 找日志目录，不假设位置）。标记任何 `ERROR` / unhandled rejection / stack trace / 未预期 warning。 --- ## Phase A — Runtime（运行时探索） > 目的：以"真实用户"视角运行当前构建，发现 dogfood 没走到的反常路径与未捕获错误。 ### A.0 准备 1. 在项目内找冒烟脚本：先看顶层 `package.json` 的 `scripts.smoke`，或 `scripts/`、`apps/*/scripts/` 下 `smoke.*`。若找不到则跳到 A.1。 2. 跑冒烟脚本（在它所属的工作目录）。失败则停下，把失败粘出来，**不要进入 A.1**——baseline 都炸了，探索是浪费。 ### A.1 自主探索（核心，3 轮） - 检查 `.claude/settings*.json` 是否启用了 Playwright/MCP 浏览器/Electron 控制工具