# Problem Solution

> 问题解决型文章写作技能。当用户要求写踩坑记录、问题排查、故障处理类文章时使用。产出结构为问题描述、排查过程、解决方案、经验总结。

- Skill: `datawhalechina/problem-solution` (Agent Skill)
- Install (CLI): `npx skillmds@latest add datawhalechina/problem-solution`
- Raw SKILL.md: https://api.skillmd.com/api/skills/datawhalechina/problem-solution/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: datawhalechina (https://skillmd.com/u/datawhalechina)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/datawhalechina/problem-solution

---


# 问题解决型文章写作技能

## 适用场景
- 用户要求写 "XXX 踩坑记录"、"解决 XXX 问题"
- 文章类型为 problem-solution / troubleshooting / debugging

## 写作方法论

### Phase 1: 问题定义
- 精确描述问题现象（错误信息、复现步骤）
- 说明影响范围和严重程度
- 列出环境信息（版本、配置）

### Phase 2: 排查过程
- 按时间线记录排查步骤
- 每步记录：假设 → 验证方法 → 结果
- 展示关键日志和调试输出

### Phase 3: 解决方案
- 给出最终解决方案（代码/配置变更）
- 解释根因（为什么会出现这个问题）
- 提供替代方案（如果有）

### Phase 4: 经验总结
- 提炼可复用的排查方法论
- 列出预防措施
- 关联相关问题