Docs Style
技术文档写作原则与LLM友好模式
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Docs Style。 它的用途是：技术文档写作原则与LLM友好模式 完整的 Skill 内容见：https://321skill.com/skills/docs-style-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请根据Docs Style原则，审查以下API文档的语调、结构和LLM友好性，并给出改进建议。'它会逐段分析，指出语气是否中性、标题层级是否合理、术语是否一致，并输出修改后的版本。
介绍
解决什么问题
技术文档写作常常面临语气不统一、结构混乱、LLM难以理解等问题。Docs Style 提供了一套核心原则，涵盖语气、语调、文档结构和AI友好模式，帮助团队写出清晰、一致、易被大模型解析的技术文档。
怎么用
在写作或审阅任何技术文档时，参考该原则即可。你可以将规范文件嵌入项目 README、集成到 CI 检查流程，或作为 AI 助手的系统提示，让输出自动遵循规范。
适合谁
适合文档工程师、内容创作者、项目经理以及所有需要编写或审阅技术文档的开发者。尤其适用于团队统一文档风格、提升 AI 对文档的理解效率。
使用建议
建议先通读原则，再对照实际文档逐条检查。注意：该原则主要针对技术文档，不适用于创意写作、营销文案或非正式沟通。频繁更新文档时，可定期回归审查。
核心特点
本原则专门针对 LLM 友好模式设计，强调文档结构、词汇选择和上下文衔接，使 AI 能更准确地提取信息，而非仅关注人类可读性。
注意事项
不适用于创意写作、文学创作或非技术性文档。
常见问题
这个原则包含哪些具体条款？
涵盖语气（中性、客观）、语调（清晰、简洁）、结构（标题层级、段落长度）、LLM友好（使用标准术语、避免歧义、提供上下文）等。
如何将这个原则应用到AI助手中？
将原则文件作为系统提示或上下文注入，要求AI在生成文档时遵循。也可在审查时要求AI对照原则逐条检查。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/docs-style-x/raw/index.md 读取 Docs Style 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/docs-style-x/raw/index.md（查看排版版本）