用途:该技能为 Docusaurus 文档站点提供有明确主张的写作与结构指导,适用于创建、重构或改进文档。核心是 Diátaxis 框架,写作前先判断内容属于哪一类:教程(学习)、操作指南(完成任务)、参考(查阅信息)、解释(理解原因),并避免在同一页面混用。
主要能力:给出 docs/ 目录的推荐组织方式,如 getting-started、guides、concepts、reference、resources;要求每篇文档包含 title 与 description 的 frontmatter;对四类文档分别给出写作规则,例如教程只保留一条路径、操作指南标题用“How to [动词] [事物]”、参考镜像代码结构、解释回答“为什么”。还提供交互元素(Tabs、details)、admonition 层级(tip、note、warning、danger)以及包容性用语替换建议。
使用方式:向该技能说明要构建什么文档、读者是谁、读完后应能做什么,它会追问受众、目标、所属象限与前置知识,再据此产出内容。实现细节可参考其列出的 references/diataxis-patterns.md、references/writing-guide.md、references/config-reference.md、references/deployment.md。
适用场景:Docusaurus 文档站点的规划、重写与质量提升,尤其是需要区分学习、任务、查阅与理解四类内容的团队。
限制:资料未提供具体安装命令、版本要求、收费或价格信息;该技能明确不生成缺少受众理解的文档、不混用文档类型、不使用“simple/easy”等措辞、不跳过 frontmatter description、不创建超过三级的侧边栏。