Mwongozo wa Kutengeneza Tovuti: Fanya Codex Iunde, Irekebishe na Ikabidhi Tovuti kwa Uaminifu Zaidi

Mwongozo wa Kutengeneza Tovuti ni nini

“Mwongozo wa Kutengeneza Tovuti · Website Playbook” ni mbinu ya kazi inayolenga wasaidizi wa AI wa kutengeneza tovuti. Toleo la sasa ni 2.0.1, na limehakikiwa hasa katika mazingira ya Codex. Si mfumo wa tovuti, CMS au jukwaa la upangishaji, bali ni seti ya kanuni za utekelezaji zinazomsaidia Agent kuelewa mahitaji kwa usahihi, kukagua utekelezaji wa marejeo, kulinda mradi uliopo na kukamilisha ukaguzi pamoja na makabidhiano.

Inafaa kwa tovuti binafsi, jalada la kazi, tovuti za utafiti na mashirika, tovuti za maudhui, na pia kwa kuboresha au kurekebisha sehemu za tovuti zilizopo. Mbali na mtiririko mkuu wa kazi, mradi huu unatoa uzoefu 16 usio na taarifa binafsi, pamoja na violezo viwili: muhtasari wa mradi na makabidhiano ya tovuti.

Uwezo mkuu na kanuni za kazi

Kudhibiti mipaka ya mahitaji

Mwongozo wa Kutengeneza Tovuti unahitaji kutofautisha aina tatu za taarifa: mahitaji yaliyotajwa wazi na mtumiaji, maelezo ya utekelezaji yanayohitajika ili kukamilisha kazi, na mapendekezo yanayoweza kujadiliwa lakini hayajathibitishwa. Hii hupunguza tatizo la AI kuongeza sehemu, vipengele au maandishi bila ruhusa.

Kwanza kagua utekelezaji wa marejeo

Unaweza kuanza kwa kutafuta msukumo wa usanifu kwenye Awwwards, kisha utembelee tovuti halisi ya kazi hiyo ili kukagua msimbo unaoweza kufikiwa na mwingiliano halisi. Marejeo ya mwonekano hayapaswi kuishia kwenye picha za skrini; unapaswa pia kuthibitisha jinsi menyu, usogezaji, miondoko na tabia ya mwonekano unaobadilika zinavyofanya kazi.

Linda toleo lililoidhinishwa

Kabla ya kurekebisha tovuti iliyopo, tambua kwanza mradi na msingi sahihi, kisha bainisha maudhui yanayopaswa kuhifadhiwa pamoja na mabadiliko ambayo bado hayajawasilishwa. Bila uthibitisho, usifute moja kwa moja toleo ambalo mtumiaji tayari amelidhinisha.

Kagua matumizi halisi

Ukaguzi si kuthibitisha tu kwamba ukurasa unaweza kufunguka. Kulingana na wigo wa kazi, unapaswa kuangalia mwonekano wa simu, uendeshaji kwa kibodi, hali za menyu, mchakato wa miondoko na hali za hitilafu, huku ukiandika wazi ni vipengele gani vimejaribiwa na ni vipi bado havijathibitishwa.

Acha njia ya matengenezo

Unapokabidhi tovuti, eleza maudhui yanasasishwa wapi, mabadiliko yanaanza kutumika lini, jinsi ya kuchapisha na jinsi ya kurejesha toleo la awali tatizo linapotokea. Kwa njia hii, matokeo yaliyokabidhiwa yanaweza kuendelea kutunzwa badala ya kutegemea mtekelezaji wa sasa pekee.

Maandalizi kabla ya kusakinisha

Kabla ya kutumia Skill hii, unahitaji mazingira ya ndani yanayoweza kutumia Skill. Mradi mahususi wa tovuti pia unahitaji maudhui, mazingira ya usanidi, ruhusa za zana na masharti ya ukaguzi yanayofaa. Kwa kuwa mradi huu umehakikiwa hasa katika Codex, README hauahidi uoanifu kamili na majukwaa yote ya AI.

Unaweza kusoma maelezo ya toleo v2.0.1, au kupakua moja kwa moja kifurushi kamili cha Skill v2.0.1.

Njia ya kwanza: Mwache Codex isakinishe Skill

Wasilisha amri ifuatayo kwa Codex. Amri hii inasisitiza kwamba inapokutana na toleo lenye jina lilelile, kwanza ikague mabadiliko maalum ili kuepuka kufuta maudhui yaliyopo moja kwa moja.

Tumia skill-installer kusakinisha Skill hii kutoka https://github.com/7-an/website-playbook/tree/v2.0.1/skills/build-websites-v2.
Ikiwa tayari kuna toleo lenye jina lilelile, kwanza kagua na uhifadhi mabadiliko yangu maalum; usifute yaliyopo moja kwa moja.

Baada ya usakinishaji kukamilika, inashauriwa kuanzisha kazi mpya kabla ya kuitumia Skill hii, ili kuzuia muktadha wa mazungumzo ya awali kuathiri mipaka ya mahitaji.

Njia ya pili: Sakinisha ZIP mwenyewe

1. Pakua kifurushi kamili cha Skill v2.0.1.
2. Fungua faili ya ZIP uliyopakua.
3. Tafuta folda kamili ya build-websites-v2.
4. Weka folda nzima kwenye saraka ya Skill inayotumika kwenye kompyuta yako.
5. Thibitisha kwamba folda na faili zake zote ndogo zimehifadhiwa.

Usinakili SKILL.md pekee. Skill hii pia inategemea README, metadata ya kuitumia, marejeo na rasilimali za violezo.

Kwa maelezo kuhusu usakinishaji na utaratibu wa kutambua Skill, soma maelezo rasmi.

Fahamu muundo wa faili za mradi

skills/build-websites-v2/
├── SKILL.md              # Mahali Agent huanzia utekelezaji
├── README.md             # Usakinishaji, mifano na mipaka ya uwezo
├── agents/openai.yaml    # Metadata ya matumizi
├── references/           # Marejeo 5 ya kutumia inapohitajika, yakiwemo kumbukumbu za uzoefu usio na taarifa binafsi
└── assets/               # Violezo vya muhtasari wa mradi na makabidhiano ya tovuti

SKILL.md ndiyo mahali Agent huanzia utekelezaji, lakini mtindo kamili wa kazi unategemea pia saraka nyingine. references huhifadhi marejeo ya kutumia inapohitajika, huku assets ikiwa na violezo vya muhtasari wa mradi na makabidhiano ya tovuti.

Kuitumia Mwongozo wa Kutengeneza Tovuti kwa mara ya kwanza

Jina la umma la mradi ni “Mwongozo wa Kutengeneza Tovuti”, lakini jina la matumizi lililopo bado ni build-websites-v2 ili kuoanisha watumiaji ambao tayari wameisakinisha. Baada ya usakinishaji, tumia muundo ufuatao katika kazi mpya:

Tumia $build-websites-v2, nisaidie kutengeneza au kurekebisha tovuti.
Lengo: …
Maudhui yaliyopo na njia ya mradi: …
Tovuti ya marejeo na sehemu ninazotaka kuiga: …
Lazima zihifadhiwe: …
Wigo wa awamu hii: uchanganuzi / utekelezaji wa ndani / uchapishaji.

Lengo la muundo huu wa ingizo ni kutenganisha lengo, eneo la mradi, kitu cha marejeo, vipengele vya kulinda na wigo wa utekelezaji. Usiseme tu “nisaidie kuifanya ionekane vizuri zaidi”; taja ukurasa mahususi, matokeo yanayotarajiwa na maeneo ambayo hayapaswi kubadilishwa.

Mfano: Kutengeneza tovuti ya jalada la kazi

Tumia $build-websites-v2, nisaidie kutengeneza tovuti.
Lengo: Kutengeneza tovuti binafsi ya jalada la kazi kwa ajili ya kuonyesha miradi ya utafiti na kazi za usanifu.
Maudhui yaliyopo na njia ya mradi: Mradi uko kwenye saraka maalum ya ndani; maandishi na taarifa za kazi vimepangwa tayari.
Tovuti ya marejeo na sehemu ninazotaka kuiga: Tumia mpangilio wa ukurasa wa kwanza na muundo wa orodha ya miradi wa tovuti maalum kama marejeo; usinakili picha, fonti au msimbo wake.
Lazima zihifadhiwe: Wasifu wangu uliopo na majina ya miradi.
Wigo wa awamu hii: Anza kwa uchanganuzi, kisha utekeleze ndani; usichapishe.

Mfano: Kurekebisha tovuti iliyopo

Tumia $build-websites-v2, nisaidie kurekebisha tovuti.
Lengo: Kurekebisha menyu ya simu ambayo haiwezi kufungwa ipasavyo.
Maudhui yaliyopo na njia ya mradi: Mradi uko kwenye saraka maalum ya ndani.
Tovuti ya marejeo na sehemu ninazotaka kuiga: Hakuna.
Lazima zihifadhiwe: Maudhui ya ukurasa wa kwanza, mtindo wa urambazaji wa kompyuta na mabadiliko ya sasa ambayo hayajawasilishwa.
Wigo wa awamu hii: Utekelezaji wa ndani na ukaguzi unaohusiana; usichapishe.

Mfano wa pili unaweka kazi kwenye marekebisho ya menyu pekee na hauhitaji usanifu upya wa tovuti nzima. Mwongozo wa Kutengeneza Tovuti unaunga mkono kazi za sehemu maalum; si lazima utekeleze mchakato kamili wa kutengeneza tovuti kila mara.

Chagua wigo wa utekelezaji kulingana na kazi

Unapotumia Skill, unaweza kubainisha wigo wa awamu hii kuwa uchanganuzi, utekelezaji wa ndani au uchapishaji, na unaweza pia kuchanganya hatua kadhaa.

• Uchanganuzi pekee: Hutumika kutafiti tovuti ya marejeo, kupanga mahitaji au kukagua mradi uliopo bila kurekebisha msimbo moja kwa moja.
• Utekelezaji wa ndani: Baada ya kuthibitisha mradi na msingi wake, rekebisha tovuti na ufanye ukaguzi wa ndani unaohusiana na kazi.
• Uchapishaji: Unahitaji ruhusa zinazofaa, pamoja na kuthibitisha maudhui ya makabidhiano na hatari kabla ya kuchapisha.
• Marekebisho ya sehemu maalum: Shughulikia menyu, mwingiliano au tatizo lililotajwa pekee ili kuepuka kupanua wigo wa mabadiliko.
• Urejeshaji wa toleo: Bainisha toleo au msingi unaotaka kurejesha huku ukilinda mabadiliko mengine yaliyopo.

Mbinu za matumizi ya juu

Bainisha “cha kuiga”

Unapotoa tovuti ya marejeo, usiwasilishe URL pekee. Eleza ikiwa unataka kuiga mpangilio, ngazi za taarifa, tabia ya menyu, mdundo wa miondoko au sehemu nyingine mahususi. Msimbo unaosomeka hadharani haumaanishi kwamba msimbo, fonti na picha vinaweza kunakiliwa kiholela; kabla ya kuvitumia tena, fuata leseni husika.

Andika vipengele vya kulinda kwenye maelekezo

Ikiwa mradi una toleo lililoidhinishwa, taja wazi kurasa, maandishi, mwingiliano na mabadiliko ambayo hayajawasilishwa lakini lazima zihifadhiwe. Kanuni hiyo hiyo itumike unapoweka toleo la Skill lenye jina lilelile: kwanza kagua tofauti, kisha amua jinsi ya kusasisha badala ya kufuta yaliyopo moja kwa moja.

Omba rekodi ya ukaguzi

Unaweza kumtaka Agent aorodheshe vipengele vilivyojaribiwa baada ya kukamilisha kazi, kama vile mpangilio wa simu, uendeshaji kwa kibodi, kufungua na kufunga menyu, mchakato mzima wa miondoko na hali za hitilafu. Ikiwa kivinjari, msimbo wa marejeo au rasilimali za nje hazipatikani, viweke alama kuwa havijathibitishwa badala ya kudhani vimefaulu.

Fanya makabidhiano kuwa sehemu ya kazi

Ongeza mahitaji ya makabidhiano kwenye maelekezo ili matokeo ya mwisho yaeleze mahali pa kusasisha maudhui, masharti ya kuanza kutumika, hatua za kuchapisha na njia ya kurejesha toleo la awali. Kiolezo cha makabidhiano ndani ya mradi kinaweza kusaidia kupanga taarifa hizi.

Anza kwa uchanganuzi, kisha ruhusu utekelezaji

Wakati marejeo ni magumu, mradi uliopo haujulikani vizuri au hatari ya mabadiliko ni kubwa, unaweza kuanza kwa kuweka wigo kuwa “uchanganuzi pekee”. Baada ya kuthibitisha matokeo ya uchanganuzi na wigo, anzisha utekelezaji wa ndani au kazi ya uchapishaji. Mbinu hii ya hatua kwa hatua husaidia kupunguza hatari ya marekebisho yasiyokusudiwa.

Mipaka ya uwezo na mambo ya kuzingatia

• Mradi huu unatoa mbinu za kazi na kanuni za utekelezaji; hauchukui nafasi ya maudhui ya tovuti, mazingira ya usanidi na ruhusa zinazohitajika.
• Haukulazimishi kutumia mfumo, CMS au jukwaa mahususi la upangishaji.
• Kusakinisha Skill hakumaanishi kupata ruhusa ya kuchapisha tovuti; uchapishaji bado unategemea ruhusa halisi.
• Ikiwa huwezi kufikia msimbo wa marejeo au kivinjari, rekodi vipengele ambavyo havijathibitishwa.
• Maudhui ya umma yana mbinu za jumla, uzoefu usio na taarifa binafsi na violezo tupu pekee; hayana mazungumzo ya awali, nyenzo za wateja, akaunti binafsi au rekodi za ukaguzi wa ndani.
• Mradi huu umehakikiwa hasa katika mazingira ya Codex; uoanifu kamili na majukwaa yote bado haujathibitishwa.

Hitimisho

Thamani ya Mwongozo wa Kutengeneza Tovuti haipo katika kukuchagulia teknolojia, bali katika kuweka utaratibu wa mchakato wa kutengeneza tovuti kwa AI: kwanza elewa mahitaji na wigo, kisha kagua utekelezaji wa marejeo, linda toleo lililopo, kamilisha ukaguzi halisi unaolingana na kazi, na mwisho acha njia inayoweza kutunzwa, kuchapishwa na kurejeshwa kupitia makabidhiano. Baada ya kusakinisha build-websites-v2, kuanza na kazi ndogo yenye lengo wazi kwa kawaida huwa thabiti zaidi kuliko kuitaka AI itengeneze upya tovuti nzima moja kwa moja.