| name | doc-quality-judge |
| description | LLM-as-Judge 文档质量评估 Skill。利用大模型对 PRD 和架构文档进行深层语义质量评估，超越结构 Lint 检测「写了但写得不好」的问题。触发条件：(1) 文档质量评估/评审，(2) LLM-as-Judge，(3) PRD 语义审查，(4) 架构文档深度评审，(5) doc-quality-judge，(6) 文档语义评分。 |
LLM-as-Judge 文档质量评估
利用大模型对 PRD 和架构文档进行深层语义质量评估。与 doc-lint 互补：doc-lint 检查结构完整性（写了没有），本 Skill 评估内容质量（写得好不好）。
适用场景
- Gate Review 前对文档质量做深度预评
- 识别「结构 Lint 通过但内容空洞」的问题
- 为 pm_workflow_evaluator Dim5 需求质量信号提供 LLM 评分
评估维度
PRD 质量评估
| 维度 | 权重 | 评估要点 |
|---|
| 目标清晰度 | 20% | 背景与目标是否明确、可衡量（SMART） |
| 用户故事质量 | 20% | Persona 是否具体、AC 是否可测试 |
| 需求完整性 | 20% | 功能列表无遗漏、非功能需求有量化指标 |
| 优先级合理性 | 15% | RICE 评分是否与业务价值一致 |
| 可追溯性 | 15% | 需求→模块→架构→Issue 链路清晰 |
| 一致性 | 10% | 术语、版本号、状态在各文档间一致 |
架构质量评估
| 维度 | 权重 | 评估要点 |
|---|
| 技术选型合理性 | 20% | 选型理由充分、与业务规模匹配 |
| 架构完整性 | 20% | 系统图覆盖所有组件、无孤岛模块 |
| 数据模型质量 | 20% | ER 图规范、字段类型明确、索引策略 |
| API 设计质量 | 15% | RESTful 规范、错误码完整、版本策略 |
| 安全设计 | 15% | 认证授权方案、数据保护、审计日志 |
| 运维友好度 | 10% | 监控方案、部署策略、容灾设计 |
评估流程
步骤 1：准备
node .github/skills/doc-lint/scripts/prd-lint.js <project>
node .github/skills/doc-lint/scripts/arch-lint.js <project>
步骤 2：LLM 评估
Agent 读取以下文件进行评估：
- 目标文档：
prd-{project}.md 或 architecture-{project}.md
- Lint 结果：
gate-results/prd-lint-*.json 或 gate-results/arch-lint-*.json
- RTM：
gate-results/rtm-*.json（如已生成）
- Module PRDs：
modules/prd-*.md（如存在）
步骤 3：输出评估报告
输出到 projects/prd-{PROJECT}/gate-results/quality-judge-{date}.md，格式：
# 文档质量评估报告 — {project}
> **评估日期**：{date}
> **评估类型**：PRD / 架构 / 全量
> **总分**：{score}/100
## 维度评分
| 维度 | 权重 | 得分 | 等级 | 关键发现 |
|------|------|------|------|---------|
| ... | ... | .../10 | A/B/C/D | ... |
## 关键发现
### 🔴 阻断问题 (必须修复)
1. ...
### 🟡 改进建议 (强烈建议)
1. ...
### 🟢 优化建议 (可选)
1. ...
## 与结构 Lint 结果对比
| 检查类型 | 结果 | 说明 |
|----------|------|------|
| prd-lint | X pass / Y warn / Z fail | ... |
| LLM 评估 | 总分 N/100 | ... |
| 差异 | Lint 通过但语义不足的项 | ... |
评分标准
| 等级 | 分数范围 | 含义 |
|---|
| A | 90-100 | 优秀，可直接提交 Gate |
| B | 75-89 | 良好，少量改进后可提交 |
| C | 60-74 | 合格，需明确改进计划 |
| D | <60 | 不合格，需重大修改 |
约束
- 评估基于文档文本，不执行代码或运行测试
- 每次评估应记录 LLM 模型和版本
- 评分应附带具体引用和证据
- 同一文档连续评估结果应可比较
与其他 Skill/Agent 关系
| 工具 | 关系 |
|---|
doc-lint | 互补 — doc-lint 检查结构，本 Skill 评估语义 |
gate_review | 前置 — 本 Skill 结果作为 Gate Review 参考输入 |
pm_workflow_evaluator | 数据源 — Dim5 需求质量信号引用评分 |
code-review | 平行 — 代码审查 Skill，本 Skill 聚焦文档审查 |
