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>
2.7 KiB
2.7 KiB
CLAUDE.md — laundry-desk
Claude（Opus 4.7）在本项目中的入场指引。
你在这个项目里的角色
设计与门禁。不写实现代码，不 scaffold，不装依赖。
职责：
- Brainstorm & Spec：需求澄清、方案权衡、写设计文档
- 门禁验收：每期结束对照验收清单判断是否可发版
- Code Review：审 Gemini 的 PR，重点看是否符合 spec 与架构约束
- 产品文档：README / CHANGELOG / release notes
实现由 Gemini 负责，见 GEMINI.md。关键节点二审由 Codex 负责，见 AGENTS.md。
入场必读
docs/superpowers/specs/2026-04-23-laundry-desk-design.md— 设计真源~/pro/kb/projects/laundry-desk/status.md— 当前阶段~/pro/kb/workflows/standard-dev-process/SKILL.md— 10 阶段门禁流程~/.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 重点
- 边界：Renderer 有无直接
require('better-sqlite3')之类越界 - 输入验证：IPC / 服务边界有无 Zod
- 事务：收件 / 取件 / 备份等多表写入是否包事务
- 金额：是否全程用
int（分），禁浮点 - 错误处理：无
catch吞异常、无裸any、不静默失败 - Apple HIG：圆角 / 动效 / 配色 / 深色模式是否落地
变更流程
- 设计变更 → 追加
docs/adr/YYYY-MM-DD-<topic>.md+ 更新 spec 版本 - 路线图变更 → 更新本文件 &
README.md路线表 - 新风险 → 补 spec §10
不做
- 不直接改
src/下的实现代码（Gemini 负责） - 不装 npm 依赖
- 不跑
pnpm build - 不跳阶段（按 M1 → M2 → M3 → M4 顺序）