name: polish-week
description: 对指定 week 的 CHAPTER.md 做深度改写——消灭模板感、补贯穿案例、重组结构,使其达到教材水准。
argument-hint: ""
allowed-tools: Bash, Read, Write, Edit, Grep, Glob
disable-model-invocation: true
/polish-week
用法
/polish-week week_XX
目标
chapters/week_XX/CHAPTER.md达到教材水准:叙事流畅、有贯穿案例、节奏多变、有温度- 可做结构性改写(不仅仅是换词润色)
- 追加 1-2 个"AI 时代小专栏"(200-500 字/个),附真实参考链接 + 访问日期(优先读取
.research_cache.md研究缓存,不足时使用 WebSearch / Exa MCP / perplexity MCP 搜索获取真实 URL,绝对禁止编造) - 不改代码/测试/YAML,不引入新的
validate_week.py失败
步骤
0. 日期校准(立即执行)
生成 shared/current_date.txt,供后续 agent 读取当前日期:
date '+%Y-%m-%d' > shared/current_date.txt
这确保 AI 小专栏中的数据和访问日期使用当前年份。
1. 诊断
调用 subagent student-qa(只读模式):
- 必须先读
shared/writing_exemplars.md - 输出叙事质量评分 + 阻塞项/建议项
- 如果评分 >= 4 且无阻塞项,可跳到步骤 3(轻润色即可)
2. 深度改写
调用 subagent prose-polisher:
- 必须先读
shared/writing_exemplars.md - 根据 student-qa 的诊断结果,执行对应级别的改写
- 如果缺贯穿案例,补入一条
- 如果结构过于机械,重组
3. 一致性检查(可选)
调用 subagent consistency-editor:做格式/术语/引用一致性检查(避免重写内容)
4. 验证
python3 scripts/validate_week.py --week week_XX --mode idle
如果你准备发布(并且已清空 QA 阻塞项),再跑:
python3 scripts/validate_week.py --week week_XX --mode release