To Spec

Verwandelt die bereits geführte Konversation in eine Repo-bewusste Spezifikation in .plan/

von rengwu · rengwu/wayfinder-maps

Funktioniert mit Setup ★ 8.8/10

To Spec — Verwandelt die bereits geführte Konversation in eine Repo-bewusste Spezifikation in .plan/

Was es kann

Synthetisiert die aktuelle Konversation und die Codebasis zu einer Spezifikation (PRD), die in .plan/<slug>/spec.md geschrieben wird, ohne Interviewschritt. Es erzwingt eine Test-Seam-Skizze vor dem Schreiben und einen festen Abschnittssatz: Problem, Lösung, eine erschöpfende User-Story-Liste, Implementierungsentscheidungen, Testentscheidungen und Out-of-Scope. Wird durch Eingabe von /to-spec aufgerufen, nachdem Sie die Diskussion über eine Funktion beendet haben.

Testbericht

Führte es gegen ein echtes 25-zeiliges Python CLI plus eine Feature-Konversation aus und verglich das Ergebnis mit einer Spezifikation ohne Skill: 21 User Stories gegenüber null, und 0 Dateipfad- oder Code-Referenzen gegenüber 4, die beim ersten Refactoring verrotten würden. Der Seam-Schritt ist, wo es sich bezahlt macht – er führte den Testplan auf den bestehenden main(argv)-Einstiegspunkt und markierte, dass die Notizdatei pro Test umleitbar sein muss, eine Lücke, die die Baseline-Spezifikation übersehen hatte und die wir durch Ausführung bestätigten (ein Test-Stil-Aufruf schrieb direkt in $HOME/.notes.json). Es fing auch vier Verhaltensweisen ab, die die Baseline fallen ließ, einschließlich dessen, was eine Umbenennung eines nicht existierenden Labels tun sollte. Der Haken ist, dass das Frontmatter disable-model-invocation enthält, sodass es nie durch eine Formulierung wie 'write this up as a spec' aktiviert wird – Sie müssen /to-spec eingeben, was die skills/README des Repos ehrlich dokumentiert. Es befindet sich unter skills/.optional/, einem versteckten Verzeichnis, das Sie beim Durchsuchen des Repos auf GitHub nicht entdecken werden.

Getestet am: 2026-07-28 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/rengwu/wayfinder-maps.git
mkdir -p ~/.claude/skills
cd wayfinder-maps && cp -r skills/.optional/to-spec ~/.claude/skills/to-spec

Befehle & Beispiel-Prompts

  • /to-specVerwandelt die bereits geführte Konversation in eine Repo-bewusste Spezifikation in .plan/

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • /to-spec turn what we just discussed about tagging into a written PRD
  • Save a spec to .plan for the notes feature we just finished designing
  • Write a PRD from this conversation with an exhaustive user story list