Docs Style
技术文档写作核心原则，提升LLM友好性
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Docs Style。 它的用途是：技术文档写作核心原则，提升LLM友好性 完整的 Skill 内容见：https://321skill.com/skills/docs-style-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请按照Docs Style原则审查下面这段技术文档，检查语气是否一致、结构是否清晰、是否适合LLM解析。' 它会逐句分析，指出语调问题（如过于正式或口语化），建议拆分长段落，并优化指代清晰度，最终输出修改后的版本及修改说明。
介绍
该技能提供了一套技术文档写作的核心原则，涵盖语气、语调、结构以及面向LLM的友好模式。它帮助你规范文档的写作风格，确保内容清晰、一致，并优化AI对文档的理解和生成效果。无论是编写新文档还是审查现有文档，都可以直接应用这些原则。
使用方法很简单：在写作或审查文档时，将本技能提供的原则作为参考指南。你可以向AI助手提出要求，比如“请按照Docs Style原则审查以下文档”，AI会检查文档的语调、结构、LLM友好性等方面，并给出修改建议。也可以将原则嵌入到你的写作流程中，作为自动检查的一部分。
适合文档工程师、内容创作者、技术写作者以及任何需要编写技术文档的开发者。尤其适合那些希望文档既能被人类高效阅读，又能被AI（如LLM）准确解析和引用的团队。高校学生撰写课程论文、学术研究者撰写论文或技术报告也可以从中获益。
使用建议：将该技能作为团队文档编写的统一标准，避免风格混乱。注意，它侧重于通用写作原则，不覆盖特定行业或领域的术语规范。对于需要严格遵循特定格式（如API文档、合规文档）的场景，建议结合专业模板使用。
核心特点
同类技能多聚焦于人类阅读体验，本技能特别强调LLM-friendly模式，从token结构、段落拆分、指代清晰度等维度优化文档，让AI也能高效理解和引用。
注意事项
不适合需要严格遵循行业术语或特定格式（如法律、医疗文档）的场景，也不适合非技术类的创意写作。
常见问题
这个技能适用于哪些文档类型？
适用于所有技术文档，包括API文档、开发指南、会议纪要、技术方案、博客等，尤其适合需要被LLM读取或嵌入上下文的场景。
如何应用LLM-friendly模式？
遵循简洁的句子结构、避免歧义指代、使用清晰的标题层级、控制段落长度，并加入结构化标记（如列表、表格）以降低token消耗。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/docs-style-x-3/raw/index.md 读取 Docs Style 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/docs-style-x-3/raw/index.md（查看排版版本）