narrative-intake
Consume a narrative (prompt or file), interrogate and expand it, and convert it to a structured change proposal.
- License 许可
- MIT
- 最近更新
- 2026-08-08
- Stars
- ★ 1
- Forks
- 0
01 前言 Front Matter
- name
- narrative-intake
- description
- Consume a narrative (prompt or file), interrogate and expand it, and convert it to a structured change proposal.
03 SKILL.md 正文
Narrative Intake
Outcome
Turn a free-text narrative into a validated structured change artifact (and, at
project creation, initial specs/capabilities/). The narrative may be an
inline prompt or a file (e.g. CUSTOMIZE_THIS_PROJECT.toon.narrative).
Flow
narrative (prompt | file)
▼ interrogate: intent, users, behaviour, non-goals, unknowns
▼ expand: derive WHEN/THEN scenarios from described outcomes
▼ ideate: brief /ideate rounds where material ambiguity remains
▼ convert: proposal.md (why) + structured change artifact (deltas + scenarios
+ acceptance + tasks)
▼ validate: project check-changes
Rules
- Read the whole narrative first; separate stated fact from assumption.
- Ask only the smallest set of questions the narrative cannot answer.
- Every described outcome becomes a
WHEN/THENscenario with an acceptance test id (the ATDD bridge). - Record unknowns in the change and, when they outlive it, as
Q-knowledge. - At project creation, seed
specs/capabilities/from durable requirements and open a firstspecs/changes/<id>/for the first thin slice.
Do not
- Invent requirements the narrative does not support.
- Skip validation or leave scenarios without acceptance tests.
04 同仓库更多 Skills
agentic-template
Start or continue work in this repository using the canonical AGENTS.md contract and repository skill catalog.
wiki-tidy
Reconcile the wiki against the knowledge graph, specs and code; prune stale, keep links resolving.
update-handoff
Update HANDOFF.toon with current semantic work state.
test-first
Drive meaningful behaviour changes with the smallest useful failing test.
test-change
Select and run tests that prove a change at suitable fidelity.
specify
Create proportional OpenSpec-shaped structured change proposals for meaningful changes.