Nyereség:
- A mesterséges intelligencia biztonságos felhasználása a whitepaper, a NatSpec, a technikai-egyszerű fordítás és a kockázatok feltárásában, valamint annak megértése, hogy ez a legtermékenyebb terület.
- Lehetőség minden műszaki igény tényleges kóddal történő ellenőrzésére, valamint a túlzások és a garanciális nyelvezet eltávolítására a helytelen dokumentáció kockázatának elkerülése érdekében
- A kockázatok őszinte felvállalásának képessége, „nem pénzügyi tanácsadás” figyelmeztetés és a dokumentáció-kód következetessége
A Web3-ban a dokumentáció nem luxus, hanem biztonság és bizalom kérdése. Az intelligens szerződéssel való interakcióval a felhasználó valódi pénzét kockáztatja; Ha nem érti, mit csinál, készen áll a megtévesztésre. Az auditor nem tudja biztonságosan áttekinteni a nem megfelelően dokumentált kódot. Ebben az egységben azt a területet fedjük le, ahol a mesterséges intelligencia a legmegbízhatóbb és leghatékonyabb: a dokumentáció és a műszaki írás. A fehér könyvtől a kódon belüli megjegyzésekig, a felhasználói útmutatótól a kockázatok feltárásáig az AI itt valódi erőtömeg-szorzó – mindaddig, amíg a pontosságot humánusan felügyelik.
A Web3 dokumentáció típusai
- Whitepaper / litepaper: A projekt jövőképét, mechanizmusát és tokenomikáját leíró alapdokumentum.
- Műszaki dokumentáció: Szerződéses felületek, integrációs útmutató fejlesztőknek.
- NatSpec (Ethereum természetes nyelvi specifikáció – szabványos kódon belüli megjegyzésformátum a Solidity-ben, amely leírja, hogy mit csinálnak a függvények): Kódba ágyazott dokumentáció, amelyet ember és eszköz is olvas.
- Felhasználói útmutató: Egyszerű szöveg, amely elmondja a végfelhasználónak, hogy "hogyan kell használni, milyen kockázatok vannak".
- Jogi nyilatkozat: Jogilag és etikailag kötelező figyelmeztetések.
Gyakori probléma ezekkel a típusokkal: a fejlesztők nem szeretnek írni, és gyakran az utolsó pillanatra hagyják. Az AI pontosan ezt a hiányt pótolja.
Miért a dokumentáció a mesterséges intelligencia legbiztonságosabb területe?
A dokumentációban a hiba költsége alacsonyabb, mint az auditálásnál: egy hibás mondatot kijavítanak, nem repül a pénz (közvetlenül). Ezenkívül az AI természetesen erős a nyelvi előállításban. Tehát itt az AI hatékony és viszonylag biztonságos is. Két kritikus kockázat azonban továbbra is fennáll:
- Hamis műszaki állítás: A mesterséges intelligencia félreértelmezheti a kód működését; Ez félrevezeti a felhasználót, és biztonsági réssé válhat (kivéve, ha azt írja ki, hogy „ez a funkció védi az Ön pénzét”, és nem).
- Hiperbola/marketingnyelv: A mesterséges intelligencia olyan nyelvet tud előállítani, amely biztonságosnak vagy nyereségesnek tűnik egy projektben; Ez egyrészt etikai, másrészt jogi probléma.
Figyelem: A dokumentáció leírja a kódot; Ez nem maga a kód. Minden technikai állítást, amelyet az AI ír ("ez történik", "ez megtörténik") ellenőrizni kell a tényleges kóddal. A helytelen dokumentáció veszélyesebb lehet, mint a helyes kód, mivel a felhasználó megbízik a dokumentációban.
Az AI használatának rétegei a dokumentációban
1. NatSpec generáció. Az AI beolvas egy létező függvényt, és elkészíti a NatSpec értelmezést: mit csinál, mik a paraméterei, mit ad vissza. Ez leegyszerűsíti az ellenőrzést és a karbantartást.
2. Műszaki-egyszerű fordítás. A mesterséges intelligencia egy összetett mechanizmust fordít le nyelvre, amelyet a végfelhasználó megérthet – ez a Web3 egyik legnagyobb szükséglete.
3. Fehér könyv vázlata és szerkezete. A mesterséges intelligencia elkészíti egy fehér könyv vázát és metszeteit; A tartalom pontossága emberi.
4. Többnyelvűség és szintbeállítás. A mesterséges intelligencia ugyanazt a tartalmat képes előállítani, mind technikai, mind egyszerű, török és angol nyelven.
Gyenge felszólítás / Erős felszólítás
Gyenge felszólítás:
Írjon egy fehér könyvet ehhez a projekthez.
A mesterséges intelligencia eltúlzott, esetleg hamis és marketinggel teli másolatot alkot a tényleges mechanizmus ismerete nélkül.
Erőteljes felszólítás:
Az Ön szerepe: Web3 műszaki író. Alább látható a projekt VALÓDI mechanizmusa, tokenomikája és kódja. Kizárólag ezen információk alapján írjon egy tervezetet egy tanulmányhoz. Szabályok: - Ne vigyen túlzásba, NE használjon olyan kifejezéseket, mint "garantált haszon", "teljesen biztonságos" stb. - Minden műszaki állítást az általam megadott mechanizmusra alapozzon; Ne adjon hozzá koholmányt.- Adjon hozzá egy „Kockázatok” részt, amely egyértelműen kimondja a kockázatokat. – Adjon hozzá egy figyelmeztetést: „Ez nem pénzügyi tanács”. Minden olyan információt, amelyben nem biztos, vagy amelyekkel nem rendelkezem, jelölje meg [KITÖLTHETŐ]ként.
Négy másolható sablon
1) NatSpec generáció:
Írjon szabványos NatSpec megjegyzéseket a következő függvényhez: @notice (mit jelent, sima), @dev (technikai megjegyzés), @param és @return. Csak azt írja le, amit a kód VALÓBAN csinál; Olyan viselkedés hozzáadása, amely nem szerepel a kódban. Jelölje meg azt a hatást, amelyben nem biztos.
2) Műszaki-egyszerű fordítás:
Magyarázza el ezt a mechanizmust tiszta török nyelven, amelyet egy kezdő kriptográfiai felhasználó is érthet: mit csinál, mit tegyen a felhasználó, MILYEN KOCKÁZATOK vannak? Túlzás; nincs garancia a biztonságra. Ne rejtsd el a kockázatokat, helyezd azokat előtérbe.
3) Kockázat/figyelmeztetés szakasz:
Írjon egy őszinte "Kockázatok és figyelmeztetések" részt ehhez a projekthez: smartcontract kockázat, piaci kockázat, likviditási kockázat, szabályozási bizonytalanság, kulcsvesztés. Magyarázza el az egyes kockázatokat közérthető nyelven. Ne becsülje alá a kockázatokat; fejezze be: "ez nem pénzügyi tanács".
4) Dokumentációs kód konzisztencia ellenőrzése:
Az alábbiakban egy funkció és elérhető dokumentációja látható. Jelölje meg azokat a helyeket, ahol a dokumentum ellentmond vagy kihagyja a kód TÉNYLEGES viselkedését. Végső döntéshozatal; Küldje be "fejlesztői ellenőrzésre".
Három mini tok (számokban)
1. eset – A NatSpec megerősítette az ellenőrzést. Egy csapat 25 funkciós szerződést nyújtott be felülvizsgálatra, megjegyzés nélkül; A könyvvizsgáló több időt kért a logika megértéséhez. A csapat mesterséges intelligencia segítségével NatSpec piszkozatokat készített, és mindegyiket kóddal megerősítette; Az audit előkészítése közel 1 nappal lerövidült. Tanulság: a jó dokumentáció csökkenti az ellenőrzési költségeket.
2. eset – Hamis állítás észlelve. Az YZ által készített felhasználói kézikönyv kimondta, hogy „a pénzét bármikor visszavonhatja”; míg a szerződésben 7 napos zárolás volt. A műszaki vizsgálat ezt megfogta. Ha közzétennék, a felhasználók tévednének és áldozattá válnának. Tanulság: minden műszaki igényt kód igazol.
3. eset – A túlzás tisztázva. Az első tanulmánytervezetben az AI olyan kifejezéseket használt, mint a „magas hozam kockázat nélkül”. A csapat eltávolította ezeket, és hozzáadott egy becsületes kockázati részt. Ez védte a projektet etikailag és jogilag egyaránt. Tanulság: Az AI marketing-elfogultságát ellenőrizni kell.
A dokumentálás etikai terhe
A Web3 dokumentációját olyan környezetben olvassuk, ahol a felhasználó kockáztatja a pénzét. Ezért:
- Őszinteség: A kockázatokat nem lehet elrejteni, és nem lehet túlzó ígéreteket tenni.
- Pontosság: A műszaki állításoknak meg kell egyeznie a kóddal; A „dokumentum azt mondja” nem védekezés, inkább félrevezetés.
- Hozzáférhetőség: A felhasználó által ténylegesen értett nyelven írás biztonsági intézkedés; A meg nem értett dokumentum megtévesztésre hív fel.
- Jogi nyilatkozat: Világosan ki kell jelenteni, hogy ez nem pénzügyi tanácsadás és szabályozási bizonytalanság.
Tipp: Web3-dokumentum őszinteségi tesztje: "Ha egy felhasználó pénzt fektet abba, hogy csak ebben a dokumentumban bízzon, becsapva érzi magát, amikor szembesül az igazsággal?" Mindig a mesterséges intelligencia emelje ki a kockázati részt, ne a végén temesse el.
Gyakori hibák
- A műszaki állítást nem erősíti meg kóddal. A rossz dokumentum félrevezeti a felhasználót.
- A hype/marketingnyelv elvetése. Etikai és jogi kockázat.
- A kockázatok minimalizálása vagy elrejtése. A bizalom megsértése.
- Fehér könyv nyomtatása anélkül, hogy a valódi mechanizmust megadná az MI-nek. Készítményeket gyárt.
- Figyelmen kívül hagyja a "nem pénzügyi tanácsadás" figyelmeztetést. Jogi kötelezettség.
- Nem tartja szinkronban a dokumentációt a kóddal. Amikor a kód megváltozik, a dokumentum félrevezetővé válik.
Összefoglalva
- A dokumentáció biztonság és bizalom kérdése a Web3-ban; Ez az AI legtermékenyebb területe.
- A hiba költsége viszonylag alacsony, de a hamis műszaki állítások és a túlzások komoly kockázatot jelentenek.
- Minden műszaki igényt valódi kóddal kell megerősíteni; A dokumentum nem helyettesíti a kódot.
- A kockázatokat őszintén és jól láthatóan kell megírni; A túlzásokat és a garanciális nyelvezetet el kell távolítani.
- „Ez nem pénzügyi tanácsadás”, és a hatósági figyelmeztetések kötelezőek.
Pályázati feladat
Szerezzen be egy intelligens szerződés funkciót. Adja meg az AI-nak a „NatSpec generálása” parancsot, és hasonlítsa össze soronként a generált értelmezést a kód tényleges viselkedésével – vannak nézeteltérések? Ezután készítsen egy "technikai egyszerű fordítást" és egy "kockázati/figyelmeztetési részt" ugyanarra a funkcióra. Keresse meg és javítsa ki az AI legalább egy olyan kijelentését, amely eltúlzott vagy ellentmond a kódnak.
ellenőrző lista
- [ ] Minden műszaki állítást tényleges kóddal igazoltam.
- [ ] Eltávolítottam a túlzásokat/garanciákat.
- [ ] A kockázatokat őszintén és kiemelve írtam le.
- [ ] Megadtam a mesterséges intelligencia valódi mechanizmusát; Nem hagytam, hogy pótolja.
- [ ] Hozzátettem a "Ez nem pénzügyi tanácsadás" figyelmeztetést.
- [ ] A NatSpec-et teljes egészében a járműhöz és a vezérléshez írtam.
- [ ] Úgy terveztem, hogy a dokumentációt szinkronban tartom a kóddal.