# Quality Scorer

> Use when the user needs a computed document quality score or a weighted scoring breakdown.

- Skill: `morning-start/quality-scorer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add morning-start/quality-scorer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/morning-start/quality-scorer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: morning-start (https://skillmd.com/u/morning-start)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/morning-start/quality-scorer

---


# Quality Scorer

## 职责

- 汇总一致性、完整性检查结果
- 按权重计算综合质量分数
- 判断是否通过质量门禁
- 输出详细评分报告

## 输入

- consistency_result
- completeness_result

## 输出

```yaml
quality_score:
  overall: 0.87
  breakdown:
    format: 1.00       # 格式规范（10%）
    consistency: 0.92  # 一致性（25%）
    completeness: 0.85 # 完整性（25%）
    traceability: 0.88 # 追溯完整性（20%）
    diagram: 0.80      # 图示覆盖（20%）
  status: pass
  threshold: 0.80
  details:
    total_issues: 3
    errors: 0
    warnings: 2
    info: 1
```

## 评分权重

| 维度 | 权重 | 说明 |
|------|------|------|
| 格式规范 | 10% | YAML front matter、标题层级 |
| 一致性 | 25% | 术语、格式、数据一致 |
| 完整性 | 25% | 章节、示例完整 |
| 追溯完整性 | 20% | depends_on/feeds_into 双向对应 |
| 图示覆盖 | 20% | 复杂文档有图示 |

## 评分计算

```
overall = format * 0.10 + consistency * 0.25 + completeness * 0.25 + traceability * 0.20 + diagram * 0.20
```

## 状态判定

| overall | status | 处理 |
|---------|--------|------|
| ≥ 0.90 | pass | 通过 |
| 0.80 - 0.89 | pass | 通过，有建议 |
| 0.70 - 0.79 | warning | 标注警告 |
| < 0.70 | fail | 不通过 |

## 注意事项

- 任何 error 级别问题自动将状态设为 fail
- 评分必须精确到两位小数
- 必须输出详细 breakdown 供改进参考