source-tutorial-spec

name

source-tutorial-spec

description

Use when a `source-tutorial` workspace has ingested sources and needs a grounded tutorial contract before structure planning. **Trigger**: source tutorial spec, tutorial from sources, learner profile, 教程规格, 从资料生成教程. **Use when**: `source-tutorial` 的 C2，需要根据 `sources/index.jsonl` / `sources/provenance.jsonl` 锁定 audience、prerequisites、learning objectives、source scope 和 running example policy。 **Skip if**: source ingest 还没完成，或 tutorial scope 已被人工冻结。 **Network**: none. **Guardrail**: 不要发明 sources 没支持的内容；running example 不稳时要明确写无统一 running example。

Source Tutorial Spec

Builds the C2 tutorial contract from the ingested source corpus, not from a bare topic prompt.

Inputs

• sources/index.jsonl
• sources/provenance.jsonl
• GOAL.md
• DECISIONS.md

Output

• output/TUTORIAL_SPEC.md

Contract

The spec must include:

• ## Audience
• ## Prerequisites
• ## Learning objectives
• ## Non-goals
• ## Source scope
• ## Running example policy
• ## Delivery shape

It should also embed machine-readable structured data for downstream deterministic planning.

Script boundary

scripts/run.py should:

• read the ingested source bundle
• derive a grounded tutorial scope
• write the markdown spec and structured seed block

Keep phrase extraction, concept selection, and source matching in shared tutorial tooling, not in the thin skill wrapper.

Acceptance

• output/TUTORIAL_SPEC.md exists
• the required sections are present
• source families are named explicitly
• running example policy is concrete or explicitly omitted

Non-goals

• concept DAG construction
• module sequencing
• tutorial prose writing