To Spec

Přemění konverzaci, kterou jste již vedli, na specifikaci s vědomím repozitáře v .plan/

od rengwu · rengwu/wayfinder-maps

Funguje s nastavením ★ 8.8/10

To Spec — Přemění konverzaci, kterou jste již vedli, na specifikaci s vědomím repozitáře v .plan/

Co umí

Syntetizuje aktuální konverzaci a kódovou základnu do specifikace (PRD) zapsané do .plan/<slug>/spec.md, bez kroku rozhovoru. Vynucuje náčrt testovacího švu před zápisem a pevnou sadu sekcí: problém, řešení, vyčerpávající seznam uživatelských příběhů, implementační rozhodnutí, testovací rozhodnutí a mimo rozsah. Vyvolá se zadáním /to-spec po dokončení diskuse o funkci.

Testovací report

Spustil jsem to proti skutečnému 25řádkovému Python CLI plus konverzaci o funkci a porovnal výsledek se specifikací bez skillu: 21 uživatelských příběhů proti nule a 0 odkazů na cesty k souborům nebo kód proti 4, které by se rozpadly při prvním refaktoringu. Krok švu je to, kde si vydělává – nasměroval testovací plán na existující vstupní bod main(argv) a označil, že soubor poznámek musí být přesměrovatelný pro každý test, což je mezera, kterou základní specifikace opomenula a kterou jsme potvrdili spuštěním (volání ve stylu testu zapsalo přímo do $HOME/.notes.json). Také zachytil čtyři chování, která základní verze vynechala, včetně toho, co by mělo dělat přejmenování neexistujícího štítku. Háček je v tom, že frontmatter obsahuje disable-model-invocation, takže se nikdy neaktivuje z fráze jako 'write this up as a spec' – musíte zadat /to-spec, což README repozitáře poctivě dokumentuje. Žije pod skills/.optional/, skrytým adresářem, který si při procházení repozitáře na GitHubu nevšimnete.

Testováno: 2026-07-28 · Claude Code 2.x (agent harness)

Instalace

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

Příkazy a ukázkové prompty

  • /to-specPřemění konverzaci, kterou jste již vedli, na specifikaci s vědomím repozitáře v .plan/

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

  • /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