Plánovací obálka nesmí předstírat vytvořený commit
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Agent v čistě plánovacím kole nesmí měnit repozitář, ale výsledná JSON obálka povinně vyžaduje „SHA vytvořeného commitu“. Agent proto opakovaně odmítá vrátit úspěšný plán: nový commit nevznikl a aktuální HEAD neobsahuje artefakty plánované operace.
Pokud by agent vyplnil aktuální HEAD, auditní stopa by nepravdivě tvrdila, že effectful výsledek patří existujícímu commitu.
Root cause
Sekce “Root cause”Jedno pole mělo dvě neslučitelné sémantiky:
- u implementace označovalo commit vytvořeného kandidáta;
- u nemutačního plánování mělo označovat pouze stav repozitáře, ze kterého plán vycházel.
Generátor promptu a validátor nerozlišovaly fázi workflow. Povinný čtyřicetiznakový hash byl proto syntakticky konzistentní, ale sémanticky nepravdivý.
{ "verdict": "PLAN_PROPOSED", "commit": "<SHA vytvořeného commitu>"}Fix
Sekce “Fix”Plánovací verdikty používají oddělený kontrakt:
{ "verdict": "PLAN_PROPOSED", "commit": null, "refHead": "<ověřený aktuální HEAD>"}Validátor povolí commit: null pouze pro plánovací verdikty, vyžaduje plný hash v refHead a porovná jej s read-only zjištěným HEAD. U implementace a auditu kandidáta zůstává commit povinný a refHead je zakázán. Prompt výslovně říká, že refHead je vstupní reference, nikoli důkaz vytvořeného artefaktu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: Pro každý verdikt otestuj nejen formát polí, ale i jejich význam a povolené vedlejší účinky dané fáze.
- Anti-pattern: Jedna univerzální obálka vyžaduje stejný „result commit“ pro plánování, implementaci i ověřování.
- Lepší přístup: Použij diskriminovaný kontrakt podle verdiktu; vstupní reference a výstupní artefakt musí mít odlišná pole.
Sister bugs / související
Sekce “Sister bugs / související”Související je Formátová chyba agentní obálky zastaví jinak úspěšný workflow. Tam je obálka neplatná syntakticky; zde byl samotný požadovaný formát sémanticky chybný.