SuperAPI AI 工具集

tutorial-context-pack

写作与研究

查看项目

更新于 10-16 04:39

技能介绍

用途

Tutorial Context Pack 用于教程写作流水线中的上下文准备阶段。当模块规划(module planning)与来源覆盖(source coverage)已经完成,且整个运行流程需要为每个模块产出可交给写作者(writer-ready)的上下文包时,使用该技能。

触发与路由

触发词:tutorial context pack、module pack、writer pack、教程上下文包、模块写作包。

使用时机:source-tutorial 的 C2 阶段,已有 module plan 与 source coverage,需要组织成稳定的写作输入。

跳过条件:模块规划或来源覆盖尚未完成。

网络:无(none)。

护栏(Guardrail):只整理上下文,不直接写教程正文。

主要能力

将模块结构、来源覆盖与来源片段组合为每个模块一个确定性的 JSONL 包。

输入:

  • outline/module_plan.yml
  • outline/source_coverage.jsonl
  • sources/provenance.jsonl

输出:

  • outline/tutorial_context_packs.jsonl

每个包必须包含以下契约字段:

  • module_id
  • title
  • objective
  • core_concepts
  • exercise_seed
  • source_snippets

使用方式

脚本边界:scripts/run.py 应读取当前的 module plan 与 coverage 文件,按模块选择来源片段,为每个模块写出一个稳定的包。片段排序(snippet ranking)与包合成(pack synthesis)应保留在共享的 tutorial 工具中,而不是放在这个薄封装脚本里。

验收标准:

  • 每个模块一个包
  • 每个包都含有 module_id 和 objective
  • 每个包都包含真实的、有来源支撑的片段

适用场景与限制

非目标(Non-goals):不产出最终教程正文;不进行 PDF 或幻灯片交付。

该技能限定在上下文整理环节,不负责写作或交付。其余信息暂未提供。