Explanation Docs
解释性文档写作模式库，聚焦“为什么”
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Explanation Docs。 它的用途是：解释性文档写作模式库，聚焦“为什么” 完整的 Skill 内容见：https://321skill.com/skills/explanation-docs-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请用因果关系模式解释为什么微服务架构中的服务发现通常使用最终一致性而非强一致性'，AI会按照Explanation Docs的因果模式，先描述微服务场景，再分析强一致性的代价，然后解释最终一致性如何在此场景下更优，最后总结影响。
介绍
写技术文档时，最难的不是描述步骤，而是让读者真正理解“为什么这样做”。Explanation Docs 提供了一套专门针对解释性文档的模式，帮助你引导 AI 写出概念清晰、逻辑连贯的指南，让读者不仅知道怎么操作，更明白背后的原理和设计意图。
使用时，你只需在提示词中引用对应的模式（如“因果关系”、“类比拆解”或“历史演化”），AI 就会按照该模式的结构组织内容。例如，选择“因果模式”后，AI 会先陈述现象，再分析原因，最后总结影响，从而生成一篇有深度的解释性文档。
适合文档工程师、技术写作者、学术研究者、产品经理等需要撰写概念指南、教程、白皮书或设计文档的人群。尤其适合那些需要向非技术读者解释复杂原理的场景，比如 API 设计哲学、系统架构决策或算法背后的数学原理。
使用时注意：Explanation Docs 模式专注于概念解释，不适合写操作步骤、API 参考或快速入门指南。如果你需要的是“怎么做”的文档，建议搭配其他专注过程描述的技能使用。另外，模式本身是结构建议，实际内容仍需结合具体领域知识。
核心特点
不同于通用的“写技术文档”技能，Explanation Docs 专门提供“解释为什么”的文档模式（如因果分析、类比推理、演变轨迹），让 AI 生成的内容更注重概念理解和逻辑推导，而非单纯描述步骤。
注意事项
不适合编写操作步骤、API 参考、快速入门等以“怎么做”为导向的文档。
常见问题
这个技能和普通写技术文档的提示词有什么区别？
普通提示词可能只要求“写一篇关于XX的文档”，而 Explanation Docs 提供了具体的模式框架（如因果模式、对比模式），引导 AI 按特定结构解释原理，输出更深入的概念指南。
可以用它来写 API 文档吗？
可以用于解释 API 的设计理念和取舍，但具体参数说明和调用示例建议搭配其他技能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/explanation-docs-x-2/raw/index.md 读取 Explanation Docs 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/explanation-docs-x-2/raw/index.md（查看排版版本）