con un clic
team-week
完整执行一周章包的 6 阶段流水线:规划 → 写作 → 润色 → 并行产出 → QA → 收敛发布。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Menú
完整执行一周章包的 6 阶段流水线:规划 → 写作 → 润色 → 并行产出 → QA → 收敛发布。
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Basado en la clasificación ocupacional SOC
生成本周正文:规划(含 Bloom/回顾桥/超级线/角色)→ 场景驱动写正文 → 深度润色 → 四维 QA → 修订回路 → 落盘 QA_REPORT。
对指定 week 的 CHAPTER.md 做深度改写——消灭模板感、补贯穿案例、重组结构,使其达到教材水准。
需要确保 8 周内容在术语、目录、标题与校验标准上保持一致时,运行全书级校验(跨周一致性)。
质量审查:术语/锚点/格式/角色一致性 + 四维学生视角 QA;输出并收敛 QA_REPORT。
当需要一次性生成 week_01..week_08 的章包目录与模板(不写正文内容)时,批量调用 new_week 脚手架。
| 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/ + StatLab 示例代码 + 讲解段落test-designer:产出 tests/ pytest 用例矩阵exercise-factory:产出 ASSIGNMENT.md + RUBRIC.md + AI 协作练习校验(三个全部完成后执行):
python3 scripts/validate_week.py --week week_XX --mode idle
调用 subagent student-qa:
重要:student-qa 是只读角色(tools: [Read, Grep, Glob],无 Write 权限),不要让它写 QA_REPORT.md。它应该通过返回消息输出评分和清单。
校验:无(QA 是只读角色)
| 总分范围 | 处理方式 | 回传给谁 |
|---|---|---|
| >= 18 | 根据 QA 反馈进行轻量修订后通过 | prose-polisher(轻量修复,处理建议项) |
| < 18 | 结构性重写(需大幅改进) | chapter-writer |
修订规则说明:
<!-- 需人工介入 -->一致性处理(由 Lead agent 直接执行,不再调用独立 subagent):
在最终 release 前,Lead agent 直接执行以下一致性检查:
TERMS.yml → shared/glossary.yml,如有缺失则同步shared/characters.yml 人设落盘 QA_REPORT(由 Lead agent 直接写入):
chapters/week_XX/QA_REPORT.md
## 阻塞项 下(checkbox,必须全部勾选)## 建议项 下(checkbox)注意:QA_REPORT.md 是在阶段 6b 由 Lead agent 写入的,不是在阶段 5 由 student-qa 写入的。student-qa 只返回评分和清单,不操作文件。
调用 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-5(产出/QA) | --mode idle | 所有文件 + QA 阻塞项检查,无 pytest |
| 阶段 6(收敛) | --mode release | 完整发布级校验(含 pytest + pedagogical 检查) |
- [ ])才能 release