用途:审查 .md 文件、技能文档(SKILL.md)、规则、AGENTS.md 等说明性文档,判断其是否易读、是否符合质量预期,并在合并或发布前给出修改建议。其写作标准细节来自 writing-documentation,本技能把标准转化为可执行的评审流程。
主要能力:按文档类型套用相应预期(如技能文档需要 frontmatter 与渐进式披露);通读全文或用户指定的改动片段,记录受众与目的;按清单检查核心原则(清晰、简洁、结构、一致)、写作风格(主动语态、现在时、第三人称、术语处理、可扫读性、可执行性)与 Markdown 格式(标题层级、列表、代码围栏、行内代码与路径反引号、块级元素间空行)。对全新文档,若未见用户模板或约定大纲,会提示;对技能文档检查 YAML frontmatter 是否含非空且利于发现的 name 与 description,正文是否聚焦、深层细节是否外链到 reference.md / examples.md;对规则与 AI 文档检查格式、指令范围与可执行性、是否存在无层级的矛盾条目。
使用方式:按评审工作流执行——识别文档类型、通读全文或改动范围、运行清单并引用具体位置(标题、条目或短引用)、按固定输出格式反馈。输出结构为 Summary、Strengths、Issues(Must fix / Should fix / Consider)、Suggested next steps;严重级别为指引:Must fix 影响正确性或标准,Should fix 实质提升质量,Consider 为可选润色。
适用场景:评审文档、文档 PR、回答文档是否达标、合并或发布前建议修改;对仅改动一节的 PR,只审查改动行及与周边章节的一致性。
限制:资料未提供具体安装命令、平台支持、收费与价格信息;未提供完整代码示例;实际效果取决于项目自身写作标准与评审者判断。