Informations de source
- Dépôt
- h-lu/python-agentic-textbook
- Dernière activité de la source
- 10 mai 2026 à 14:03
- Langue détectée de SKILL.md
- chinois
- Étoiles
- 0
- Forks
- 0
Options d'installation
Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.
Vérifiez les fichiers source
Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.
Affichage de SKILL.md
SKILL.md
Instructions source · Aperçu en lecture seule- 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`：
```markdown
# 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 级验证：
```bash
python3 scripts/validate_week.py --week week_XX --mode release
```
## 发布条件
| 条件 | 要求 |
|------|------|
| 一致性 | 全部通过 |
| S1 问题 | **必须清零** |
| S2 问题 | **必须清零** |
| S3 问题 | **必须清零** |
| S4 问题 | **必须清零** |
| 四维总分 | >= 18/20 |
| 校验脚本 | `--mode release` 通过 |
Voir sur GitHub