Replay 说明文档

# 重放系统 (Replay System) 重放系统记录已成功的错误解决方案以供将来参考，从而在遇到类似错误时实现更快的故障排除。 ## 工作原理 1. 遇到错误 | v 2. 检查重放历史 -----> 匹配成功? ---> 应用已知解决方案 | | 未匹配 | | v v 验证并完成 3. 分析与解决 | v 4. 记录解决方案 ---------> .claude/error-solutions/ | v 5. 未来收益 ## 目录结构 project/ └── .claude/ └── error-solutions/ ├── nodejs-module-not-found-express.yaml ├── react-hydration-mismatch-date.yaml ├── postgres-connection-refused.yaml └── ... ## 记录解决方案 ### 何时记录 在以下情况记录解决方案： - 花费了大量时间进行调试 - 错误可能会再次发生 - 解决方案不明显 - 团队成员可能会遇到相同问题 ### 如何记录 1. 复制模板： bash mkdir -p .claude/error-solutions cp solution-template.yaml .claude/error-solutions/.yaml 2. 填写详细信息： yaml id: "nodejs-module-not-found-express" created: "2024-01-15T10:30:00Z" error: type: "dependency" category: "ModuleNotFound" language: "nodejs" pattern: "Cannot find module 'express'" context: "Starting Node.js server" diagnosis: root_cause: "Express package not installed" factors: - "npm install not run after git clone" - "package.json missing express" solution: immediate: - "Run: npm install express" proper: - "Add express to package.json if missing" - "Run: npm install" verification: - "Run: node server.js" - "Check server starts without error" prevention: - "Document npm install in README" - "Use npm ci in CI/CD" metadata: tags: ["nodejs", "npm", "dependency"] ## 错误签名生成 创建一致的签名以进行匹配： ### 模式：`[language]-[category]-[specific]` 示例： - `nodejs-module-not-found-express` - `react-hydration-mismatch-date` - `python-import-error-circular` - `postgres-connection-refused-docker` - `docker-permission-denied-volume` ### 规范化错误消息 使用占位符替换特定值： | 原始 | 规范化 | |----------|------------| | `Cannot find module 'express'` | `Cannot find module '{module}'` | | `User 12345 not found` | `User {id} not