Docs Style
技术文档写作核心原则指南
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Docs Style。 它的用途是：技术文档写作核心原则指南 完整的 Skill 内容见：https://321skill.com/skills/docs-style-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘请根据 Docs Style 原则，帮我审查这段 API 接口文档的初稿。’，它会依据核心原则，从语调、结构、清晰度等方面给出具体的修改建议，确保文档专业且易于理解。或者，在开始撰写新模块的说明时，你可以说：‘我需要撰写一份关于新认证服务的文档，请提供 Docs Style 的指导。’，它会列出关键原则，帮助你构建清晰、结构化的文档框架。
介绍
这个 Skill 旨在解决技术文档写作中风格不一、结构混乱、不易被大模型理解等问题。它提供了一套关于技术文档写作的核心原则，涵盖了语调、风格、结构和针对大模型友好的写作模式。
使用时，你可以将其作为写作或审查任何技术文档时的参考指南。无论是撰写 API 文档、用户手册还是内部设计文档，都可以调用此 Skill 来确保内容的专业性、一致性和清晰度。
它非常适合文档工程师、技术写作者、开发者以及任何需要产出或评审高质量技术文档的角色。无论是创建新文档，还是优化现有文档，这个 Skill 都能提供系统性的指导。
建议在项目初期就引入这些原则，并作为团队文档规范的一部分。注意，它提供的是通用原则而非具体模板，需要根据实际项目内容和受众进行灵活应用。
核心特点
与通用写作指南不同，它专门针对技术文档场景，并特别强调了“LLM-friendly patterns”，即如何撰写易于大语言模型理解和处理的文档，这在AI辅助开发日益普及的当下尤为关键。
注意事项
不适用于创意写作、营销文案或非技术性内容的撰写。
常见问题
这个 Skill 能帮我直接生成文档吗？
不能，它提供的是写作原则和规范，你需要基于这些原则来撰写或审查文档。
适合用来写什么类型的文档？
适合所有类型的技术文档，如 API 文档、用户手册、系统设计文档、代码注释等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/docs-style-x-2/raw/index.md 读取 Docs Style 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/docs-style-x-2/raw/index.md（查看排版版本）