SuperAPI AI 工具集

source-tutorial-writer

写作与研究

查看项目

更新于 10-16 04:45

技能介绍

用途

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 报告
  • 文章/幻灯片编译

限制

该技能不联网。关于收费、价格、平台支持范围等信息,资料中暂未提供。