Co to znamená
.ai/repo/prompts/<name>.md drží malé znovupoužitelné rámování — jak zarámovat vadu, aby oprava byla prokázána, jak napsat záznam pokračování, jak posoudit diff proti deklarovanému rozsahu. Jsou verzované s repozitářem, nezávislé na provideru a vykreslované proti stavu aktuální úlohy.
Toto není knihovna promptů. Nic je neřadí, nic žádný automaticky nevybírá a nic žádný nenačte, dokud o to někdo nepožádá.
Princip
Front matter obsahuje name (musí se shodovat s názvem souboru) a neprázdné description; profile je volitelné a pouze dokumentační. Neznámé klíče jsou chyby, stejně jako všude jinde v Majordomus.
Vykreslení nahrazuje přesně dva druhy tokenů a žádné jiné. Inline, kdekoli v řádku: TASK, TASK_ID, PROFILE, SCOPE, OWNER, BRANCH, HEAD, WORKING_TREE, REPOSITORY, NOW. Blokové, platné jen samotné na řádku: OPEN_QUESTIONS, DECISIONS, CHECKPOINT, HANDOVER, CONTEXT.
Cokoli jiného ve dvojitých složených závorkách je chyba, stejně jako blokový token použitý uprostřed věty — rozbalil by mnoho řádků doprostřed odstavce. Žádný šablonovací jazyk neexistuje: žádné podmínky, cykly, include ani shell interpolace.
Asset, jehož tělo žádá celý kontext, je z context --prompt vyloučen místo vykreslení, s pojmenovaným vyloučením: výsledkem by byl ten kontext vnořený sám do sebe, který by rozpočet pak platil dvakrát.
doctor a watch validují každé aktivum — front matter, shodu jména, popis i každý token — takže rozbité aktivum je hlášené selhání, a ne překvapení v okamžiku, kdy ho někdo potřebuje.
Jak to vidět
majordomus prompt list
majordomus prompt render debug
printf -- '---\nname: typo\ndescription: d\n---\nhello {{TSAK}}\n' > .ai/repo/prompts/typo.md
majordomus prompt render typo; echo $? # 10, naming the unknown token
majordomus doctor # FAIL prompt typo — unknown tokenCo nepokrývá
Nic nikam neposílá prompt. render zapisuje na stdout; co s tím uděláte, je vaše věc, a Majordomus neprovádí žádné síťové volání.
Nic neměří, zda prompt pomohl. Není žádné srovnání A/B a žádné skóre kvality.
Dodané assety jsou výchozí bod, ne doporučení. Smažte je, přepište nebo přidejte vlastní; nástroj vyžaduje jen to, aby vše, co tam je, bylo platné.
Proč existuje
Užitečná zarámování se znovu objevují v každé relaci a ztrácejí se s konverzací, která je vytvořila, takže každý worker vynalézá o něco horší verzi. Udržování několika z nich v repozitáři je činí revidovatelnými, verzovanými a sdílenými. Uzavřená množina tokenů brání tomu, aby se soubor nenápadně stal programem.