Qazanclar:
- Whitepaper, NatSpec, texniki-sadə tərcümə və riskin açıqlanması və bunun ən məhsuldar sahə olduğunu anlamaq üçün süni intellektdən etibarlı şəkildə istifadə edə bilmək.
- Yanlış sənədləşdirmə riskinin qarşısını almaq üçün hər bir texniki iddianı faktiki kodla yoxlamaq və şişirtmə və zəmanət dilini aradan qaldırmaq imkanı
- Riskləri vicdanla qəbul etmək bacarığı, "maliyyə məsləhəti deyil" xəbərdarlığı və sənədləşmə kodu ardıcıllığı
Web3-də sənədləşmə lüks deyil, təhlükəsizlik və etibar məsələsidir. Ağıllı müqavilə ilə qarşılıqlı əlaqə quraraq, istifadəçi real pulunu riskə atır; Nə etdiyini başa düşmürsə, aldanmağa açıqdır. Auditor yaxşı sənədləşdirilməmiş kodu təhlükəsiz şəkildə nəzərdən keçirə bilməz. Bu bölmədə biz AI-nin ən etibarlı və səmərəli olduğu sahəni əhatə edirik: sənədləşmə və texniki yazı. Rəqəm kağızından koddaxili şərhlərə, istifadəçi təlimatından risk açıqlamalarına qədər, AI burada həqiqi güc çarpanıdır - dəqiqliyə insani şəkildə nəzarət edildiyi müddətcə.
Web3 sənədlərinin növləri
- Whitepaper / Litepaper: Layihənin vizyonunu, mexanizmini və tokenomikasını təsvir edən əsas sənəd.
- Texniki sənədlər: Müqavilə interfeysləri, tərtibatçılar üçün inteqrasiya təlimatı.
- NatSpec (Ethereum Təbii Dil Spesifikasiyası — Funksiyaların nə etdiyini təsvir edən Solidity-də standart koddaxili şərh formatı): Koda daxil edilmiş sənədlər, həm insan, həm də alət tərəfindən oxunur.
- İstifadəçi təlimatı: Son istifadəçiyə "necə istifadə etməli, hansı risklər var" deyən düz mətn.
- İmtina: Qanuni və etik cəhətdən tələb olunan xəbərdarlıqlar.
Bu növlərdə ümumi problem: tərtibatçılar yazmağı sevmirlər və çox vaxt bunu son ana buraxırlar. Süni intellekt məhz bu boşluğu doldurur.
Niyə sənədləşmə AI-nin ən təhlükəsiz sahəsidir?
Sənədləşmədə səhvin dəyəri auditdən daha aşağıdır: bir səhv cümlə düzəldilir, pul uçmur (birbaşa). Bundan əlavə, AI təbii olaraq dil istehsalında güclüdür. Beləliklə, AI burada həm səmərəli, həm də nisbətən təhlükəsizdir. Lakin iki kritik risk qalır:
- Yalan texniki iddia: AI kodun nə etdiyini təhrif edə bilər; Bu, istifadəçini çaşdırır və təhlükəsizlik zəifliyinə çevrilə bilər ("bu funksiya sizin vəsaitlərinizi qoruyur" deməsə və etməsə).
- Hiperbola/marketinq dili: Süni intellekt layihəni təhlükəsiz və ya gəlirli kimi göstərən dil yarada bilər; Bu həm etik, həm də hüquqi problemdir.
Diqqət: Sənədlər kodu təsvir edir; Bu kodun özü deyil. Süni intellektin yazdığı ("bu olur", "saxlayan") hər bir texniki təsdiq faktiki kodla təsdiqlənməlidir. Yanlış sənədlər düzgün koddan daha təhlükəli ola bilər, çünki istifadəçi sənədlərə etibar edir.
Sənədlərdə AI-dən istifadə səviyyələri
1. NatSpec nəsli. Süni intellekt mövcud funksiyanı oxuyur və NatSpec şərhini tərtib edir: nə edir, onun parametrləri nədir, nə qaytarır. Bu, yoxlama və təmiri asanlaşdırır.
2. Texniki-sadə tərcümə. Süni intellekt mürəkkəb mexanizmi son istifadəçinin başa düşə biləcəyi dilə tərcümə edir – bu Web3-ün ən böyük ehtiyaclarından biridir.
3. Ağ kağızın konturları və strukturu. Süni intellekt ağ kağızın skeletini və bölmələrini istehsal edir; Məzmun dəqiqliyi insana aiddir.
4. Çoxdillilik və səviyyəyə uyğunlaşma. Süni intellekt həm türk, həm də ingilis dillərində həm texniki, həm də sadə məzmun yarada bilər.
Zəif məlumat / Güclü göstəriş
Zəif çağırış:
Bu layihə üçün ağ kağız yazın.
Süni intellekt faktiki mexanizmi bilmədən şişirdilmiş, ehtimal ki, yalan və marketinqlə dolu surəti təşkil edir.
Güclü göstəriş:
Rolunuz: Web3 texniki yazıçısı. Aşağıda layihənin REAL mexanizmi, tokenomikası və kodu verilmişdir. Yalnız bu məlumat əsasında ağ kağızın layihəsini yazın. Qaydalar:- Şişirtməyin, “zəmanətli mənfəət”, “tamamilə təhlükəsiz” və s. kimi ifadələrdən istifadə etməyin.- Hər bir texniki iddianı verdiyim mexanizmə əsaslandırın; Uydurma əlavə etməyin.- Riskləri açıq şəkildə ifadə edən “Risklər” bölməsini əlavə edin.- “Bu maliyyə məsləhəti deyil” xəbərdarlığını əlavə edin. Əmin olmadığınız və ya məndə olmayan hər hansı məlumatı [DOLDURULACAQ] olaraq qeyd edin.
Dörd kopyalana bilən şablon
1) NatSpec nəsli:
Aşağıdakı funksiyaya standart NatSpec şərhlərini yazın: @notice (nə edir, düz), @dev (texniki qeyd), @param və @return. Yalnız kodun əslində nə etdiyini yazın; Kodda olmayan davranışın əlavə edilməsi. Əmin olmadığınız effekti qeyd edin.
2) Texniki-sadə tərcümə:
Kriptovalyutanı təcrübəsiz bir istifadəçinin anlaya biləcəyi bu mexanizmi sadə türkcə izah edin: o nə edir, istifadəçi nə etməlidir, NƏ RİSKLƏR VAR? Mübaliğə; təhlükəsizliyinə zəmanət yoxdur. Riskləri gizlətməyin, onları ön plana çıxarın.
3) Risk/xəbərdarlıq bölməsi:
Bu layihə üçün dürüst "Risklər və xəbərdarlıqlar" bölməsini yazın: ağıllı müqavilə riski, bazar riski, likvidlik riski, tənzimləyici qeyri-müəyyənlik, əsas itki. Hər bir riski sadə dillə izah edin. Riskləri qiymətləndirməyin; "bu maliyyə məsləhəti deyil" ilə bitir.
4) Sənəd kodunun uyğunluğunun yoxlanılması:
Aşağıda funksiya və onun mövcud sənədləri var. Sənədin kodun AKTUAL davranışı ilə ziddiyyət təşkil etdiyi və ya buraxdığı yerləri qeyd edin. Yekun qərarın qəbulu; Onu "geliştirici yoxlaması" üçün təqdim edin.
Üç mini iş (rəqəmlə)
Case 1 - NatSpec yoxlamanı gücləndirdi. Bir komanda 25 funksiyalı müqaviləni şərhsiz nəzərdən keçirmək üçün təqdim etdi; Auditor məntiqi başa düşmək üçün əlavə vaxt istədi. Komanda AI ilə NatSpec qaralamalarını hazırladı və hər birini kodla təsdiqlədi; Auditə hazırlıq demək olar ki, 1 günə qısaldıldı. Dərs: yaxşı sənədləşdirmə audit xərclərini azaldır.
İş 2 - Yalan iddia tutuldu. YZ-nin hazırladığı istifadəçi təlimatında deyilirdi ki, “pulunuz istənilən vaxt çıxarıla bilər”; halbuki müqavilədə 7 günlük kilid var idi. Texniki baxış bunu tutdu. Əgər yayımlansaydı, istifadəçilər səhvə düşəcək və qurban olacaqlar. Dərs: hər bir texniki iddia kodla təsdiqlənir.
3-cü vəziyyət - Mübaliğə aradan qaldırıldı. İlk ağ kağız layihəsində AI "risksiz yüksək gəlir" kimi ifadələrdən istifadə etdi. Komanda bunları aradan qaldırdı və dürüst risk bölməsi əlavə etdi. Bu, layihəni həm etik, həm də hüquqi cəhətdən qorudu. Dərs: AI-nin marketinq meyli yoxlanılmalıdır.
Sənədləşmənin etik yükü
Web3 sənədləri istifadəçinin pullarını riskə atdığı kontekstdə oxunur. Buna görə də:
- Dürüstlük: Riskləri gizlətmək olmaz və şişirdilmiş vədlər vermək olmaz.
- Dəqiqlik: Texniki iddialar koda uyğun olmalıdır; “Sənəddə belə deyilir” ifadəsi müdafiə deyil, əksinə, təhrifdir.
- Əlçatanlıq: İstifadəçinin həqiqətən başa düşdüyü dildə yazmaq təhlükəsizlik tədbiridir; Anlaşılmayan sənəd aldatmağa dəvətdir.
- İmtina: Aydın şəkildə qeyd edilməlidir ki, bu, maliyyə məsləhəti və tənzimləyici qeyri-müəyyənlik deyil.
İpucu: Web3 sənədinin dürüstlük testi: "İstifadəçi yalnız bu sənədə etibar edərək pul qoyarsa, həqiqətlə qarşılaşdıqda özünü aldanmış hiss edəcəkmi?" Süni intellekt həmişə risk hissəsini vurğulasın, sonunda onu basdırmayın.
Ümumi səhvlər
- Texniki iddianın kodla təsdiqlənməməsi. Səhv sənəd istifadəçini çaşdırır.
- Şırınga/marketinq dilini atmaq. Etik və hüquqi risk.
- Riskləri minimuma endirmək və ya gizlətmək. Etibarın pozulması.
- Əsl mexanizmi AI-yə vermədən ağ kağızı çap etmək. Uydurma istehsal edir.
- "Maliyyə məsləhəti deyil" xəbərdarlığına məhəl qoymamaq. Hüquqi öhdəlik.
- Sənədləri kodla sinxronlaşdırmamaq. Kod dəyişdikdə, sənəd yanıltıcı olur.
Xülasə
- Sənədləşmə Web3-də təhlükəsizlik və etibar məsələsidir; Bu, AI-nin ən məhsuldar sahəsidir.
- Səhvlərin qiyməti nisbətən aşağıdır, lakin yanlış texniki iddialar və şişirtmə ciddi risklərdir.
- Hər bir texniki iddia real kodla təsdiqlənməlidir; Sənəd kodu əvəz etmir.
- Risklər dürüst və nəzərə çarpan şəkildə yazılmalıdır; Şişirtmə və zəmanət dili aradan qaldırılmalıdır.
- “Bu, maliyyə məsləhəti deyil” və tənzimləyici xəbərdarlıqlar məcburidir.
Tətbiq tapşırığı
Ağıllı müqavilə funksiyası əldə edin. Süni intellektə "NatSpec yaradın" əmrini verin və yaradılan şərh xəttini kodun faktiki davranışı ilə müqayisə edin - hər hansı fikir ayrılığı varmı? Sonra eyni funksiya üçün "texniki-düz tərcümə" və "risk/xəbərdarlıq bölməsi" hazırlayın. Şişirdilmiş və ya kodla ziddiyyət təşkil edən AI-nin ən azı bir ifadəsini tapın və düzəldin.
yoxlama siyahısı
- [ ] Mən hər bir texniki iddianı faktiki kodla təsdiqlədim.
- [ ] Mübaliğələri/zəmanətləri sildim.
- [ ] Riskləri vicdanla yazdım və onları vurğuladım.
- [ ] AI-yə əsl mexanizmi verdim; Mən ona uydurmağa imkan vermədim.
- [ ] “Bu maliyyə məsləhəti deyil” xəbərdarlığını əlavə etdim.
- [ ] Nəqliyyat və idarəetmə üçün NatSpec-i tam olaraq yazdım.
- [ ] Sənədləri kodla sinxronlaşdırmağı planlaşdırdım.