Jak zrevidovat specifikaci od AI:kontrolní seznam před tím, než agent začne stavět.

Proč specifikace od AI potřebují jiný druh revize

Člověk píšící specifikaci obvykle nechává mezery tam, kde si není jistý. Model píše plynulý text o všem, i o tom, co jen odhadl. Obvyklé znaky slabé specifikace, vágní formulace a zjevné díry, proto chybí a problémy jsou ukryté v sebevědomých větách. Revidujte to, na co by se ptal dobrý autor.

Kontrolní seznam

1. Rozsah: řeší to, o co jste žádali?

   Porovnejte první odstavec se svým zadáním. Hledejte vyřešení jiného problému a funkce, o které nikdo nežádal.

2. Necíle: co to dělat nebude?

   Specifikace bez necílů nemá hranice. Doplňte extra věci, které nechcete.

3. Předpoklady: co odhadla?

   Hledejte „pravděpodobně“, „nejspíš“ a cokoli uvedené jako fakt o kódu nebo datech, která možná nečetla. Požádejte ji o odkazy na soubory.

4. Okrajové případy: co se stane, když se něco pokazí?

   Prázdný vstup, velmi velký vstup, chybějící oprávnění, žádná síť, dva uživatelé najednou, stejná akce dvakrát.

5. Data: co se ukládá, mění nebo maže?

   Pole, formáty, kdo je může číst a co se stane se stávajícími záznamy.

6. Migrace: jak se přesunou stará data?

   Změna schématu potřebuje pořadí kroků, plán pro selhání v půlce a způsob, jak ji bezpečně spustit dvakrát.

7. Rozhraní: čeho dalšího se to týká?

   API, obrazovky, úlohy, kód jiných týmů. Cokoli, co specifikace mění, ale neuvádí, bude později překvapení.

8. Bezpečnost a soukromí: kdo co smí?

   Nová oprávnění, nová data opouštějící systém, tajné údaje v lozích.

9. Testy: jak poznáte, že to funguje?

   Každý požadavek by měl mít odpovídající kontrolu. Pokud se požadavek nedá otestovat, přepište ho.

10. Nasazení a návrat zpět: jak to vrátíte?

    Přepínač, postupné nasazení, cesta zpět. „Opravíme to dopředu“ není plán.

11. Otevřené otázky: kdo je rozhodne?

    Poctivá specifikace uvádí, co neví. Pokud žádné nejsou, buďte podezřívaví.

Komentář, který funguje

Vágní zpětná vazba dá vágní přepsání. Dobrý komentář z revize ukáže na jedno místo, řekne, co je špatně a co chcete místo toho:

> The export runs when the user taps Export.

Missing: what happens with a 2 GB file? Add a limit (R4) and an
error message, and say whether the export can be cancelled.

Komentáře držte oddělené od textu specifikace, aby soubor zůstal čistý, a dávkujte je: přečtěte celou specifikaci jednou, pak komentujte, aby agent přepsal jednou, ne desetkrát.

Cyklus revize

1. Nejdřív přečtěte od začátku do konce

   Než začnete komentovat, ujistěte se, že rozumíte celému plánu.

2. Komentujte přesná místa

   Jeden problém na komentář.

3. Nechte agenta opravit

   Opraví každý komentář a vytvoří novou verzi.

4. Kontrolujte, co se změnilo, ne celý dokument

   Čtěte rozdíly. Oprava může rozbít něco, co bylo v pořádku.

5. Schvalte, až když je kontrolní seznam čistý

   Pak ať staví podle číslovaných požadavků.

Stejný kontrolní seznam funguje, i když jeden agent revizuje specifikaci druhého. Požádejte revidujícího, aby na každou položku odpověděl citátem ze specifikace.

Jak to udělat v DotMD

To vše lze dělat přímo na stránce. V DotMD vyberete místo a napíšete k němu komentář; komentáře se ukládají v DotMD, ne v souboru. Agent je opraví a pošle dokument znovu a kontrola změn ukáže starý text červeně a nový zeleně, takže je můžete přijímat jednu po druhé. Nastavení popisuje revize specifikací od AI. Čtení je zdarma; revize viz ceník.

Časté chyby

• Revize stylu, ne podstaty. I úhledná specifikace může být špatně.
• Schválení proto, že je dlouhá. Délka není pokrytí.
• Přeskočení necílů a návratu zpět, dvou sekcí, které modely nejčastěji nechávají chudé.
• Oprava kódu místo specifikace. Pokud je plán špatně, nejdřív opravte ten.
• Žádný druhý pohled. Až agent specifikaci upraví, zkontrolujte diff.

Otázky k revizi specifikací od AI

Další otázky