problem-summarizer

# 问题总结记录 Skill 将开发过程中遇到的问题和解决方案自动记录到固定文档，形成可检索的项目知识库。 --- ## 环境检查（每次加载必执行） 1. 检查记录文档是否存在：项目根目录下的 `docs/DEV-LOG.md` 2. 若不存在，自动创建 `docs/` 目录和 `DEV-LOG.md`，写入初始结构 3. 确认 `docs/DEV-LOG.md` 已在 `.gitignore` 中（不提交到 Git） --- ## 核心功能 ### 1. 记录问题（默认触发） 当用户说"记录问题"、"总结问题"、"这个问题怎么解决的"时，执行： 1. 回顾当前对话中遇到的问题 2. 提取关键信息：问题描述、根因、解决方案、相关文件 3. 追加到 `docs/DEV-LOG.md` **记录格式：** ```markdown ## [日期] 问题标题 **问题描述：** 一句话描述问题现象 **根因分析：** 问题的根本原因 **解决方案：** 具体的解决步骤 **相关文件：** - `path/to/file.ts:123` — 相关代码位置 **标签：** #标签1 #标签2 ``` ### 2. 查看记录 当用户说"查看问题记录"、"问题列表"时： - 读取 `docs/DEV-LOG.md` - 按时间倒序展示所有记录 ### 3. 搜索问题 当用户说"搜索问题 <关键词>"时： - 在 `docs/DEV-LOG.md` 中搜索关键词 - 返回匹配的记录 --- ## 记录原则 1. **只记录有价值的问题**：跳过简单的拼写错误、明显的语法问题 2. **突出根因和方案**：问题描述和解决方案必须具体可操作 3. **保留代码位置**：记录相关的文件路径和行号 4. **添加标签**：便于后续检索，如 `#API` `#配置` `#依赖` `#权限` --- ## 触发条件 **自动记录：** - 用户明确说"记录这个问题"、"总结一下" - 解决了一个非平凡的问题后，主动询问是否记录 **手动触发：** - `/problem-log` — 查看所有记录 - `/problem-search <关键词>` — 搜索记录 --- ## 文件位置 记录文档固定路径：项目根目录下的 `docs/DEV-LOG.md` 该文件在 `.gitignore` 中，不提交到 Git。仅作为本地开发知识库使用。 --- ## 文档结构 ```markdown # 开发问题记录 日期：2026-05-09 --- ## 一、MCP 连接失败 ### 问题描述 MiniMax MCP 工具调用返回超时错误。 ### 根因分析 网络代理配置问题，MCP 服务器无法访问 MiniMax API。 ### 解决方案 1. 检查代理设置：`echo $HTTP_PROXY` 2. 在 MCP 配置中添加代理环境变量 3. 重启 Claude Code ### 修改文件 - `~/.claude/settings.json` — MCP 配置 --- ## 二、xxx 问题 ... ```