Claude Code explanation-docs：解释设计取舍和运作机制
EnglishClaude Code 安装步骤
- 打开 GitHub 固定提交的 `.claude/skills/explanation-docs/SKILL.md`，核对内容与使用条件。
- 在自己的项目中创建 `.claude/skills/explanation-docs/`，把核对后的文件保存为 `.claude/skills/explanation-docs/SKILL.md`。
- 在该项目根目录启动 Claude Code，在斜杠菜单中选择 `/explanation-docs`。
中文摘要
面向想理解原理的读者写概念说明，交代问题、运作关系、设计理由与代价。
SKILL.md 中文导读
可复现示例
样例 docs-38 要解释为何活动图片单独缓存。已知 {updates: 'weekly', goal: 'fewer repeated downloads'}，缓存可能延迟展示刚更新的图片。工作步骤
- 从读者的原理问题出发找支持的系统事实。
- 对比原方案和选定方案，写明何时受益以及付出的代价。
验收方法
段落说明 {benefit: 'fewer repeated downloads', tradeoff: 'temporary stale images'}。把失效机制作为原理解释，操作步骤放到相关指南。
GitHub 原文 · 更新日期
适用环境
在 Claude Code 中准备已有设计记录或系统事实。说明文档需要可核对的约束、备选方案和读者问题。
常见问题
概念说明需要包含操作按钮吗？
主要回答为什么和如何运作。可链接到面向操作的指南，让读者在需要时再查看具体步骤。