Menu
完整执行一周章包的 6 阶段流水线：规划 → 写作 → 润色 → 并行产出 → 三维度QA → 收敛发布。
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Basé sur la classification professionnelle SOC
对指定 week 的 CHAPTER.md 做深度改写——消灭模板感、补贯穿案例、重组结构，使其达到教材水准。
三维度质量审查：一致性 + 技术正确性 + 学生视角 QA；输出并收敛 QA_REPORT。
生成本周正文：规划（含 Bloom/回顾桥/超级线/角色）→ 场景驱动写正文 → 深度润色 → 四维 QA → 修订回路 → 落盘 QA_REPORT。
生成作业 + rubric + tests 草案，并产出最小示例与反例。
初始化一个 week_XX 章包目录与模板，并更新 TOC/current_week。
需要确保 14 周内容在术语、目录、标题与校验标准上保持一致时，运行全书级校验（跨周一致性）。
| name | team-week |
| description | 完整执行一周章包的 6 阶段流水线：规划 → 写作 → 润色 → 并行产出 → 三维度QA → 收敛发布。 |
| argument-hint | <week_id e.g. week_01> |
| allowed-tools | Bash, Read, Write, Edit, Grep, Glob, Task |
/team-week week_XX
直接执行完整的 6 阶段流水线，把 week_XX 从零产出为完整章包，并通过 release 校验：
python3 scripts/validate_week.py --week week_XX --mode release
CLAUDE.md + shared/style_guide.mdshared/writing_exemplars.md + shared/characters.yml.research_cache.md，prose-polisher 优先读取缓存，不足时用自身的 WebSearch 补充搜索。绝对禁止编造参考链接——搜索失败时写 <!-- TODO --> 占位shared/style_guide.md）阶段 0（日期校准） → 阶段 1（规划） → 阶段 2（写作） → 阶段 2.5（联网研究）
→ 阶段 3（润色） → 阶段 4（并行产出） → 阶段 5（三维度QA） → 阶段 6（收敛）
生成 shared/current_date.txt，供后续所有 agent 读取当前日期：
date '+%Y-%m-%d' > shared/current_date.txt
echo "当前日期已写入 shared/current_date.txt: $(cat shared/current_date.txt)"
为什么需要这一步：时代脉搏、AI 小专栏、参考链接的访问日期都需要使用当前年份。如果不显式注入日期，agent 可能使用训练数据中的旧年份。
校验：确认 shared/current_date.txt 存在且内容为当天日期。
调用 subagent syllabus-planner：
chapters/week_XX/CHAPTER.md（大纲阶段）<!-- ... --> HTML 注释包裹（Bloom 标注、概念预算表、AI 专栏规划、角色出场规划、章节结构骨架等，不能渲染为正文）校验：无需校验（规划阶段，ASSIGNMENT 等文件不存在是正常的）
在写正文之前，使用 Context7 MCP 查证本章涉及的 Python 官方文档和 API 最佳实践：
resolve-library-id 定位相关库（如 python、pytest、argparse 等）query-docs 查询具体的最佳实践和 API 用法搜索工具分工说明：
mcp__exa__get_code_context_exa)：用于搜索真实项目中的代码示例和社区实践校验：无需校验
调用 subagent chapter-writer：
shared/writing_exemplars.md + shared/characters.ymlshared/style_guide.md 的"章首导入"章节<!-- ... --> 注释包裹，不能出现在渲染正文中校验：
python3 scripts/validate_week.py --week week_XX --mode drafting
由 Lead agent 直接执行（不委派给 subagent），因为 Lead 拥有全部搜索工具。
目的：为阶段 3 的 prose-polisher 提供真实的搜索数据和参考链接，避免 AI 小专栏使用 TODO 占位。
读取阶段 1 的 AI 小专栏规划：从 CHAPTER.md 的 HTML 注释中提取 2 个侧栏的主题和建议搜索词
读取 shared/current_date.txt 获取当前日期，搜索关键词中包含当前年份
执行搜索（每个侧栏 2-3 次搜索）：
# 优先级 1: 内置 WebSearch（最可靠，无外部依赖）
WebSearch("GitHub Copilot adoption statistics 2026")
WebSearch("Python popularity TIOBE index 2026")
# 优先级 2: Exa MCP（AI 增强搜索，适合深度研究）
mcp__exa__web_search_exa({
"query": "GitHub Copilot adoption statistics 2026",
"numResults": 5,
"type": "auto"
})
mcp__exa__company_research_exa({
"companyName": "OpenAI",
"numResults": 3
})
# 优先级 3: perplexity MCP（如可用）
mcp__perplexity__perplexity_search({
"query": "vibe coding trend AI programming 2026",
"recency": "year",
"response_format": "json"
})
收集时代脉搏素材：搜索与本章主题相关的最新 AI/技术事件
将搜索结果写入缓存文件 chapters/week_XX/.research_cache.md：
# Week XX 研究缓存
生成日期：YYYY-MM-DD
## 时代脉搏素材
### 搜索词: "..."
- 事实: ... (来源: https://真实URL)
## AI 小专栏 #1: {主题}
### 搜索词: "..."
- 数据点: ... (来源: https://真实URL)
- 引用: "..." (来源: https://真实URL)
## AI 小专栏 #2: {主题}
### 搜索词: "..."
- 数据点: ... (来源: https://真实URL)
校验：确认 .research_cache.md 存在且至少包含 2 个侧栏的搜索数据。
调用 subagent prose-polisher：
shared/writing_exemplars.md + shared/characters.ymlshared/characters.yml）chapters/week_XX/.research_cache.md 中的搜索数据和参考链接<!-- TODO --> 占位校验：
python3 scripts/validate_week.py --week week_XX --mode drafting
同时调用以下 3 个 subagent（可以并行）：
example-engineer：产出 examples/ + PyHelper 示例代码 + 讲解段落test-designer：产出 tests/ pytest 用例矩阵exercise-factory：产出 ASSIGNMENT.md + RUBRIC.md + AI 协作练习校验（三个全部完成后执行）：
python3 scripts/validate_week.py --week week_XX --mode idle
执行三维度质量审查，确保章包在发布前通过所有检查。
调用 consistency-editor：
shared/style_guide.mdTERMS.yml -> shared/glossary.ymlshared/characters.yml）ANCHORS.yml 问题validate_week.py --mode idle调用 technical-reviewer（与 consistency-editor 并行）：
CHAPTER.md：概念定义准确性、代码示例正确性examples/：Python 代码规范（PEP 8）、边界情况处理ASSIGNMENT.md + RUBRIC.md：题意清晰度、评分覆盖starter_code/solution.py：答案正确性调用 student-qa：
重要：student-qa 是只读角色（tools: [Read, Grep, Glob]，无 Write 权限），不要让它写 QA_REPORT.md。它应该通过返回消息输出评分和清单。
校验：无（QA 是只读角色）
根据三维度 QA 结果执行修订：
| 问题类型 | 处理方式 | 回传给谁 |
|---|---|---|
| S1 致命问题 | 必须修复 | error-fixer 或相关 subagent |
| S2 重要问题 | 必须修复 | prose-polisher |
| S3 一般问题 | 必须修复 | prose-polisher |
| S4 润色问题 | 必须修复 | prose-polisher |
| 四维总分 < 18 | 结构性重写 | chapter-writer |
| 四维总分 >= 18 | 轻量修订 | prose-polisher |
修订规则：
<!-- 需人工介入 -->一致性处理（由 Lead agent 直接执行）：
TERMS.yml → shared/glossary.yml，如有缺失则同步shared/characters.yml 人设落盘 QA_REPORT（由 Lead agent 直接写入）：
# QA Report: week_XX
## 总体状态
- [ ] 一致性检查通过
- [ ] 技术审读通过（S1-S4 问题已清零）
- [ ] 学生视角评分 >= 18/20
## 四维评分
| 维度 | 分数 | 说明 |
|------|------|------|
| 叙事流畅度 | X/5 | ... |
| 趣味性 | X/5 | ... |
| 知识覆盖 | X/5 | ... |
| 认知负荷 | X/5 | ... |
| **总分** | **X/20** | |
## 技术审读问题
### S1 致命问题（必须修复）
- [x] {已修复的问题}
### S2 重要问题（强烈建议修复）
- [x] {已修复的问题}
## 一致性问题
- [x] {已修复的问题}
## 学生视角阻塞项
- [x] {已修复的问题}
## 建议项
- [ ] {可选改进建议}
注意：QA_REPORT.md 是在阶段 6b 由 Lead agent 写入的，不是在阶段 5 由各 QA subagent 写入的。
调用 subagent error-fixer（如果校验有报错）：逐条修复再验证
最终 release 校验：
python3 scripts/validate_week.py --week week_XX --mode release
| 阶段 | 校验模式 | 说明 |
|---|---|---|
| 阶段 1（规划） | 无 | ASSIGNMENT 等文件不存在是正常的 |
| 阶段 2-3（写作/润色） | --mode drafting | 只检查 CHAPTER.md + TERMS.yml（如果存在） |
| 阶段 4（产出） | --mode idle | 所有文件检查，无 pytest |
| 阶段 5（QA） | 无 | QA 是只读角色 |
| 阶段 6（收敛） | --mode release | 完整发布级校验（含 pytest + pedagogical 检查） |
- [ ]）才能 release