Indlela Yokwakha Izindlela Zokusebenza Zokubhala Ikhodi nge-AI Ezivumelanayo nge-Viserys

Yini i-Viserys?

I-Viserys iqoqo elizimele lezindlela zokusebenza zobunjiniyela ezenzelwe ama-ejenti okubhala ikhodi e-AI. Esikhundleni sokuvumela i-ejenti ukuthi isungule inqubo entsha esicelweni ngasinye, inikeza imiyalelo ye-Markdown engasetshenziswa futhi, abantu ababuyekeza umsebenzi, izinkomba ezabiwe, imiyalo yomjikelezo wokuphila, izinto zokuhlola, kanye nezikripthi zokuqinisekisa.

Iphrojekthi ihlela umsebenzi wesofthiwe ube umjikelezo wokuphila onezigaba eziyisithupha:

DEFINE -> PLAN -> BUILD -> VERIFY -> REVIEW -> SHIP

Indlela ngayinye yokusebenza ihlala kufayela le-SKILL.md futhi ifaka izinyathelo zenqubo, imibandela yokuphuma, kanye neziqondiso zokugwema ukuzithethelela. Njengoba la makhono eyi-Markdown elula, angalayishwa ama-ejenti okubhala ikhodi awasekelayo noma afundwe ngokuqondile njengemiyalelo ezimele.

Izici Eziyinhloko

• Ukumbozwa komjikelezo wokuphila: Izindlela zokusebenza zihlanganisa izidingo, ukuhlela, ukuqaliswa, ukuhlola, ukubuyekeza, kanye nokulungiselela ukukhishwa.
• Amakhono apakishiwe angu-26: Uhla lwemibhalo lwe-skills/ luqukethe izindlela zokusebenza zobunjiniyela ezingasetshenziswa futhi.
• Ababuyekezi abakhethekile: Ama-ejenti akhethekile ahlola ikhwalithi yekhodi, ukuhlola, ukuphepha, kanye nokusebenza kwewebhu.
• Ukuhlanganiswa ne-OpenCode: Kufakiwe i-ejenti ye-Viserys esebenza kumodi eyinhloko futhi elayisha amakhono ngaphandle kokucushwa komhlaba wonke.
• Izinkomba ezabiwe: Izinhla zokuhlola zingalayishwa lapho zidingeka khona esikhundleni sokuhlala unomphela kumongo we-ejenti.
• Ukuqinisekisa nokuhlola ukusebenza: Izikripthi ze-Node.js zihlola amakhono, imiyalo, izindlela zezinto ezikhiqiziwe, izixhumanisi zezinkomba, izinguqulo, kanye namacala okuhlola.

Qonda Isakhiwo Sendawo Yokugcina Ikhodi

• skills/ iqukethe izindlela zokusebenza zamakhono.
• agents/ iqukethe abantu ababuyekeza abangochwepheshe abane.
• references/ inikeza izinhla zokuhlola ezabiwe nezitholakala lapho zidingeka.
• commands/ ichaza imiyalo yomjikelezo wokuphila.
• evals/ iqukethe amacala nezinto zokuhlola amakhono.
• scripts/ iqukethe iziqinisekisi kanye nomqalisi wokuhlola ukusebenza.
• hooks/ inikeza ama-hook omjikelezo wokuphila kweseshini.
• docs/ iqukethe imibhalo yangaphakathi.
• .opencode/agent/viserys.md ichaza i-ejenti ye-OpenCode.
• .opencode/opencode.json ibhalisa izindlela zamakhono ze-OpenCode.

Ukufaka Nokumisa

Inketho 1: Yenza I-Viserys Isebenze ku-OpenCode

1. Faka ikhophi yendawo yokugcina i-Viserys usebenzisa i-Git.
2. Vula ifolda yendawo yokugcina oyifakile ku-OpenCode.
3. Cindezela u-Tab ukuze uvule isikhethi sama-ejenti.
4. Khetha i-viserys.

I-ejenti ye-Viserys efakiwe isebenza kumodi eyinhloko, ngakho iyavela ohlwini lwama-ejenti ku-OpenCode. Umyalo wayo uhlola ukuthi likhona yini ikhono elisebenzayo ngaphambi kokucubungula isicelo futhi uqondisa umsebenzi ngomjikelezo wokuphila wephrojekthi. Ukucushwa kwe-OpenCode okusezingeni lendawo yokugcina kubhalisa wonke amakhono apakishiwe, ngakho akudingeki kucushwe umhlaba wonke.

Inketho 2: Sebenzisa I-Viserys Nenye I-ejenti Esekelayo Amakhono

Ku-Claude Code, Cursor, noma kwenye i-ejenti esekela amakhono angasetshenziswa futhi, qondisa i-ejenti kuhla lwemibhalo lwe-skills/ lwendawo yokugcina. Kungenjalo, kopisha lolo hlu lwemibhalo ulufake endaweni yamakhono yomdabu yethuluzi.

Indawo eqondile incike ku-ejenti yokubhala ikhodi. I-Viserys ayidingi ukuthi izindlela zayo zokusebenza ze-Markdown ziguqulelwe kwenye ifomethi, kodwa ithuluzi elisingathayo kufanele lazi ukuthi lizithola kuphi.

Inketho 3: Sebenzisa Amakhono Njengomongo Olula

Uma i-ejenti ingenalo uhlelo lwamakhono lomdabu, vula ifayela elifanele le-SKILL.md bese unikeza okuqukethwe kwalo njengomongo. Ikhono ngalinye lenzelwe ukuzimela, ngakho ungalandela izinyathelo zalo ngesandla noma uyale i-ejenti ukuthi izilandele.

Khetha Indlela Efanele Yokusebenza

Qala ngekhono eliyinhloko elithi using-agent-skills uma ungaqiniseki ukuthi iyiphi indlela yokusebenza esebenzayo. Kungenjalo, khetha ikhono ngokwesigaba samanje somjikelezo wokuphila.

DEFINE: Cacisa Umsebenzi

• Sebenzisa i-idea-refine lapho umqondo ungacacile futhi udinga ukuhlolwa okuhlelekile.
• Sebenzisa i-interview-me lapho izidingo kufanele ziqoqwe umbuzo owodwa ngesikhathi.
• Sebenzisa i-spec-driven-development ngaphambi kokuqala iphrojekthi, isici, noma ushintsho olubalulekile olungenayo incazelo.
• Sebenzisa i-constraint-driven-development lapho kungekho zinga lekhwalithi noma ukuhlolwa kucindezelwa nje ukuze ukwakhiwa kuphumelele.

PLAN: Guqula Incazelo Ibe Imisebenzi

Ngemva kokuba izidingo sezizinzile, sebenzisa i-planning-and-task-breakdown. Iguqula incazelo ibe imisebenzi ehleliwe, eqinisekisekayo, enemibandela yokwamukelwa.

BUILD: Qalisa Ngokuqaphela

• I-incremental-implementation isiza ukuthi izinguquko ezithinta amafayela amaningi zifakwe ngezingxenye ezincane.
• I-test-driven-development iyasetshenziswa lapho kusetshenziswa umqondo, kulungiswa iphutha, noma kushintshwa indlela yokuziphatha.
• I-context-engineering isiza ukuqalisa iseshini, ukushintsha imisebenzi, noma ukubuyisa ikhwalithi yokuphumayo lapho yehla.
• I-source-driven-development ifaneleka lapho ukunemba kuncike emibhalweni esemthethweni yamanje.
• I-doubt-driven-development ikhuthaza ukuqinisekisa lapho ingozi iphezulu futhi ukuhlola manje kushibhile kunokulungisa iphutha kamuva.
• I-frontend-ui-engineering iqondisa umsebenzi wokwakha izixhumanisi ezibonwa abasebenzisi.
• I-api-and-interface-design isekela ukwakhiwa kwe-API, kwemingcele yamamojuli, kanye nezixhumanisi zomphakathi.

VERIFY: Fakazela Ukuthi Ushintsho Luyasebenza

• Sebenzisa i-browser-testing-with-devtools ekwakheni noma ekulungiseni iphutha okusekelwe esipheqululini.
• Sebenzisa i-debugging-and-error-recovery lapho ukuhlola kwehluleka, ukwakhiwa konakala, noma ukuziphatha ngesikhathi sokusebenza kungalindelekile.

REVIEW: Hlola Ikhwalithi Nengozi

• code-review-and-quality kufanele isetshenziswe ngaphambi kokuhlanganisa ushintsho.
• code-simplification iyasiza lapho ikhodi esebenzayo isalokhu inzima ukuyiqonda noma ukuyigcina.
• security-and-hardening isebenza kokokufaka komsebenzisi, ekuqinisekiseni ubuwena, ekugcinweni kwedatha, nasekuhlanganisweni kwezinhlelo zangaphandle.
• performance-optimization isebenza lapho kunezidingo zokusebenza noma kusolwa ukwehla kokusebenza.

SHIP: Lungiselela Ukukhiqiza

• git-workflow-and-versioning iqondisa izinguquko zekhodi nokulawulwa kwezinguqulo.
• ci-cd-and-automation isekela izinguquko kumapayipi okwakha nokuphaka.
• deprecation-and-migration isiza ukususa izinhlelo ezindala noma ukuthuthela abasebenzisi.
• documentation-and-adrs iqopha izinqumo zokwakheka kwesistimu nezinguquko kuma-API asesidlangalaleni.
• observability-and-instrumentation ihlanganisa amalogi, amamethrikhi, ama-trace, nezexwayiso.
• shipping-and-launch iqondisa ukulungiselela kokugcina ukuphakwa kokukhiqiza.

Isibonelo Sokusetshenziswa Okuyisisekelo

Ake sithi ucela i-ejenti ye-AI yokubhala ikhodi ukuthi ingeze i-API endpoint entsha eqinisekisiwe. Esikhundleni sokuqala ngokuqondile ekusebenziseni, sebenzisa umjikelezo wempilo ngokulandelana.

1. Chaza: Sebenzisa interview-me uma imithetho yokuqinisekisa, okokufaka, noma izimpendulo kungacacile. Bese usebenzisa spec-driven-development ukuze usungule ukuziphatha okulindelekile.
2. Hlela: Sebenzisa planning-and-task-breakdown ukuze ukhiqize imisebenzi ehleliwe nemibandela yokwamukelwa.
3. Yakha: Sebenzisa api-and-interface-design kwinkontileka ye-endpoint kanye ne-test-driven-development ekuziphatheni kwayo. Uma kufanele kushintshwe amafayela amaningi, sebenzisa futhi incremental-implementation.
4. Qinisekisa: Uma izivivinyo zehluleka noma i-endpoint iziphatha ngendlela engalindelekile, landela debugging-and-error-recovery.
5. Buyekeza: Sebenzisa code-review-and-quality kanye ne-security-and-hardening ngoba lesi sici siphatha ukuqinisekiswa nokokufaka.
6. Phaka: Sebenzisa izinqubo ezifanele ze-Git, amadokhumenti, ukubhekwa kwesistimu, nokuqalisa ngaphambi kokuphakwa kokukhiqiza.

Uma ukuhlanganiswa kwe-OpenCode kunikwe amandla, i-ejenti ye-Viserys yakhelwe ukuthi iqale ihlole amakhono afanayo. Ekusethweni okusebenzisa umongo osobala, uzikhethela wena lawo makhono bese ucela i-ejenti ukuthi ilandele inqubo ngayinye ye-Markdown ekhethiwe.

Sebenzisa Abantu Bokubuyekeza

I-Viserys ihlanganisa abantu abane bokubuyekeza ku-agents/. Banikeza imibono egxile ezindabeni ezithile ehambisana namakhono omjikelezo wempilo.

• agents/code-reviewer.md yenza ukubuyekeza ngezimbazo ezinhlanu isebenzisa izinga lokugunyazwa likanjiniyela omkhulu.
• agents/test-engineer.md ihlola isu lezivivinyo nokumbozwa kusetshenziswa indlela ethi prove-it.
• agents/security-auditor.md ihlanganisa ukutholwa kobungozi, ukumodelwa kwezinsongo, nokuhlolwa kwe-OWASP.
• agents/web-performance-auditor.md ihlola ama-Core Web Vitals ngezindlela ezisheshayo noma ezijulile.

Khetha umuntu ngokusekelwe ezingozini zoshintsho. Isibonelo, hlanganisa umhloli wezokuphepha ne-security-and-hardening emsebenzini wokuqinisekisa, noma usebenzise umhloli wokusebenza kwewebhu ngemva kokushintsha isixhumi esibonakalayo esibonwa umsebenzisi.

Qinisekisa Iphakheji Yezinqubo

Qalisa imibhalo ye-Node.js enikeziwe ngemva kokushintsha amakhono, imiyalo, izinkomba, izinguqulo, noma ama-fixture okuhlola:

node scripts/validate-skills.js
node scripts/validate-commands.js
node scripts/validate-artifact-paths.js
node scripts/validate-reference-links.js
node scripts/validate-versions.js
node scripts/run-evals.js

Le miyalo iqinisekisa ukwakheka kwangaphakathi kwephakheji futhi iqhuba isethi yayo yokuhlola. Ibaluleke kakhulu lapho unweba i-Viserys, hhayi nje lapho usebenzisa izinqubo zayo ezikhona.

Amathiphu Athuthukile

Hlanganisa Amakhono Ngaphandle Kokweqa Izigaba Zomjikelezo Wempilo

Umsebenzi ungadinga ikhono elingaphezu kwelilodwa. Isici sesiphequluli, isibonelo, singahlanganisa frontend-ui-engineering, test-driven-development, kanye ne-browser-testing-with-devtools. Gcina imibandela yokuphuma yekhono ngalinye ibonakala ukuze ukwengeza izinqubo kungaphenduki ukucela okungahlelekile.

Layisha Izinkomba Kuphela Lapho Zidingeka

Uhla lwe-references/ luhloselwe izinhla zokuhlola ezabiwe ezilayishwa lapho kudingeka. Lokhu kusiza ukugcina umongo osebenzayo we-ejenti ugxile, kuyilapho kugcinwa ukufinyelela esiqondisweni esinemininingwane.

Sebenzisa Imithombo Esemthethweni Emsebenzini Oncike Ezinguqulweni

Sebenzisa source-driven-development lapho imininingwane yokusebenzisa incike emibhalweni yamanje. Yihlanganise ne-doubt-driven-development lapho umcabango obonakala unembile kodwa ungamanga ungabiza kakhulu.

Buyisela Ikhwalithi Lapho Eyehla

Uma iseshini ende iba nokungahambisani, sebenzisa context-engineering. Yenzelwe ngokuqondile ukusetha iseshini, ukushintsha imisebenzi, nezimo lapho ikhwalithi yomphumela yehle khona.

Bheka Amadokhumenti Afakiwe

• docs/README.md ichaza iphakheji nemephu yomjikelezo wempilo.
• docs/skill-anatomy.md ichaza ifomethi ye-SKILL.md.
• evals/README.md ichaza ukuthi ukuhlolwa kwamakhono kusebenza kanjani.

Funda incazelo yesakhiwo sekhono ngaphambi kokwengeza noma ukuhlela kabusha izinqubo, bese uqala iziqinisekisi nokuhlola ukuze uhlole umphumela.

Isiphetho

I-Viserys iguqula ukuthuthukiswa okusizwa yi-AI kube inqubo yobunjiniyela ephindaphindekayo. Qala ngokuxhuma uhla lwe-skills/ ku-ejenti ehambisanayo noma ukhethe i-ejenti ye-Viserys efakiwe ku-OpenCode. Bese uqhubeka ngenhloso ku-DEFINE, PLAN, BUILD, VERIFY, REVIEW, kanye ne-SHIP, usebenzisa abantu abangochwepheshe nemibhalo yokuqinisekisa lapho bengeza khona inani.