AgentSkillsCN

document-quality

多维度审查 Markdown 文档质量，覆盖结构、内容、格式、引用、元数据五大维度。当需要评审文档质量、统一格式规范、验收交付文档时使用。提供分级检查清单、通过标准、常见问题修复指南，支持从快速检查到深度审计的多层次需求。

中文原作
SKILL.md
--- frontmatter
name: document-quality
description: 多维度审查 Markdown 文档质量，覆盖结构、内容、格式、引用、元数据五大维度。当需要评审文档质量、统一格式规范、验收交付文档时使用。提供分级检查清单、通过标准、常见问题修复指南，支持从快速检查到深度审计的多层次需求。
stage: COMMON
level_supported: [L1-STREAMLINED, L2-BALANCED, L3-RIGOROUS]

Document Quality Skill

Scope: COMMON（全阶段通用）

版本: 0.1.0（占位）| 创建日期: 2025-11-27

概述

多维度文档质量检查：

  • •结构维度: 标题层级、章节完整性
  • •内容维度: 清晰度、准确性、一致性
  • •格式维度: Markdown 规范、表格对齐
  • •引用维度: 链接有效性、交叉引用完整
  • •元数据维度: 版本号、日期、作者

L1-STREAMLINED

检查清单

  • • 标题层级正确（H1 唯一，H2-H4 递进）
  • • 无孤立链接（所有引用可访问）
  • • 版本号和日期存在
  • • 无明显拼写错误

通过标准

  • •4 项中 3 项通过（≥75%）

L2-BALANCED

检查清单（包含 L1）

  • • L1 全部检查项
  • • 表格格式对齐
  • • 代码块有语言标注
  • • 段落长度适中（无超长段落）
  • • 术语使用一致

通过标准

  • •9 项中 8 项通过（≥90%）

L3-RIGOROUS

检查清单（包含 L1/L2）

  • • L1/L2 全部检查项
  • • 交叉引用完整（双向链接）
  • • 无重复内容（DRY 原则）
  • • 可访问性（图片有 alt text）
  • • 国际化考虑（中英文混排规范）
  • • SEO 友好（标题含关键词）

通过标准

  • •15 项中 14 项通过（≥95%）

>> 命令

code
>>doc_check_l1         # L1 快速检查
>>doc_check_l2         # L2 标准检查
>>doc_check_l3         # L3 严格检查
>>doc_fix              # 自动修复常见问题

相关 Skills

  • •原则: principle-dry（文档避免重复）
  • •应用: draft-finalize（需求文档定稿前检查）
  • •应用: all design SKILLs（设计文档质量检查）
  • •所有阶段: 通用文档质量门

TODO: 待细化检查规则和自动修复脚本