qa-week

name	qa-week
description	三维度质量审查：一致性 + 技术正确性 + 学生视角 QA；输出并收敛 QA_REPORT。
argument-hint	<week_id e.g. week_01>
allowed-tools	Bash, Read, Write, Edit, Grep, Glob, Task
disable-model-invocation	true

/qa-week

用法

/qa-week week_XX

目标

执行三维度 QA，确保章包在发布前通过以下检查：

1. 一致性：术语/锚点/格式/角色对齐
2. 技术正确性：概念/代码/答案正确 + 教学法对齐
3. 学生视角：叙事流畅/有趣/可理解

步骤

Stage 1: 并行审读（可同时执行）

1a. 调用 consistency-editor：

• 对齐 shared/style_guide.md
• 同步 TERMS.yml -> shared/glossary.yml
• 检查循环角色使用一致性（对照 shared/characters.yml）
• 修复 ANCHORS.yml 问题（依赖 validate_week.py 报错定位）
• consistency-editor 内部会跑 validate_week.py --mode idle

1b. 调用 technical-reviewer（与 consistency-editor 并行）：

• 审读 CHAPTER.md：概念定义准确性、代码示例正确性
• 审读 examples/：Python 代码规范（PEP 8）、边界情况处理
• 审读 ASSIGNMENT.md + RUBRIC.md：题意清晰度、评分覆盖
• 审读 starter_code/solution.py：答案正确性
• 输出问题清单（按 S1-S4 严重级别分类）

Stage 2: 学生视角 QA

调用 student-qa：

• 四维评分（叙事流畅度/趣味性/知识覆盖/认知负荷，各 1-5 分）
• 总分 >= 18/20 才能 release
• 任一维度 <= 2 视为阻塞项

Stage 3: 收敛 QA_REPORT

把三维度 QA 结果收敛到 QA_REPORT.md：

# QA Report: week_XX

## 总体状态
- [ ] 一致性检查通过
- [ ] 技术审读通过（S1-S4 问题已清零）
- [ ] 学生视角评分 >= 18/20

## 四维评分
| 维度 | 分数 | 说明 |
|------|------|------|
| 叙事流畅度 | X/5 | ... |
| 趣味性 | X/5 | ... |
| 知识覆盖 | X/5 | ... |
| 认知负荷 | X/5 | ... |
| **总分** | **X/20** | |

## 技术审读问题

### S1 致命问题（必须修复）
- [ ] {问题描述}

### S2 重要问题（强烈建议修复）
- [ ] {问题描述}

### S3 一般问题（建议修复）
- [ ] {问题描述}

## 一致性问题
- [ ] {问题描述}

## 学生视角阻塞项
- [ ] {问题描述}

## 建议项
- [ ] {改进建议}

Stage 4: Release 验证

最终 release 级验证：

python3 scripts/validate_week.py --week week_XX --mode release

发布条件

条件	要求
一致性	全部通过
S1 问题	必须清零
S2 问题	必须清零
S3 问题	必须清零
S4 问题	必须清零
四维总分	>= 18/20
校验脚本	--mode release 通过