AgentSkillsCN

feature-doc-review

审阅功能/组件文档,确保其符合仓库规范。

SKILL.md
--- frontmatter
name: feature-doc-review
description: Review a feature/component documentation to check that it adheres to repo standards.

Feature Review

Prerquisites

  • markdownlint is installed and can be called via npx markdownlint-cli

When to use this skill

Use this skill when the user wants to check whether documentation fits required criteria.

Process inputs

  • An existing document
  • Optionally, a focus to review, such as a particular section or aspect

Process outputs

  • A report on the document's adherence to guidelines
  • Suggested edits to make a document more compliant

How to review the feature document

  • Read the provided document
  • Check for stylistic consistency, grammar, plain English and legibility
  • Check for relevance to the subject matter
  • Check for correctness compared to current implementation / goals
  • Check for adherence to the checklist
  • Check for adherence to the template
  • Use npx markdownlint-cli **/*.md to check for and report markdown errors
  • Use check-doc-links.ps1 to check for bad links