用途:在正式撰写教程前锁定范围与教学意图,使后续规划可确定化,避免范围蔓延和内容漂移。
主要能力:明确受众与前置条件;编写可测量的学习目标(如 implement、debug、evaluate、explain 等动词);定义显式非目标(out of scope);选取一个简单但非平凡、可贯穿全教程的运行示例;规定交付形式(Markdown/LaTeX、代码语言、大致长度)。每个条目今后都应能通过练习验证。
输入与输出:必需输入 STATUS.md(上下文与约束);可选输入 GOAL.md(主题措辞)、DECISIONS.md(预先约定的约束,视为权威)。输出为 output/TUTORIAL_SPEC.md,推荐模板包含受众、前置条件、3–8 条可测量学习目标、非目标、运行示例、交付格式。
使用方式:从 STATUS.md 提取时间、深度、语言、受众等约束;若存在 DECISIONS.md 以其为准;若存在 GOAL.md 则复用其主题措辞与示例以保持一致;提出能支撑完整教程的运行示例;按模板写出规格文件;确保每条学习目标可测量、可由后续练习验证。
适用场景:教程或教学单元的内容规划阶段,与课程设计、写作流程衔接。
限制:资料未提供具体收费、价格、平台、运行环境要求或安装命令;示例中未给出完整代码。完成标准为 output/TUTORIAL_SPEC.md 存在且结构清晰、运行示例具体一致、目标可测量并匹配受众。常见问题处理:目标含糊时改写为可观察结果;运行示例过大时缩减为仍覆盖核心概念的最小端到端场景。