Ինչպես գրել հուշումներ AI հավելվածների կառուցողների համար (նախքան և հետո օրինակներով)
AI հավելվածների կառուցողի լավ հուշումը նկարագրում է արտադրանքը, ոչ թե կոդը. ով է օգտագործում, քայլ առ քայլ ինչ են անում, ինչ տվյալներ է պահում և ում թույլատրված է ինչ տեսնել։ Առաջին տարբերակը գոյություն ունենալուց հետո յուրաքանչյուր հաղորդագրությամբ խնդրեք մեկ կոնկրետ փոփոխություն, ասեք, թե ինչ պետք է մնա նույնը, և խնդիրները նկարագրեք այսպես. «Ես արեցի X, սպասում էի Y, ստացա Z»։ Այս երեք սովորությունը շտկում է հիասթափեցնող արդյունքների մեծ մասը։
Ուղեցույցի մնացած մասը մանրամասն ցույց է տալիս այս եղանակները, նախքան և հետո օրինակներով, որոնք կարող եք հարմարեցնել։
Ինչու AI հավելվածի կառուցողին հուշելը տարբերվում է AI-ի հետ զրուցելուց
Երբ հարցնում եք զրուցակից օգնականին, անորոշ հուշումը տալիս է անորոշ պատասխան, և դուք առաջ եք գնում։ Երբ հուշում եք AI հավելվածների կառուցողին, պատասխանը աշխատող ծրագիր է։ Նկարագրության յուրաքանչյուր բաց վայր լցվում է ենթադրությամբ, և այդ ենթադրությունները դառնում են կոդ, տվյալների աղյուսակներ և էկրաններ, որոնց հետ հետո պետք է ապրեք կամ դրանք ետ վերցնեք։
Ուստի հուշման նպատակը խելացի հնչելը չէ։ Այն նպատակ ունի նվազեցնել կարևոր որոշումների թիվը, որոնք թողնված են պատահականությանը։ Դրա համար տեխնիկական բառապաշար պետք չէ։ Պետք է կոնկրետ լինել այն բաների մասին, որոնք միայն դուք գիտեք. ձեր օգտատերերը, աշխատանքային հոսքը և կանոնները։
Ինչ ներառել առաջին հուշման մեջ
Մինչև որևէ բան գրելը, պատասխանեք այս հարցերին։ Յուրաքանչյուրը փակում է բացը, որում AI-ն հակառակ դեպքում կենթադրեր։
| Ներառել | Ինչու է կարևոր | Օրինակ |
|---|---|---|
| Արտադրանքը մեկ նախադասությամբ | Սահմանում է շրջանակը յուրաքանչյուր հետագա որոշման համար | «Ամրագրման կայք երկու աթոռանոց վարսավիրանոցի համար» |
| Ով է օգտագործում | Որոշում է էկրանները և տոնը | «Առանց ամրագրման եկող հաճախորդները հեռախոսներով, իսկ սեփականատերը՝ նոութբուքով» |
| Հիմնական հոսքը, քայլ առ քայլ | Այն, ինչ պետք է առաջինը աշխատի | «Ընտրել ծառայություն, ընտրել ժամ, մուտքագրել անունը և հեռախոսահամարը, ստանալ հաստատում» |
| Տվյալները, որ պահում է | Դառնում է տվյալների բազայի նախագիծը | «Ծառայություններ, ամրագրումներ, հաճախորդներ» |
| Ով կարող է տեսնել կամ փոխել ինչ | Որոշում է մուտքը և թույլտվությունները | «Միայն սեփականատերը տեսնում է բոլոր ամրագրումները» |
| Տեսք և զգացողություն, համառոտ | Խուսափում է ընդհանուր լռելյայն ոճից | «Մութ, պարզ, մեծ կոճակներ» |
| Ինչ թողնել այս պահին | Պահում է առաջին տարբերակը փոքր | «Դեռ առանց վճարումների և գնահատականների» |
Վերջին տողը ցածր է գնահատվում։ Ասելը, թե ինչ չեք ուզում, կանգնեցնում է AI-ին ավելացնել բլոգ, գնային էջ և լրատվական բաժանորդագրություն, որոնք երբեք չեք խնդրել։
Նախքան և հետո. առաջին հուշումը
Նախքան.
Ինձ համար մի հավելված արա մարզասրահի համար։
Կառուցողը պետք է ամեն ինչ կռահի. անդամներ՝ թե աշխատակիցներ։ Դասեր՝ թե անհատական մարզում։ Վճարումներ։ Կստանաք մի բան, որը նման է մարզասրահի կայքի և չի անում այն, ինչ ձեզ պետք է։
Հետո.
Կառուցիր դասերի ամրագրման հավելված փոքր յոգայի studio-ի համար։ Անդամները տեսնում են այս շաբաթվա դասերը (անուն, դասավանդող, ժամ, մնացած տեղեր), ամրագրում են տեղ և կարող են չեղարկել մինչև դասի սկսվելը երկու ժամ առաջ։ Անդամները գրանցվում են էլ. փոստով և գաղտնաբառով։ Studio-ի սեփականատերը մուտք է գործում՝ դասեր ավելացնելու, տեսնելու, թե ով է ամրագրել, և նշելու ներկայությունը։ Դասերը, անդամներին և ամրագրումները պահեք տվյալների բազայում։ Հանգիստ, բաց դիզայն, որ լավ է աշխատում հեռախոսներում։ Վճարումներ դեռ չկան։
Երկրորդ տարբերակը դեռ կարճ է։ Այն պարզապես պատասխանում է վերևի աղյուսակի հարցերին։
Նկարագրեք վարքագիծը, ոչ թե իրականացումը
Շատ անգամ ավելի լավ արդյունք կստանաք, եթե նկարագրեք, թե ինչ պետք է տեղի ունենա, այլ ոչ թե ինչպես կառուցել։
Նախքան.
Ավելացրու useEffect, որը բերում է ամրագրումները, և մոդալ կոմպոնենտ խմբագրման համար։
Հետո.
Երբ սեփականատերը սեղմում է ամրագրման վրա, բացվում է վահանակ, որտեղ նա կարող է փոխել ժամը կամ չեղարկել այն։ Փոփոխությունները պետք է անմիջապես երևան ցուցակում։
Առաջին հուշումը AI-ին կողպում է կոնկրետ եղանակի վրա, որը կարող է չհամապատասխանել հավելվածի կառուցվածքին։ Երկրորդը նրան ասում է արդյունքը և թույլ է տալիս ընտրել ճիշտ մոտեցումը արդեն գրած կոդի համար։ Եթե դուք մշակող եք և ունեք ուժեղ նախընտրություն, ասեք այն, բայց զուգակցեք արդյունքի հետ։
Եղեք կոնկրետ կանոնների վերաբերյալ
Բիզնես կանոնները այն տեղն են, որտեղ AI-ով կառուցված հավելվածները ամենից հաճախ սխալվում են, քանի որ դրանք ակնհայտ են ձեզ համար և անտեսանելի՝ AI-ի համար։ Գրեք դրանք հստակ։
- Սահմանափակումներ. «Անդամը միաժամանակ կարող է ունենալ առավելագույնը երեք ապագա ամրագրում»։
- Ժամանակացույց. «Չեղարկումները փակվում են դասի սկսվելուց երկու ժամ առաջ»։
- Եզրային դեպքեր. «Եթե դասը լրացված է, ցույց տվեք սպասման ցուցակի կոճակ՝ Book-ի փոխարեն»։
- Թույլտվություններ. «Դասավանդողները տեսնում են իրենց դասերի ներկայությունը, բայց ոչ այլ դասավանդողների»։
Սրանցից յուրաքանչյուրը մեկ նախադասություն է։ Եթե որևէ մեկը բաց թողնեք, հավելվածը կա՛մ չի կիրառի կանոնը, կա՛մ կհորինի իր սեփական տարբերակը։
Առաջին տարբերակից հետո. մեկ փոփոխություն մեկ հաղորդագրությամբ
Երբ նախադիտման մեջ ինչ-որ բան աշխատում է, անցեք ամբողջ արտադրանքը նկարագրելուց՝ փոքր, ստուգելի փոփոխություններ խնդրելուն։
Նախքան.
Դիզայնը սխալ է, ամրագրումը լավ չի աշխատում, և ուզում եմ օրացույցի տեսք և էլ. նամակներ։
Հետո (չորս առանձին հաղորդագրություն).
- Երբ ամրագրում եմ դասի վերջին տեղը, դասը դեռ ցույց է տալիս «1 տեղ մնաց»։ Պետք է ցույց տա «Լրացված» և թաքցնի Book կոճակը։
- Ավելացրու շաբաթական տեսքի օրացույց ժամանակացույցի էջում, յուրաքանչյուր օրը՝ առանձին սյունակ։ Պահիր ընթացիկ ցուցակի տեսքը որպես տարբերակ։
- Դասերի քարտերը հեռախոսներում ավելի կոմպակտ դարձրու. ավելի փոքր ներքին եզրեր, դասավանդողի անունը նույն տողում ժամի հետ։
- Ամրագրելիս անդամին ուղարկիր հաստատման էլ. նամակ։
Ինչու է սա աշխատում.
- Յուրաքանչյուր փոփոխությունը բավականաչափ փոքր է, որ AI-ն մեկ անցումով ճիշտ անի։
- Կարող եք փորձարկել յուրաքանչյուրը, նախքան առաջ գնալը։
- Եթե մեկը սխալվի, կարող եք հետ գլորել միայն այդ քայլը՝ առանց մյուսները կորցնելու։
Ասեք, թե ինչ պահել
Երբ խնդրում եք փոփոխություն այն բանի համար, որ արդեն աշխատում է, ասեք AI-ին, թե ինչ չպետք է փոխվի։ Սա կանգնեցնելու ամենապարզ եղանակն է ռեգրեսիաների (այն, ինչ նախկինում աշխատում էր, փոփոխությունից հետո կոտրվում է)։
Վերանախագծիր գլխավոր էջի վերնագրի հատվածը՝ ավելի մեծ վերնագրով և նկարով աջ կողմում։ Պահիր նավիգացիան, գույները և վերնագրից ներքև ամեն ինչ ճիշտ այնպես, ինչպես կա։
Նույնը վերաբերում է տվյալներին. «Ավելացրու հեռախոսահամարի դաշտ անդամներին։ Մի հեռացրու և մի վերանվանիր գոյություն ունեցող դաշտերը»։
Օգտագործեք սքրինշոթեր և ճշգրիտ տեքստ
Նման բառերը, ինչպիսին է «վերևում գտնվող բանը», երկիմաստ են։ Շատ AI հավելվածների կառուցողներ ընդունում են պատկերներ, և սքրինշոթը կարճ նշումով ավելի արագ է, քան նկարագրության պարբերությունը։
- Կցեք սքրինշոթ և ասեք. «կարմիրով շրջանակված կոճակը հեռախոսներում համընկնում է ընտրացանկի հետ»։
- Տեղադրեք ցանկացած սխալ հաղորդագրության ճշգրիտ տեքստը, այլ ոչ թե վերաձևակերպեք այն։
- Մեջբերեք էկրանի պիտակները ճշգրիտ. «Save changes կոճակը Settings էջում»։
Սխալների համար կոնկրետ այս ձևը օգտագործեք.
Ամրագրումների էջում սեղմեցի Cancel՝ վաղվա ամրագրման համար։ Սպասում էի, որ այն կանհետանա իմ ցուցակից։ Փոխարենը ոչինչ չեղավ, և էջը թարմացնելուց հետո ամրագրումը դեռ կա։ Շտկիր և ստուգիր, որ չեղարկումը աշխատում է։
Մեր ուղեցույցը ինչպես վրիպազերծել AI-ով կառուցված հավելվածը այս մասին ավելի խորն է անդրադառնում։
Մեծ փոփոխությունների համար նախ պլանավորեք
Երբ փոփոխությունը շատ մասերի վրա է ազդում հավելվածում՝ օգտատիրոջ հաշիվներ ավելացնելը այնպիսի հավելվածի, որը չուներ, վճարումներ ավելացնելը, տվյալների կառուցվածքի փոփոխությունը, խնդրեք պլան, նախքան որևէ կոդ փոխելը։
Նախքան որևէ բան փոխելը բացատրիր, թե ինչպես կավելացնես թիմային հաշիվներ. ինչ նոր աղյուսակներ, որ էջեր կփոխվեն և ինչ կլինի գոյություն ունեցող օգտատերերի հետ։ Դեռ մի խմբագրիր կոդը։
Կարդացեք պլանը։ Եթե այն ինչ-որ բան սխալ է հասկացել, մեկ պարբերությունը շտկելը շատ ավելի էժան է, քան պատրաստի գործառույթը շտկելը։ Շատ կառուցողներ ունեն այս համար նվիրված ռեժիմ. Mythex-ում դա Plan ռեժիմն է, Build-ի և Ask-ի կողքին։
Ինչից խուսափել
| Խուսափեք | Ինչու | Փոխարենը |
|---|---|---|
| «Դարձրու ավելի լավ» / «Դարձրու աչքի ընկնող» | Թիրախ չկա, AI-ն պատահականորեն փոխում է բաներ | Նշեք փոփոխությունը. «ավելի շատ դատարկ տարածություն բաժինների միջև, մեծ վերնագրեր» |
| Մեկ հսկայական հուշում տասը գործառույթով | Սխալները կուտակվում են, դժվար է փորձարկել | Մեկ գործառույթ մեկ հաղորդագրությամբ |
| API բանալիների տեղադրում զրույցում | Բանալիները հայտնվում են զրույցի պատմության մեջ | Օգտագործեք կառուցողի գաղտնիքները կամ միջավայրի կարգավորումները |
| Վիճել կոտրված արդյունքի հետ | Յուրաքանչյուր շտկում դրվում է սխալի վրա | Հետ գլորեք, ապա ձևակերպեք ավելի լավ |
| Նշել կոդ, որը չեք հասկանում | Ամրացնում է վատ համապատասխանություն | Նկարագրեք ցանկալի վարքագիծը |
| Խնդրել «ձեռնարկության մակարդակի անվտանգություն» | Կոնկրետ բան չի նշանակում | Թվարկեք իրական կանոնները. ով ինչ կարող է տեսնել |
ԱՊԻ բանալիների մասին. եթե ձեզ պետք է վճարման կամ էլ. փոստի ծառայություն, դրա բանալիները դրեք նախագծի գաղտնիքներում, այլ ոչ թե հուշման մեջ։ Եթե սա նոր է, տես ինչ են միջավայրի փոփոխականները և գաղտնիքները։
Վերօգտագործելի հուշման ձևանմուշներ
Հարմարեցրեք սրանք՝ փոխարինելով փակագծերում եղած մասերը։
Նոր հավելված.
Կառուցիր [հավելվածի տեսակ] [ում] համար։ Նրանք [հիմնական հոսքը, քայլ առ քայլ]։ [Երկրորդ տեսակի օգտատեր] մուտք է գործում՝ [ինչ են անում]։ Պահիր [տվյալները] տվյալների բազայում։ [Տեսք և զգացողություն]։ Թողիր [ինչ-որ բան հետագայի համար]։
Նոր գործառույթ.
Ավելացրու [գործառույթ] [էջին]։ Երբ [օգտատերը] կատարում է [գործողություն], [ինչ պետք է լինի]։ Միայն [ով] կարող է [անել դա]։ Պահիր [գոյություն ունեցող բաները] ինչպես կան։
Դիզայնի փոփոխություն.
[Էջի] վրա փոխիր [կոնկրետ տարր] [կոնկրետ փոփոխության]։ Պահիր [ինչ պահել]։ Ստուգիր, որ լավ է երևում հեռախոսի լայնության էկրանին։
Սխալ.
[Էջում] ես [քայլեր]։ Սպասում էի [սպասվածը]։ Փոխարենը [իրականը, և ճշգրիտ սխալի տեքստը]։ Շտկիր և ստուգիր, որ հոսքը աշխատում է։
Հարց՝ առանց փոփոխության.
Ոչ մի կոդ մի փոխիր։ Բացատրիր, թե [հավելվածի մասը] ինչպես է աշխատում և [տվյալները] որտեղ են պահվում։
Ավելի երկար ճշտում գրելը
Մեծ նախագծերի համար կարող է օգնել նախ գրել մեկ էջանոց նկարագիր և այն տեղադրել որպես սկզբնական հուշում. օգտատերերը, հիմնական հոսքերը, տվյալները, կանոնները և այն, ինչ դուրս է շրջանակից։ Կարող եք նույնիսկ AI-ի օգնությամբ նախագծել այն. մեր ուղեցույցը՝ ինչպես գրել արտադրանքի պահանջների փաստաթուղթ AI-ով, բացատրում է եղանակը։ Պարզապես պահեք առաջին կառուցման հարցումը հիմնական հոսքի սահմաններում և մնացածը ավելացրեք քայլ առ քայլ։
Հուշում Mythex-ում
Վերևում ամեն ինչ աշխատում է Mythex-ում։ Մի քանի մասնավորություն, որոնք օգնում են.
- Build, Plan և Ask ռեժիմներ։ Օգտագործեք Plan մեծ կամ ռիսկային փոփոխությունների համար, իսկ Ask՝ երբ ուզում եք բացատրություն՝ առանց խմբագրումների։
- Ստուգակետեր։ Յուրաքանչյուր հաջող փոփոխությունից հետո Mythex-ը պահում է ստուգակետ, և պատասխանի վրա Revert to this point-ը հետ է գլորում նախագիծը։ Կարող եք նաև խմբագրել նախորդ հաղորդագրությունը և նորից ուղարկել՝ այդ կետից տարբեր հուշում փորձելու համար։
- Գաղտնիքների քարտ։ Երբ գործակալին պետք է API բանալի, նա հարցնում է զրույցում քարտի միջոցով, որպեսզի արժեքը պահվի որպես նախագծի գաղտնիք, այլ ոչ թե գրվի ձեր հաղորդագրության մեջ։
- Պատկերներ։ Կցեք սքրինշոթներ կամ մակետներ, և գործակալը դրանք կդիտարկի։
Փաստաթղթերում կա կարճ էջ արդյունավետ հուշումների մասին և մեկ այլ՝ վերակառուցումից խուսափելով կրկնելու մասին։ Եթե սկսում եք զրոյից, ինչպես կառուցել հավելված AI-ով ուղեցույցը ամբողջական նախագիծն է ներկայացնում, իսկ ինչպես դիզայն անել գեղեցիկ հավելված AI-ով-ը ծածկում է վիզուալ հղկման հուշումները։
Հարցեր
Որքա՞ն պետք է լինի AI հավելվածների կառուցողի հուշումը։
Առաջին տարբերակի համար սովորաբար բավական է չորս-ութ նախադասությամբ կարճ պարբերություն. ով է օգտագործում հավելվածը, հիմնական հոսքը, ինչ տվյալներ է պահում և ով ինչ կարող է տեսնել։ Դրանից հետո ավելի լավ են աշխատում կարճ հուշումները, որոնք մեկ անգամ մեկ փոփոխություն են խնդրում, քան երկար հուշումները։
Պե՞տք է AI-ին ասեմ, թե որ ֆրեյմվորքը կամ լեզուն օգտագործի։
Միայն եթե ունեք պատճառ, օրինակ՝ մշակող, որը կվերցնի կոդը, կամ ծառայություն, որն աշխատում է միայն մեկ տեխնոլոգիական կույտով։ Հակառակ դեպքում նկարագրեք արտադրանքը և թույլ տվեք կառուցողին ընտրել խելամիտ լռելյայն տարբերակները։
Ինչու՞ AI-ն շարունակում է փոխել այն, ինչ չեմ խնդրել փոխել։
Սովորաբար որովհետև հուշումը լայն էր («դարձրու ավելի լավը») կամ չէր ասում, թե ինչ պահել։ Նշեք հստակ այն, ինչ փոխել, ասեք, թե ինչ պետք է մնա նույնը, և յուրաքանչյուր հաղորդագրությամբ խնդրեք մեկ փոփոխություն։
Ավելի լավ է վատ արդյունքը շտկել լրացուցիչ հուշումներով, թե նորից սկսել։
Եթե վերջին փոփոխությունը վատթարացրեց իրավիճակը, վերադարձեք դրանից առաջ եղած տարբերակին և ձևակերպեք ավելի լավ, այլ ոչ թե շտկումները դնեք վրա։ Նոր նախագիծ սկսեք միայն այն դեպքում, երբ փոխվել է հենց գաղափարը։