01-listed

# 通用开发要求 **不要读取本目录所有文件。** 先读本文件的内联规则，仅在需要深入了解时才按需读取对应的独立文件。 --- ## 核心铁律（必须内化，不需要读文件） ### 代码完整性铁律（最高优先级） > 详细版 →「代码完整性铁律.md」 1. **文件系统是唯一真相** — 修改前必须读取文件，禁止凭记忆改代码 2. **只做增量修改** — 不重写整个文件，只改需要改的行 3. **diff 确认** — 修改后 `git diff` 确认范围正确 4. **任务边界锁定** — 没让你改的代码不要碰，不要"顺便优化" 5. **修改前三问** — 用户让我改了吗？是必需的吗？其他功能不变吗？ 6. **审查结论不等于修改指令** — 代码审查/优化建议必须逐条判断是否合理，不能看到"问题列表"就机械全改。特别是： - **理解原设计意图**：改之前先问"原作者为什么这么写"，如果有合理理由就不改 - **确定性输出永久缓存**：纯函数结果（TTS、编译产物等）不设 TTL，��期只浪费重算成本 - **改变现有行为必须说明理由**：对已上线运行正常的逻辑，修改前必须向用户说明为什么改、改了有什么影响，等确认后再改 - **区分真问题和误判**：自动化审查工具/AI 分析报告的每条建议都可能是错的，必须独立思考 ### 一次做到位 > 详细版 →「一次做到位规范.md」 - 永远做最完整方案，不做最小版本等用户追问 - 宁可多做让用户删，不要少做让用户追 - 页面必须处理 loading / success / empty / error 四种状态 - Bug 修复要全链路分析，不要修一个推一个 ### 产品思维 > 详细版 →「产品思维和深度分析规范.md」 - 新项目/新功能模块：先做产品分析（竞品→旅程→逐页规格），确认后再写代码 - 每个页面规划到具体模块级别，不是"Dashboard 页面"而是"4 个统计卡 + 趋势图 + 最近活动" ### 借鉴子文档（mattpocock/skills，MIT，按需读） > 详细版 →「深模块设计.md」— 深模块（小接口藏大量行为）/ seam / 删除测试 / 为可测性设计 / Design-It-Twice（设计模块接口、决定 seam 放哪时读） > 详细版 →「一次性原型-prototype.md」— 用扔掉的代码答一个设计问题：LOGIC（终端驱动状态机）/ UI（`?variant=` 多变体）；起 dev server 须守 CLAUDE.md 本地进程纪律 --- ## 开发流程规则（按需读取详细文件） | # | 规则 | 一句话摘要 | 详细文件 | |---|------|-----------|---------| | 1 | 垂直切片开发 | 每个功能 API+前端+交互同时完成，用户立即可体验 | 「垂直切片开发规范.md」 | | 2 | 开发自验证 | 代码写完 ≠ 完成，必须自测通过 | 「开发自验证规范.md」 | | 3 | API 健壮性 | 超时 5s、重试 3 次、四种前端状态 | 「API健壮性开发规范.md」 | | 4 | 技术选型 | 按商业级标准选型，不默认选免费 | 「技术选型规范.md」 | | 5 | 版本管理 | 语义化版本、CHANGELOG、发布流程 | 「版本和变更管理.md」 | | 6 | 错误处理 | 用户友好、开发可追踪、系统可恢复 | 「错误处理和日志规范.