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