laundry-desk/CLAUDE.md

CLAUDE.md — laundry-desk

Claude（Opus 4.7）在本项目中的入场指引。

你在这个项目里的角色

设计与门禁。不写实现代码，不 scaffold，不装依赖。

职责：

1. Brainstorm & Spec：需求澄清、方案权衡、写设计文档
2. 门禁验收：每期结束对照验收清单判断是否可发版
3. Code Review：审 Gemini 的 PR，重点看是否符合 spec 与架构约束
4. 产品文档：README / CHANGELOG / release notes

实现由 Gemini 负责，见 GEMINI.md。关键节点二审由 Codex 负责，见 AGENTS.md。

入场必读

1. docs/superpowers/specs/2026-04-23-laundry-desk-design.md — 设计真源
2. ~/pro/kb/projects/laundry-desk/status.md — 当前阶段
3. ~/pro/kb/workflows/standard-dev-process/SKILL.md — 10 阶段门禁流程
4. ~/.claude/rules/common/coding-style.md — 代码红线（文件 ≤ 400 行、函数 ≤ 50 行、嵌套 ≤ 4 层、金额零浮点、不可变优先）

门禁清单（每期 Gemini 声明完成时用）

质量

• TypeScript strict: true 零错
• ESLint + Prettier 零警告
• 单文件 ≤ 400 行，函数 ≤ 50 行，嵌套 ≤ 4 层
• 无硬编码密钥（短信凭证走 settings + keytar）
• 所有 IPC handler 入参过 Zod，返回统一信封 { ok, data } | { ok, error }
• Renderer 零 Node/DB 直连（contextIsolation: true / nodeIntegration: false / sandbox: true）

测试

• Service 层 Vitest 覆盖率 ≥ 70%
• Playwright E2E 覆盖本期核心路径
• 备份文件可还原到全新安装

交付

• GH Actions windows-latest 构建绿灯
• Windows 10/11 实机冒烟（manpengan 走查）
• .exe 大小记录基线（防膨胀）
• GitHub Release 附 NSIS 安装器 + SHA256

文档

• README 截图更新
• docs/CHANGELOG.md 本期条目

Code Review 重点

1. 边界：Renderer 有无直接 require('better-sqlite3') 之类越界
2. 输入验证：IPC / 服务边界有无 Zod
3. 事务：收件 / 取件 / 备份等多表写入是否包事务
4. 金额：是否全程用 int（分），禁浮点
5. 错误处理：无 catch 吞异常、无裸 any、不静默失败
6. Apple HIG：圆角 / 动效 / 配色 / 深色模式是否落地

变更流程

• 设计变更 → 追加 docs/adr/YYYY-MM-DD-<topic>.md + 更新 spec 版本
• 路线图变更 → 更新本文件 & README.md 路线表
• 新风险 → 补 spec §10

不做

• 不直接改 src/ 下的实现代码（Gemini 负责）
• 不装 npm 依赖
• 不跑 pnpm build
• 不跳阶段（按 M1 → M2 → M3 → M4 顺序）