Docs Style
技术文档写作原则与LLM友好模式
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Docs Style。 它的用途是：技术文档写作原则与LLM友好模式 完整的 Skill 内容见：https://321skill.com/skills/docs-style/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请用Docs Style原则检查这份API文档，并优化其中与LLM不兼容的表述。' 它会逐段分析文档的语气、术语一致性、标题层级，然后输出修改建议，例如将模糊的‘可能返回’改为明确的‘返回’，并添加示例代码块。
介绍
Docs Style 是一套用于技术文档写作的核心原则库，涵盖语气、语调、结构以及面向 LLM（大语言模型）的友好编写模式。它旨在帮助团队统一文档风格，确保文档清晰、一致且易于被 AI 工具理解和生成。
使用时，只需在编写或审阅任何文档时引用该技能，它会根据预设的写作原则自动检查文档中的语气、结构、术语一致性等问题，并给出优化建议。例如，你可以要求它“将这段文档改写成更简洁的 LLM 友好风格”或“检查当前文档是否遵循了我们的写作规范”。
适合文档工程师、内容创作者、技术写作者以及任何需要撰写或审阅技术文档的团队成员。尤其适合那些需要向 AI 模型提供高质量上下文或希望文档能被自动化工具正确解析的团队。
建议在团队内推行统一的文档风格指南时作为基础技能使用，但需注意它不适用于需要高度创意或文学性表达的场景，例如小说、诗歌或营销文案，其规则更偏向技术文档的清晰、准确和可操作性。
核心特点
与其他通用写作助手不同，Docs Style 专门针对技术文档的 LLM 友好性优化，内置了结构化提示词模式和术语一致性检查规则，能直接提升文档被 AI 模型理解和生成的质量。
注意事项
不适合需要高度创意或文学性表达的写作场景，如小说、诗歌、营销文案等。
常见问题
这个技能如何帮助我写出更符合LLM要求的文档？
它会检查你的文档是否使用了清晰简洁的句式、一致的术语、明确的层级结构，并建议添加有助于AI理解的上下文标记或示例。
我可以在哪些文档工具中使用它？
Docs Style 是独立的 AI 技能，兼容任何支持 MCP 或自定义指令的编辑器或平台，如 Cursor、Claude、VS Code（通过扩展）等。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/docs-style/raw/index.md 读取 Docs Style 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/docs-style/raw/index.md（查看排版版本）