tutorial-module-writer
从批准的模块计划中编写教程内容(`output/TUTORIAL.md`),包括练习和答案大纲。**触发跑**:写教程,教程模块,教程写作,TUTORIAL.md。**使用时间**:教程管道的写作阶段(C3),且`DECISIONS.md`已记录HUMAN对范围/运行示例的批准(C2)。**如果**跳过:模块计划未完成/未批准(先) `module-planner`/`exercise-builder` 并通过 Approve C2)。**Network**: none.**Guardrail**: 只写已批准范围;保持运行示例一致;每个模块包含练习和答案要点。
📖 中文导读:从批准的模块计划中编写教程内容(`output/TUTORIAL.md`),包括练习和答案大纲。**触发跑**:写教程,教程模块,教程写作,TUTORIAL.md。**使用时间**:教程管道的写作阶段(C3),且`DECISIONS.md`已记录HUMAN对范围/运行示例的批准(C2)。**如果**跳过:模块计划未完成/未批准(先) `module-planner`/`exercise-builder` 并通过 Approve C2)。**Network**: none.**Guardrail**: 只写已批准范围;保持运行示例一致;每个模块包含练习和答案要点。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: tutorial-module-writer
description: |
Write the tutorial content (output/TUTORIAL.md) from an approved module plan, including exercises and answer outlines.
Trigger: write tutorial, tutorial modules, 教程写作, TUTORIAL.md.
Use when: tutorial pipeline 的写作阶段(C3),且 DECISIONS.md 已记录 HUMAN 对 scope/running example 的批准(C2)。
Skip if: module plan 未完成/未批准(先跑 module-planner/exercise-builder 并通过 Approve C2)。
Network: none.
Guardrail: 只写已批准范围;保持 running example 一致;每模块包含练习与答案要点。
Tutorial Module Writer
Goal: write the tutorial as a coherent module sequence with a consistent running example and verifiable exercises.
Inputs
Required:
outline/module_plan.ymlDECISIONS.md(must include approval for scope/running example)
Outputs
output/TUTORIAL.md
Workflow
Confirm approval
- Check
DECISIONS.mdhas the required approval (typicallyApprove C2). - If approval is missing, stop and request sign-off.
- Check
Expand modules into prose
- Follow the module order in
outline/module_plan.yml. - Keep the running example consistent across modules.
- Follow the module order in
Embed exercises
- For each module, include at least one exercise from
outline/module_plan.yml. - Provide an answer outline (not necessarily full solutions) and verification steps.
- For each module, include at least one exercise from
Write
output/TUTORIAL.md- Prefer short sections and concrete steps.
- Avoid scope drift beyond the spec and approved plan.
Definition of Done
-
output/TUTORIAL.mdcovers all approved modules in order. - Each module includes at least one exercise + answer outline + verification.
- Running example remains consistent.
Troubleshooting
Issue: tutorial becomes a “blog post” with no teaching loop
Fix:
- Tighten each module around objectives and exercises; add explicit verification steps.
Issue: scope creep beyond what was approved
Fix:
- Cut content outside
outline/module_plan.ymland document new scope ideas for a separate iteration.