Табыстар:
- Whitepaper, NatSpec, техникалық-қарапайым аударма және тәуекелді ашу және бұл ең өнімді сала екенін түсіну үшін жасанды интеллектті қауіпсіз пайдалана білу.
- Әрбір техникалық шағымды нақты кодпен тексеру және қате құжаттама қаупін болдырмау үшін әсірелеу мен кепілдік тілін жою мүмкіндігі
- Тәуекелдерді адал қабылдау мүмкіндігі, «қаржылық кеңес емес» ескертуі және құжаттама кодының сәйкестігі
Web3-тегі құжаттама сән-салтанат емес, қауіпсіздік пен сенім мәселесі. Смарт келісімшартпен әрекеттесу арқылы пайдаланушы өзінің нақты ақшасын тәуекелге ұшыратады; Егер ол не істеп жатқанын түсінбесе, ол алданып қалуға ашық. Аудитор дұрыс құжатталмаған кодты қауіпсіз тексере алмайды. Бұл бөлімде біз AI ең сенімді және тиімді аймақты қарастырамыз: құжаттама және техникалық жазу. Түсініктемеден бастап кодтағы түсініктемелерге дейін, пайдаланушы нұсқаулығынан тәуекелді ашуға дейін, AI бұл жерде нақты күш мультипликаторы болып табылады - дәлдік адамгершілікпен бақыланса.
Web3 құжаттамасының түрлері
- Whitepaper / Litepaper: Жобаның көрінісін, механизмін және токеномикасын сипаттайтын негізгі құжат.
- Техникалық құжаттама: Келісімшарт интерфейстері, әзірлеушілерге арналған интеграциялық нұсқаулық.
- NatSpec (Ethereum Natural Language Specification — Функциялардың не істейтінін сипаттайтын Solidity жүйесіндегі стандартты код ішіндегі түсініктеме пішімі): Кодқа енгізілген құжаттаманы адам да, құрал да оқиды.
- Пайдаланушы нұсқаулығы: Түпкі пайдаланушыға «қалай пайдалану керек, қандай қауіптер бар» туралы қарапайым мәтін.
- Жауапкершіліктен бас тарту: Заңды және этикалық тұрғыдан талап етілетін ескертулер.
Бұл түрлердегі жиі кездесетін мәселе: әзірлеушілер жазуды ұнатпайды және көбінесе оны соңғы сәтке қалдырады. AI дәл осы олқылықты толтырады.
Неліктен құжаттама AI-ның ең қауіпсіз аймағы болып табылады?
Құжаттамадағы қатенің құны аудитке қарағанда төмен: бір қате сөйлем түзетіледі, ақша ұшпайды (тікелей). Сонымен қатар, AI тіл өндірісінде табиғи түрде күшті. Демек, AI мұнда тиімді және салыстырмалы түрде қауіпсіз. Бірақ екі маңызды тәуекел қалады:
- Жалған техникалық шағым: AI кодтың не істейтінін бұрмалауы мүмкін; Бұл пайдаланушыны жаңылыстырады және қауіпсіздіктің осалдығына айналуы мүмкін (егер ол «бұл функция сіздің қаражатыңызды қорғайды» деп айтпаса).
- Гипербола/маркетинг тілі: AI жобаны қауіпсіз немесе тиімді етіп көрсететін тілді жасай алады; Бұл әрі этикалық, әрі құқықтық мәселе.
Абайлаңыз: құжаттама кодты сипаттайды; Бұл кодтың өзі емес. AI жазатын әрбір техникалық растау («бұл орын алады», «қолдайды») нақты кодқа қарсы тексерілуі керек. Қате құжаттама дұрыс кодқа қарағанда қауіптірек болуы мүмкін, себебі пайдаланушы құжаттамаға сенеді.
Құжаттамада AI қолдану деңгейлері
1. NatSpec буыны. AI бар функцияны оқиды және NatSpec түсіндірмесінің жобасын жасайды: ол не істейді, оның параметрлері қандай, ол не қайтарады. Бұл тексеру мен техникалық қызмет көрсетуді жеңілдетеді.
2. Техникалық-қарапайым аударма. AI күрделі механизмді соңғы пайдаланушы түсінетін тілге аударады — Web3-тің ең үлкен қажеттіліктерінің бірі.
3. Ақ қағаздың сұлбасы және құрылымы. AI ақ қағаздың қаңқасы мен бөлімдерін жасайды; Мазмұнның дәлдігі адамға тән.
4. Көптілділік және деңгейді реттеу. AI түрік және ағылшын тілдерінде бірдей техникалық және қарапайым мазмұнды жасай алады.
Әлсіз шақыру / Күшті шақыру
Әлсіз шақыру:
Осы жоба үшін ақ қағазды жазыңыз.
AI нақты механизмді білмей-ақ асыра, мүмкін жалған және маркетингке толы көшірме жасайды.
Күшті шақыру:
Сіздің рөліңіз: Web3 техникалық жазушысы. Төменде жобаның REAL механизмі, токеномикасы және коды берілген. Тек осы ақпарат негізінде ақ қағаздың жобасын жазыңыз. Ережелер:- Өсіретпеңіз, «кепілдендірілген пайда», «толық қауіпсіз» және т.б. сияқты тіркестерді ҚОЛДАНБАҢЫЗ.- Әрбір техникалық шағымды мен берген механизмге негіздеңіз; Жасандылықты қоспаңыз.- Тәуекелдерді анық көрсететін «Тәуекелдер» бөлімін қосыңыз.- «Бұл қаржылық кеңес емес» ескертуін қосыңыз. Сіз сенімді емес немесе менде жоқ ақпаратты [ТОЛтырылуы керек] деп белгілеңіз.
Көшірілетін төрт үлгі
1) NatSpec буыны:
Келесі функцияға стандартты NatSpec түсініктемелерін жазыңыз: @notice (не істейді, қарапайым), @dev (техникалық ескерту), @param және @return. Кодтың ACTUALLY істейтінін ғана жазыңыз; Кодта жоқ әрекетті қосу. Сіз сенімді емес әсерді белгілеңіз.
2) Техникалық-қарапайым аударма:
Бұл механизмді түрік тілінде криптовалютаға кіріскен пайдаланушы түсінетіндей түсіндіріңіз: ол не істейді, пайдаланушы не істеуі керек, ҚАНДАЙ ТӘУЕКЕЛДЕР бар? асыра сілтеу; қауіпсіздікке кепілдік жоқ. Тәуекелдерді жасырмаңыз, оларды бірінші орынға шығарыңыз.
3) Тәуекел/ескерту бөлімі:
Осы жоба үшін адал «Тәуекелдер мен ескертулер» бөлімін жазыңыз: смарт-контракт тәуекелі, нарықтық тәуекел, өтімділік тәуекелі, реттеуші белгісіздік, негізгі жоғалту. Әр тәуекелді қарапайым тілмен түсіндіріңіз. Тәуекелдерді бағаламаңыз; «бұл қаржылық кеңес емес» деп аяқтаңыз.
4) Құжаттама кодының сәйкестігін тексеру:
Төменде функция және оның қолжетімді құжаттамасы берілген. Құжат кодтың НАҚТЫ әрекетіне қайшы келетін немесе өткізіп жіберетін жерлерді белгілеңіз. Қорытынды шешім қабылдау; Оны «әзірлеушілерді тексеруге» жіберіңіз.
Үш шағын іс (санмен)
1-жағдай - NatSpec тексеруді күшейтті. Бір команда 25-функциядан тұратын келісімшартты түсініктемесіз қарауға жіберді; Аудитор логиканы түсіну үшін қосымша уақыт сұрады. Команда AI көмегімен NatSpec жобаларын жасап, әрқайсысын кодпен растады; Аудитке дайындық 1 күнге дерлік қысқартылды. Сабақ: жақсы құжаттама аудиттің құнын азайтады.
2-жағдай – жалған шағым ұсталды. YZ жасаған пайдаланушы нұсқаулығында «сіздің қаражатыңыз кез келген уақытта алынуы мүмкін» деп жазылған; ал келісімшартта 7 күндік құлып болды. Техникалық шолу мұны анықтады. Егер ол жарияланған болса, пайдаланушылар қателесіп, құрбан болар еді. Сабақ: әрбір техникалық шағым кодпен расталады.
3-жағдай - асыра сілтеу жойылды. Алғашқы ақ қағаз жобасында AI «тәуекелсіз жоғары кірістілік» сияқты өрнектерді пайдаланды. Команда оларды алып тастап, адал тәуекел бөлімін қосты. Бұл жобаны этикалық және заңды түрде қорғады. Сабақ: AI маркетингтік бейімділігі тексерілуі керек.
Құжаттаманың этикалық ауыртпалығы
Web3 құжаттамасы пайдаланушы өз ақшасына қауіп төндіретін контексте оқылады. Сондықтан:
- Адалдық: Тәуекелдерді жасыруға болмайды және асыра уәде беруге болмайды.
- Дәлдік: Техникалық шағымдар кодқа сәйкес болуы керек; «Құжатта солай делінген» дегені – қорғау емес, керісінше, бұрмалау.
- Қол жетімділік: Пайдаланушы нақты түсінетін тілде жазу қауіпсіздік шарасы болып табылады; Түсінбеген құжат – алдауға шақыру.
- Жауапкершіліктен бас тарту: бұл қаржылық кеңес және реттеуші белгісіздік емес екенін анық айту керек.
Кеңес: Web3 құжатының адалдық сынағы: "Егер пайдаланушы тек осы құжатқа сеніп ақша салса, шындыққа тап болған кезде өзін алданып қалғандай сезіне ме?" Әрқашан AI тәуекел бөлігін бөлектеңіз, оны соңында көмбеңіз.
Жалпы қателер
- Техникалық шағымды кодпен растамау. Қате құжат пайдаланушыны жаңылыстырады.
- Хайп/маркетинг тілін тастау. Этикалық және құқықтық тәуекел.
- Тәуекелдерді азайту немесе жасыру. Сенімге қол сұғу.
- AI-ға нақты механизмді бермей ақ қағазды басып шығару. Ол жасанды заттарды шығарады.
- «Қаржылық емес кеңес» ескертуін елемеу. Заңды міндеттеме.
- Құжаттаманы кодпен синхрондатпау. Код өзгерген кезде құжат жаңылыстырады.
Қысқаша айтқанда
- Құжаттама Web3 жүйесіндегі қауіпсіздік пен сенім мәселесі; Бұл AI-ның ең өнімді саласы.
- Қатенің құны салыстырмалы түрде төмен, бірақ жалған техникалық шағымдар мен асыра сілтеу елеулі тәуекелдер болып табылады.
- Әрбір техникалық шағым нақты кодпен расталуы керек; Құжат кодты алмастырмайды.
- Тәуекелдер шынайы және көрнекті түрде жазылуы керек; Асыра сілтеу мен кепілдік тілін алып тастау керек.
- «Бұл қаржылық кеңес емес» және реттеуші ескертулер міндетті болып табылады.
Қолданбалы тапсырма
Ақылды келісімшарт функциясын алыңыз. AI-ға «NatSpec жасау» шақыруын беріңіз және жасалған интерпретацияны кодтың нақты әрекетімен сызық бойынша салыстырыңыз - келіспеушіліктер бар ма? Содан кейін бірдей функция үшін «техникалық-қарапайым аударма» және «қауіп/ескерту бөлімі» жасаңыз. Кодқа қайшы келетін AI-ның кем дегенде бір мәлімдемесін табыңыз және түзетіңіз.
бақылау парағы
- [ ] Мен әрбір техникалық шағымды нақты кодпен растадым.
- [ ] Мен асыра сілтеулерді/кепілдіктерді алып тастадым.
- [ ] Тәуекелдерді адал жазып, оларды бөлектеп бердім.
- [ ] Мен AI-ға нақты механизмді бердім; Мен оған ойдан шығаруға рұқсат бермедім.
- [ ] Мен «Бұл қаржылық кеңес емес» деген ескертуді қостым.
- [ ] Мен көлік пен басқару үшін толық NatSpec жаздым.
- [ ] Мен құжаттаманы кодпен синхрондауды жоспарладым.