Добивки:
- Можност за безбедно користење на вештачката интелигенција за производство на бела хартија, NatSpec, технички-едноставен превод и откривање ризик и разбирање дека ова е најпродуктивното поле.
- Способност да се потврди секое техничко барање со вистински код и да се отстрани претерувањето и гарантен јазик за да се избегне ризикот од неточна документација
- Способност искрено да се прифатат ризиците, предупредување „не финансиски совет“ и конзистентност на кодот на документацијата
Документацијата во Web3 не е луксуз, туку прашање на сигурност и доверба. Со интеракција со паметен договор, корисникот ги ризикува своите вистински пари; Ако не разбира што прави, тој е отворен да биде измамен. Ревизорот не може безбедно да го прегледа кодот што не е добро документиран. Во оваа единица, ја покриваме областа каде што вештачката интелигенција е најсигурна и ефикасна: документација и техничко пишување. Од бела хартија до коментари во кодот, од корисничко упатство до откривање ризици, вештачката интелигенција е вистински мултипликатор на сила овде - се додека точноста хумано се следи.
Видови на Web3 документација
- Whitepaper / Litepaper: Основниот документ кој ја опишува визијата, механизмот и токеномиката на проектот.
- Техничка документација: Договорни интерфејси, водич за интеграција за програмери.
- NatSpec (Спецификација за природен јазик на Ethereum - Стандарден формат на коментари во кодот во Solidity кој опишува што прават функциите): Документација вградена во код, читана и од човек и од алатка.
- Упатство за употреба: Обичен текст кој му кажува на крајниот корисник „како да се користи, какви ризици постојат“.
- Одрекување: Законски и етички потребни предупредувања.
Чест проблем со овие типови: програмерите не сакаат да пишуваат и често го оставаат на последен момент. ВИ ја пополнува токму оваа празнина.
Зошто документацијата е најбезбедната област на вештачката интелигенција
Цената на грешката во документацијата е помала отколку во ревизијата: една неточна реченица се коригира, парите не летаат (директно). Дополнително, вештачката интелигенција е природно силна во производството на јазици. Значи, вештачката интелигенција е и ефикасна и релативно безбедна овде. Но, остануваат два критични ризици:
- Лажно техничко тврдење: ВИ може погрешно да го претстави она што го прави кодот; Ова го доведува во заблуда корисникот и може да стане безбедносна ранливост (освен ако не вели „оваа функција ги штити вашите средства“ и не го прави тоа).
- Хипербола/маркетиншки јазик: ВИ може да произведе јазик што го прави проектот да изгледа безбеден или профитабилен; Ова е и етички и правен проблем.
Внимание: Документацијата го опишува кодот; Тоа не е самиот код. Секое техничко тврдење што го пишува вештачката интелигенција („ова се случува“, „што се одржува“) мора да се потврди во однос на вистинскиот код. Неточната документација може да биде поопасна од точниот код бидејќи корисникот има доверба во документацијата.
Слоеви на користење на ВИ во документацијата
1. NatSpec генерација. Вештачката интелигенција чита постоечка функција и ја подготвува интерпретацијата NatSpec: што прави, кои се неговите параметри, што враќа. Ова ја поедноставува проверката и одржувањето.
2. Техничко-едноставен превод. Вештачката интелигенција преведува сложен механизам на јазик што крајниот корисник може да го разбере - една од најголемите потреби на Web3.
3. Контури и структура на Белата книга. ВИ произведува скелет и делови од бела хартија; Точноста на содржината е човечка.
4. Повеќејазичност и прилагодување на нивото. Вештачката интелигенција може да ја произведе истата содржина, и техничка и обична, и на турски и на англиски јазик.
Слаб промпт / Силен промпт
Слаба навестување:
Напишете бела книга за овој проект.
Вештачката интелигенција создава претерана, можеби лажна и маркетиншка копија без да го знае вистинскиот механизам.
Моќен потсетник:
Вашата улога: Веб3 технички писател. Подолу е РЕАЛЕН механизам, токеномика и код на проектот. Напишете нацрт на бела книга само врз основа на овие информации. Правила:- Не претерувајте, НЕ користете фрази како „загарантиран профит“, „целосно безбеден“ итн.- Секое техничко тврдење засновајте го на механизмот што го давам; Не додавајте измислици.- Додајте дел „Ризици“ во кој јасно се наведени ризиците.- Додадете предупредување „Ова не е финансиски совет“. Обележете ги сите информации за кои не сте сигурни или што ги немам како [ДА СЕ ПОПОЛНУВА].
Четири шаблони за копирање
1) Генерација NatSpec:
Напишете стандардни NatSpec коментари на следната функција: @notice (што прави, обична), @dev (техничка белешка), @param и @return. Напишете го само она што го прави кодот АКТУЕЛНО; Додавање на однесување што не е во кодот. Означете го ефектот за кој не сте сигурни.
2) Техничко-едноставен превод:
Објаснете го овој механизам на обичен турски што може да го разбере корисникот на крипто почетниците: што прави, што треба да прави корисникот, КОИ РИЗИЦИ има? Претерување; нема гаранција за безбедност. Не кријте ризици, доведете ги до израз.
3) Дел за ризик/предупредување:
Напишете искрен дел „Ризици и предупредувања“ за овој проект: ризик од паметен договор, пазарен ризик, ризик за ликвидност, регулаторна несигурност, загуба на клучеви. Објаснете го секој ризик на едноставен јазик. Не ги потценувајте ризиците; заврши со „ова не е финансиски совет“.
4) Проверка на конзистентноста на документацијата и кодот:
Подолу е функцијата и нејзината достапна документација. Обележете ги местата каде што документот е во спротивност или испуштање на ФАКТИВНОто однесување на кодот. Конечно одлучување; Испратете го на „програмерска потврда“.
Три мини футроли (во бројки)
Случај 1 - NatSpec ја засили инспекцијата. Еден тим достави договор со 25 функции за преглед без коментар; Ревизорот побара дополнително време за да ја разбере логиката. Тимот произведе NatSpec нацрти со вештачка интелигенција и го потврди секој со код; Подготовката за ревизија беше скратена за речиси 1 ден. Поука: добрата документација ги намалува трошоците за ревизија.
Случај 2 - Фатено лажно тврдење. Упатството за корисникот што го изработи YZ наведе дека „вашите средства може да бидат повлечени во секое време“; при што во договорот имало заклучување од 7 дена. Техничкиот преглед го фати ова. Доколку се објави, корисниците би биле погрешни и жртви. Лекција: секое техничко тврдење е потврдено со код.
Случај 3 - Претерувањето е расчистено. Во првиот нацрт на белата книга, вештачката интелигенција користеше изрази како „висок поврат без ризик“. Тимот ги отстрани овие и додаде чесен дел за ризик. Ова го заштити проектот и етички и законски. Поука: Маркетинг пристрасноста на вештачката интелигенција мора да се ревидира.
Етички товар на документацијата
Веб3 документацијата се чита во контекст каде што корисникот ги ризикува своите пари. Затоа:
- Искреност: Ризиците не можат да се сокријат и да се даваат претерани ветувања.
- Точност: Техничките барања мора да одговараат на кодот; „Документот така вели“ не е одбрана, туку погрешно претставување.
- Пристапност: Пишувањето на јазик што корисникот навистина го разбира е безбедносна мерка; Документ што не е разбран е покана за измама.
- Одрекување: Треба јасно да се наведе дека тоа не е финансиски совет и регулаторна несигурност.
Совет: Тест за чесност на Web3 документ: „Ако корисникот вложи пари во доверба само на овој документ, дали ќе се чувствува измамен кога ќе се соочи со вистината?“ Секогаш нека вештачката интелигенција го истакнува ризичниот дел, а не да го закопа на крајот.
Вообичаени грешки
- Не се потврдува техничкото тврдење со код. Погрешен документ го доведува во заблуда корисникот.
- Отфрлање на возбуда/маркетиншки јазик. Етички и правен ризик.
- Минимизирање или криење на ризиците. Прекршување на довербата.
- Печатење бела хартија без да се даде вистинскиот механизам на вештачката интелигенција. Таа произведува измислици.
- Игнорирање на предупредувањето „не финансиски совети“. Законска обврска.
- Не чување на документацијата во синхронизација со кодот. Кога кодот се менува, документот станува погрешен.
Сумирано
- Документацијата е прашање на безбедност и доверба во Web3; Тоа е најпродуктивното поле на вештачката интелигенција.
- Цената на грешката е релативно ниска, но лажните технички тврдења и претерувањето се сериозни ризици.
- Секое техничко тврдење мора да биде потврдено со вистински код; Документот не ја заменува шифрата.
- Ризиците треба да бидат напишани искрено и видно; Треба да се отстранат претерувањето и гаранцијата.
- „Тоа не е финансиски совет“ и регулаторните предупредувања се задолжителни.
Задача за апликација
Добијте функција за паметен договор. Дајте ѝ на AI пораката „Generate NatSpec“ и споредете ја генерираната интерпретација линија по линија со вистинското однесување на кодот - дали има несогласувања? Потоа создадете „техничко-обичен превод“ и „дел за ризик/предупредување“ за истата функција. Најдете и поправете барем една изјава на вештачката интелигенција што е претерано или е во спротивност со кодот.
листа за проверка
- [ ] Го потврдив секое техничко тврдење со вистинскиот код.
- [ ] Ги отстранив претерувањата/гаранциите.
- [ ] Искрено ги напишав ризиците и ги истакнав.
- [ ] На вештачката интелигенција и го дадов вистинскиот механизам; Не му дозволив да измисли.
- [ ] Го додадов предупредувањето „Ова не е финансиски совет“.
- [ ] Напишав NatSpec целосно за возило и контрола.
- [ ] Планирав да ја чувам документацијата во синхронизација со кодот.