AgentSkillsCN

docs-review

审查文档的语气、风格与结构,确保其符合 Outfitter 的标准。在审查文档或检查内容质量时,应运用此技能。

SKILL.md
--- frontmatter
name: docs-review
description: "Reviews documentation for voice, style, and structure alignment with Outfitter standards. Use when reviewing docs or checking content quality."
context: fork
agent: editor
metadata:
  version: "1.1.0"
  author: outfitter
  category: documentation

Documentation Review

Review the current document against Outfitter standards for voice, style, and structure.

Steps

  1. Skills: Load the following skills: team:voice, team:styleguide, team:docs-check. If you cannot, do not proceed, but report this.
  2. Direction: $ARGUMENTS — If provided, focus on that aspect. Otherwise, review all dimensions.
  3. Voice: Verify Outfitter voice (see team:voice skill): confident stance, agent-first framing, plain language over jargon.
  4. Style: Verify craft patterns (see team:styleguide skill): punch-and-flow rhythm, earned enthusiasm, strong opening and closing.
  5. Structure: Verify documentation patterns (see team:docs-check skill): appropriate template, runnable examples, correct heading hierarchy.
  6. Report: Provide a detailed report of your findings based on the template below.
    • NOTE: If the document is ready, say so briefly. If it needs work, be specific about locations and fixes.

Template

Use the report structure in TEMPLATE.md.