qa-week
完整 QA 审读：一致性 + 技术正确性 + 学生视角四维评分；输出并收敛 QA_REPORT。
Quellinformationen
- Repository
- h-lu/statistics-agentic-coding
- Letzte Quellaktivität
- 19. Februar 2026 um 23:58
- Erkannte Sprache von SKILL.md
- Chinesisch
- Sterne
- 0
- Forks
- 0
Installationsoptionen
Standardmäßig ist der Prompt ausgewählt, der zuerst die Quelle prüft. Sie können zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prüfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich für eine Installation entscheiden.
SKILL.md wird angezeigt
SKILL.md
Quellanweisungen · Schreibgeschützte Vorschau- name
- qa-week
- description
- 完整 QA 审读：一致性 + 技术正确性 + 学生视角四维评分；输出并收敛 QA_REPORT。
- argument-hint
- <week_id e.g. week_01>
- allowed-tools
- Bash, Read, Write, Edit, Grep, Glob, Task
# /qa-week
## 用法
```
/qa-week week_XX
```
## 目标
执行完整的三维度 QA 审读，收敛到 QA_REPORT.md，并通过 release 校验：
```bash
python3 scripts/validate_week.py --week week_XX --mode release
```
## QA 流程
### Stage 1: 并行审读（一致性 + 技术正确性）
同时启动以下两个 agent（可并行）：
1. **`consistency-editor`**：
- 修复格式/术语/角色一致性
- 同步 `TERMS.yml` -> `shared/glossary.yml`
- 检查循环角色使用（对照 `shared/characters.yml`）
- 修复 `ANCHORS.yml` 问题（依赖 `validate_week.py` 报错定位）
- **可直接修改文件**
2. **`technical-reviewer`**：
- 审读概念/公式/代码/答案正确性
- 检查教学法对齐（目标/递进/示例-练习）
- 检查练习题质量（可评分/难度梯度）
- **只读，输出问题清单（含 Severity 分级）**
### Stage 2: 收集结果
- 等待 Stage 1 的两个 agent 完成
- 收集 `technical-reviewer` 的问题清单
- 确认 `consistency-editor` 的修改已生效
### Stage 3: 学生视角审读
调用 **`student-qa`**：
- **传入 technical-reviewer 发现的 S1/S2 问题摘要**
- 基于修复后的文件进行审读
- 输出四维评分（叙事流畅度/趣味性/知识覆盖/认知负荷）
- 如有 S1 错误，在"知识覆盖"维度标注扣分原因
- **只读，通过 tool result 返回评分和清单**
### Stage 4: Lead 收敛
由 Lead agent（你）执行：
1. **汇总问题清单**：
- consistency-editor 已修复的问题（无需列出）
- technical-reviewer 发现的问题（按 S1→S2→S3→S4 排序）
- student-qa 发现的问题（阻塞项 + 建议项）
2. **写入 QA_REPORT.md**：
```markdown
# QA Report: week_XX
## 四维评分
| 维度 | 分数 | 说明 |
|------|------|------|
| 叙事流畅度 | X/5 | ... |
| 趣味性 | X/5 | ... |
| 知识覆盖 | X/5 | ... |
| 认知负荷 | X/5 | ... |
| **总分** | **XX/20** | |
## 技术审读问题
### S1 致命（必须修复）
- [ ] {问题描述} — `CHAPTER.md#xxx`
### S2 重要（必须修复）
- [ ] {问题描述} — `CHAPTER.md#xxx`
### S3 一般（必须修复）
- [ ] {问题描述} — `CHAPTER.md#xxx`
### S4 润色（必须修复）
- [ ] {问题描述} — `CHAPTER.md#xxx`
## 阻塞项
- [ ] {问题描述} — {位置}
## 建议项
- [ ] {问题描述} — {位置}
## 代码与图片审核
### 代码数量
- 全章代码块：X/10
- 超标位置：[如有]
### 图片审核
- 图片数量：X 张
- 缺失/问题：[如有]
## 教学法建议
{technical-reviewer 的教学法建议}
## 审读记录
- consistency-editor: 已修复 X 处一致性问题
- technical-reviewer: 发现 X 个问题（S1: X, S2: X, S3: X, S4: X）
- student-qa: 四维评分 XX/20，代码块 X 个，图片 X 张
```
3. **如有 S1/S2/S3/S4 问题**：
- 所有 S1-S4 问题都必须修复
- S1/S2：回传 `chapter-writer` 或 `prose-polisher` 修复
- S3/S4：调用 `error-fixer` 直接修复
- 等待修复后重新运行 `/qa-week`
4. **最终 release 校验**：
```bash
python3 scripts/validate_week.py --week week_XX --mode release
```
## 通过标准
- QA_REPORT 的"阻塞项"必须清零（不允许 `- [ ]`）
- **S1-S4 所有问题必须清零**（S1/S2 阻塞，S3/S4 也必须修复）
- 四维评分总分 >= 18/20
- 代码数量不超标（每节不超过 2 个代码块，全章不超过 10 个）
## 错误处理
如果 release 校验失败：
1. 调用 `error-fixer` 逐条修复
2. 重新运行校验
3. 更新 QA_REPORT.md
Auf GitHub ansehen