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