20595a7545
- README.md: 项目状态 + 路线图 + 分工 - CLAUDE.md: Claude 职责 + 门禁清单 + Review 重点 - AGENTS.md: Codex 二审侧重（M1 安全 / M4 密钥 / 并发点） - GEMINI.md: Gemini 分期实施清单 + 红线 + 工作流 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
70 lines
2.7 KiB
Markdown
70 lines
2.7 KiB
Markdown
# 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`](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 顺序）
|