用途
Source Tutorial Writer 用于在 source-tutorial 流程中生成最终的、以文章为先的教程交付物。它适用于已存在经批准的教程上下文包、且本次运行需要产出最终教程文章的场景。
触发词包括:source tutorial writer、tutorial drafting、教程正文、从资料写教程。
使用条件
使用时机:source-tutorial 的 C3 阶段,outline/tutorial_context_packs.jsonl 已就绪,且 DECISIONS.md 已勾选 Approve C2。
跳过条件:C2 未批准,或 context packs 还没准备好。
网络:无。
护栏:正文必须 reader-first(以读者为先),但不能写出 sources 没支持的内容。
主要能力
该技能根据已批准的模块包和锁定的 C2 结构,写出最终的教程 markdown。
输入:
- outline/tutorial_context_packs.jsonl
- outline/module_plan.yml
- DECISIONS.md
输出:
- output/TUTORIAL.md
契约要求
教程必须:
- 以读者定位(reader orientation)开头
- 遵循已批准的模块顺序
- 保持每个模块的教学小节明确
- 保持来源注释可见但轻量
每个模块应输出以下小节:
-
Why it matters
-
Key idea
-
Worked example
-
Check yourself
-
Source notes
脚本边界
scripts/run.py 应当:
- 在缺少 Approve C2 时阻塞
- 按已批准顺序加载模块包
- 将确定性的教程脚手架/内容渲染到 output/TUTORIAL.md
渲染和包解释应保留在共享的教程工具中,而不是放在 wrapper 里。
验收标准
- output/TUTORIAL.md 存在
- 必需的读者定位小节存在
- 每个模块都包含必需的教学子小节
非目标
- 自循环 QA 报告
- 文章/幻灯片编译
限制
该技能不联网。关于收费、价格、平台支持范围等信息,资料中暂未提供。