Datos de origen
- Repositorio
- h-lu/statistics-agentic-coding
- Última actividad en el origen
- 19 de febrero de 2026 a las 23:58
- Idioma detectado de SKILL.md
- chino
- Estrellas
- 0
- Forks
- 0
Opciones de instalación
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Revisa los archivos de origen
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Mostrando SKILL.md
SKILL.md
Instrucciones de origen · Vista previa de solo lectura- 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
Ver en GitHub