Explanation Docs
提供解释性文档的写作模式与指南，帮助撰写深入的概念性内容。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Explanation Docs。 它的用途是：提供解释性文档的写作模式与指南，帮助撰写深入的概念性内容。 完整的 Skill 内容见：https://321skill.com/skills/explanation-docs-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我需要向新手开发者解释为什么React要采用虚拟DOM，而不是直接操作真实DOM。请根据解释性文档的模式，帮我规划一下内容结构和关键要点。’ 它会引导你思考读者的先验知识，建议从性能瓶颈、跨平台一致性等核心“痛点”入手，并推荐使用类比（如虚拟DOM像是一个建筑蓝图）来构建心智模型，最终帮助你组织出一份逻辑清晰、易于理解的概念指南。
介绍
该技能旨在解决技术文档中概念解释不清、读者难以理解“为什么”的问题。它提供了一套结构化的文档模式（Patterns），指导作者如何撰写以理解为导向的内容，例如解释某个系统为何如此设计、某个概念背后的原理等，而非仅仅描述操作步骤。
使用时，你可以参考这些模式来规划文档结构、组织内容逻辑，并运用其中提供的写作技巧（如使用类比、揭示因果关系、构建心智模型等）来提升文档的清晰度和深度。它更像是一套方法论和最佳实践集合，而非一个直接生成文本的工具。
它非常适合需要撰写技术文档、产品说明、内部知识库或教学材料的内容创作者、文档工程师、技术布道师以及希望提升沟通深度的开发者和产品经理。对于高校学生撰写论文的文献综述或理论部分也有参考价值。
使用建议是，不要将其视为僵化的模板，而应作为思考框架。在撰写前，先明确你的读者是谁、他们已有的认知水平以及你希望他们理解的核心“洞见”是什么。注意事项包括，避免在追求解释深度时引入不必要的复杂性，并确保最终文档仍服务于实际的应用或理解目标。
核心特点
与大多数专注于代码生成或API文档提取的技能不同，本技能专注于“解释性”（Explanation）文档的写作方法论本身，提供了从问题定义、结构设计到表达技巧的完整模式库，旨在提升内容的理解深度而非生成速度。
注意事项
不适合需要快速生成操作指南、API参考或纯步骤性文档的场景。
常见问题
这个技能能直接帮我写文档吗？
不能直接生成文档，它提供的是写作模式和指南，帮助你规划和撰写更易理解的概念性内容。
适合写什么类型的文档？
适合撰写解释系统原理、设计思路、复杂概念背后的“为什么”等以理解为导向的指南或文章。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/explanation-docs-x/raw/index.md 读取 Explanation Docs 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/explanation-docs-x/raw/index.md（查看排版版本）