OpenParable
Skip to content
← Back to skills

Document Quality

Documents
document-quality

Document Quality is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/data/document-quality/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/document-quality, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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%）

>> 命令

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

相关 Skills

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

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