Kasu:
- Oskus kasutada tehisintellekti ohutult valge paberi, NatSpeci, tehnilis-lihtsa tõlke ja riskide avalikustamisel ning mõistmine, et see on kõige produktiivsem valdkond.
- Võimalus kontrollida iga tehnilist nõuet tegeliku koodiga ning eemaldada liialdus ja garantiikeel, et vältida vale dokumentatsiooni ohtu
- Võimalus riske ausalt omaks võtta, „mitte finantsnõustamise“ hoiatus ja dokumentatsioonikoodi järjepidevus
Dokumentatsioon Web3-s ei ole luksus, vaid turvalisuse ja usalduse küsimus. Nutika lepinguga suheldes riskib kasutaja oma pärisrahaga; Kui ta ei saa aru, mida ta teeb, on ta avatud petta saamisele. Audiitor ei saa turvaliselt üle vaadata koodi, mis pole hästi dokumenteeritud. Selles üksuses käsitleme valdkonda, kus tehisintellekt on kõige usaldusväärsem ja tõhusam: dokumentatsioon ja tehniline kirjutamine. Alates valgest raamatust kuni koodisiseste kommentaarideni, kasutusjuhendist kuni riskide avalikustamiseni – tehisintellekt on siin tõeline jõukordaja – seni, kuni täpsust inimlikult jälgitakse.
Web3 dokumentatsiooni tüübid
- Whitepaper / litepaper: alusdokument, mis kirjeldab projekti visiooni, mehhanismi ja tokenoomikat.
- Tehniline dokumentatsioon: Lepingu liidesed, integratsioonijuhend arendajatele.
- NatSpec (Ethereumi loomuliku keele spetsifikatsioon – standardne koodisisene kommentaarivorming Solidity's, mis kirjeldab, mida funktsioonid teevad): koodi manustatud dokumentatsioon, mida loevad nii inimene kui ka tööriist.
- Kasutusjuhend: Lihttekst, mis ütleb lõppkasutajale "kuidas kasutada, millised riskid sellega kaasnevad".
- Kohustustest loobumine: juriidiliselt ja eetiliselt nõutavad hoiatused.
Nende tüüpide tavaline probleem: arendajatele ei meeldi kirjutada ja nad jätavad selle sageli viimasele hetkele. AI täidab täpselt selle tühimiku.
Miks on dokumentatsioon tehisintellekti kõige turvalisem valdkond?
Dokumentatsiooni veakulu on väiksem kui auditeerimisel: parandatakse üks vale lause, raha ei lenda (otse). Lisaks on AI loomulikult tugev keeletootmises. Seega on AI siin nii tõhus kui ka suhteliselt ohutu. Kuid kaks kriitilist riski jäävad alles:
- Vale tehniline väide: tehisintellekt võib koodi tegevust valesti esitada; See eksitab kasutajat ja võib muutuda turvaaukuks (välja arvatud juhul, kui on kirjas "see funktsioon kaitseb teie raha" ja mitte).
- Hüperbool/turunduskeel: AI suudab toota keelt, mis muudab projekti turvaliseks või tulusaks; See on nii eetiline kui ka juriidiline probleem.
Ettevaatust: dokumentatsioon kirjeldab koodi; See pole kood ise. Iga tehniline väide, mille AI kirjutab ("see juhtub", "see jääb alles"), tuleb kontrollida tegeliku koodiga. Vale dokumentatsioon võib olla ohtlikum kui õige kood, kuna kasutaja usaldab dokumentatsiooni.
AI kasutamise kihid dokumentatsioonis
1. NatSpec põlvkond. AI loeb olemasolevat funktsiooni ja koostab NatSpeci tõlgenduse: mida see teeb, millised on selle parameetrid, mida see tagastab. See lihtsustab kontrolli ja hooldust.
2. Tehniline-lihttõlge. AI tõlgib keeruka mehhanismi lõppkasutajale arusaadavasse keelde – üks Web3 suurimaid vajadusi.
3. Valge paberi kontuur ja struktuur. AI toodab valge paberi skeleti ja osad; Sisu täpsus on inimlik.
4. Mitmekeelsus ja taseme kohandamine. AI suudab toota sama sisu, nii tehnilist kui ka tavalist, nii türgi kui ka inglise keeles.
Nõrk viip / Tugev viip
Nõrk viip:
Kirjutage selle projekti jaoks valge raamat.
AI moodustab liialdatud, võib-olla vale ja turundusega täidetud koopia, teadmata tegelikku mehhanismi.
Võimas viip:
Teie roll: Web3 tehniline kirjutaja. Allpool on projekti REAL mehhanism, tokenoomika ja kood. Ainuüksi selle teabe põhjal koostage valge raamatu mustand. Reeglid: - Ärge liialdage, ÄRGE kasutage fraase nagu "garanteeritud kasum", "täiesti ohutu" jne. - Iga tehniline väide põhineb minu esitatud mehhanismil; Ärge lisage väljamõeldisi.- Lisage jaotis "Riskid", mis kirjeldab selgelt riske. - Lisage hoiatus "See ei ole finantsnõuanne." Märkige kõik andmed, milles te pole kindel või mida mul pole, märkega [TÄIDA].
Neli kopeeritavat malli
1) NatSpeci põlvkond:
Kirjutage standardsed NatSpec-kommentaarid järgmisele funktsioonile: @notice (mis teeb, tavaline), @dev (tehniline märkus), @param ja @return. Kirjutage ainult seda, mida kood TEGELIKULT teeb; Käitumise lisamine, mida koodis pole. Märgistage efekt, milles te pole kindel.
2) Tehniline-lihttõlge:
Selgitage seda mehhanismi lihtsas türgi keeles, millest krüpto-algaja kasutaja aru saab: mida see teeb, mida peaks kasutaja tegema, MIS RISKID on? Liialdus; turvalisuse garantii puudub. Ära varja riske, vaid too need esile.
3) Riski/hoiatuse jaotis:
Kirjutage selle projekti jaoks aus jaotis "Riskid ja hoiatused": nutika lepingu risk, tururisk, likviidsusrisk, regulatiivne ebakindlus, võtmekaotus. Selgitage iga riski lihtsas keeles. Ärge alahinnake riske; lõpetage sõnadega "see pole finantsnõuanne".
4) Dokumentatsioonikoodi järjepidevuse kontroll:
Allpool on funktsioon ja selle saadaolev dokumentatsioon. Märkige kohad, kus dokument on vastuolus koodi TEGELIKU käitumisega või jätab selle vahele. Lõpliku otsuse tegemine; Esitage see "arendaja kinnitamiseks".
Kolm miniümbrist (numbrites)
Juhtum 1 – NatSpec tõhustas kontrolli. Üks meeskond esitas kommentaarideta läbivaatamiseks 25 funktsiooni hõlmava lepingu; Audiitor palus loogika mõistmiseks lisaaega. Meeskond koostas AI-ga NatSpeci mustandid ja kinnitas igaüks koodiga; Auditi ettevalmistamine lühenes peaaegu 1 päeva võrra. Õppetund: hea dokumentatsioon vähendab auditi kulusid.
Juhtum 2 – tabati vale väide. YZ koostatud kasutusjuhendis oli kirjas, et „teie raha võidakse igal ajal välja võtta”; kusjuures lepingus oli 7 päeva lukk. Tehniline ülevaade tabas seda. Kui see avaldataks, eksiksid kasutajad ja langeksid ohvriks. Õppetund: iga tehniline väide on kinnitatud koodiga.
Juhtum 3 – liialdus on kõrvaldatud. Esimeses valge raamatu mustandis kasutas AI selliseid väljendeid nagu "kõrge tootlus ilma riskita". Meeskond eemaldas need ja lisas ausa riskiosa. See kaitses projekti nii eetiliselt kui ka juriidiliselt. Õppetund: AI turunduse kallutatust tuleb auditeerida.
Dokumenteerimise eetiline koormus
Web3 dokumentatsiooni loetakse kontekstis, kus kasutaja riskib oma rahaga. Seetõttu:
- Ausus: riske ei saa varjata ja liialdatud lubadusi anda.
- Täpsus: tehnilised väited peavad vastama koodile; "Dokumendis on nii öeldud" ei ole kaitse, vaid pigem valeandmete esitamine.
- Juurdepääsetavus: kasutajale tegelikult arusaadavas keeles kirjutamine on turvameede; Dokument, millest aru ei saada, on kutse pettusele.
- Kohustustest loobumine: tuleks selgelt öelda, et see ei ole finantsnõustamine ega regulatiivne ebakindlus.
Näpunäide: Web3 dokumendi aususe test: "Kui kasutaja paneb raha sellesse, et usaldada ainult seda dokumenti, kas ta tunneb end tõega silmitsi seistes petetuna?" Laske tehisintellektil alati riskiosa esile tõsta, mitte seda lõpus maha matta.
Levinud vead
- Tehnilist väidet koodiga ei kinnita. Vale dokument eksitab kasutajat.
- Hüpe/turunduskeelest loobumine. Eetiline ja juriidiline risk.
- Riskide minimeerimine või varjamine. Usalduse rikkumine.
- Valge paberi printimine ilma AI-le tegelikku mehhanismi andmata. See toodab väljamõeldisi.
- Eirates hoiatust "mitte finantsnõuanne". Juriidiline kohustus.
- Ei hoia dokumentatsiooni koodiga sünkroonis. Kui kood muutub, muutub dokument eksitavaks.
Kokkuvõttes
- Dokumentatsioon on Web3 turvalisuse ja usalduse küsimus; See on AI kõige produktiivsem valdkond.
- Vea hind on suhteliselt madal, kuid valed tehnilised väited ja liialdamine on tõsised riskid.
- Iga tehniline väide peab olema kinnitatud reaalse koodiga; Dokument ei asenda koodi.
- Riskid tuleks kirjutada ausalt ja silmapaistvalt; Liialdus ja garantiikeel tuleks eemaldada.
- "See ei ole finantsnõustamine" ja regulatiivsed hoiatused on kohustuslikud.
Rakenduse ülesanne
Hankige nutika lepingu funktsioon. Andke tehisintellektile viip "Generate NatSpec" ja võrrelge loodud tõlgendust ridade kaupa koodi tegeliku käitumisega – kas on lahkarvamusi? Seejärel koostage sama funktsiooni jaoks "tehniline lihttõlge" ja "riski/hoiatuse jaotis". Leidke ja parandage vähemalt üks AI väide, mis on liialdatud või on koodiga vastuolus.
kontrollnimekiri
- [ ] Kinnitasin iga tehnilise väite tegeliku koodiga.
- [ ] Eemaldasin liialdused/garantiid.
- [ ] Panin riskid kirja ausalt ja neid esile tõstes.
- [ ] Andsin tehisintellektile tegeliku mehhanismi; Ma ei lasknud tal seda välja mõelda.
- [ ] Lisasin hoiatuse "See ei ole finantsnõuanne."
- [ ] Kirjutasin NatSpeci täielikult sõiduki ja kontrolli jaoks.
- [ ] Plaanisin dokumentatsiooni koodiga sünkroonis hoida.