Guqula Izimpendulo ze-AI zibe Amakhasi Afundekayo nge-Answer me with HTML

Lokho Okwenziwa yi-Answer me with HTML

I-Answer me with HTML iyikhono le-ejenti eliguqula izimpendulo eziyinkimbinkimbi zibe amakhasi e-HTML afundeka kalula futhi azimele. Esikhundleni sokucela imodeli ukuthi ibhale yonke into ye-HTML, imithetho ye-CSS, namakhoyidini e-SVG, leli khono lenza imodeli ikhiqize uhlaka olufushane lwe-Markdown. I-CLI efakwe kulo bese iphethe ukwakheka, isitayela, nokudwetshwa kwemidwebo.

Lokhu kwehlukaniswa komsebenzi kunciphisa okukhiqizwayo nesikhathi sokulinda. Esivivinyweni sephrojekthi, leli khono lisebenzise i-median yamathokheni okukhipha angu-923 esikhundleni sika-6,873, futhi laqeda izimpendulo ngemizuzwana engu-13 esikhundleni sika-46. Izindleko ezilinganisiwe zahlala zicishe zifane ngoba ukujikeleza okwengeziwe kwe-ejenti kwafunda kabusha umongo wengxoxo.

Leli thuluzi liwusizo olwazini oluzuza ngokuhleleka, okuhlanganisa izincazelo zezakhiwo, izinqubo ezinezinyathelo eziningi, ukuqhathanisa, imigqa yesikhathi, izihlahla zamamojuli, nokubuyekezwa kokubhala okunamanothi. Umbuzo olula usengathola impendulo yombhalo elula; i-ejenti inquma ukuthi ikhasi liyafaneleka nini ngaphandle kokuthi ulicele ngokusobala.

Izici Ezisemqoka

• Okuncane okukhiqizwa imodeli: Imodeli ibhala okuqukethwe esikhundleni samakhulu emigqa ye-HTML, i-CSS, ne-SVG ephindaphindwayo.
• Ukwakheka okuqondiswa yikhodi: I-CLI ibala ukubekwa kwamaphaneli namakhoyidini emidwebo, inciphise amalebula anqunyiweyo nezikhala ezingalingani.
• Ukuqinisekiswa okuwusizo: Uma uhlaka lunephutha, i-CLI ibika umugqa, ingxenye, nesibonelo esilungile ukuze i-ejenti ikulungise.
• Izingxenye ezibonakalayo: Izinhlaka zingaba namashadi okugeleza, imidwebo yokulandelana, izihlahla, imigqa yesikhathi, imikhawulo, amanothi, amabhulokhi enani elingukhiye, iziqapheliso, namatafula okuqhathanisa.
• Izindikimba ezimbili: Khetha indikimba ye-blueprint yesitayela sobunjiniyela noma indikimba ye-shadcn esekelwe emakhadini. Zombili zisekela izindlela ezikhanyayo nezimnyama.
• Okuphumayo okuphathekayo: Umphumela ngamunye uyifayela elilodwa le-HTML elingenazo izixhumanisi ze-CDN noma amafonti ewebhu, ngakho lingavulwa ngaphandle kwe-inthanethi futhi kwabelwane ngalo kalula.
• Umthombo oshumekiwe: Ikhasi ngalinye ligcina i-Markdown esetshenziswe ukulidala. Isilawuli se-Copy source sekhasi sithola lolo hlaka.
• Ukuhlolwa kokubhala: Izinhlaka zesiNgisi nesiShayina ziyahlolwa ukuze kutholakale imisho emide, imishwana enamagama amaningi, izwi lokwenziwa, nezinye izinkinga ezihlobene nesitayela.

Izidingo Nokufakwa

Udinga i-Node.js 20 noma entsha. Ukufakwa kwekhono okujwayelekile akudingi i-npm install ehlukile ngoba i-CLI nezinc依依 zayo zesikhathi sokusebenza kufakwe kanye nekhono.

Inketho 1: Vumela I-ejenti Yakho Iyifake

Indlela enconyiwe ukunikeza i-ejenti yakho yokubhala ikhodi isicelo sokufaka. Isifaki sisekela i-Claude Code, i-Codex, i-Cursor, i-OpenCode, namanye ama-ejenti amaningi.

Faka ikhono le-Answer me with HTML ngokusebenzisa npx -y skills add QingYunA/answer-me-with-html -g -y. Dlulisa i--a negama le-ejenti elifanele, njenge--a claude-code. Bese ufunda i-SKILL.md yayo bese udala ikhasi elichaza ukuxhawulana kwezinyathelo ezintathu kwe-TCP.

Inketho 2: Sebenzisa Isifaki Esisebenzisanayo

Qalisa umyalo olandelayo bese ukhetha ama-ejenti okufanele kufakwe kuwo ikhono:

npx skills add QingYunA/answer-me-with-html

Umyalo usebenzisa isifaki se-vercel-labs/skills, esisekela ama-ejenti angaphezu kuka-70.

Inketho 3: Faka I-plugin ye-Claude Code

Ngaphakathi kwe-Claude Code, engeza imakethe bese ufaka i-plugin:

/plugin marketplace add QingYunA/answer-me-with-html
/plugin install answer-me-with-html@answer-me-with-html

Inketho 4: Faka Ngokuzenzela

Clone indawo yokugcina bese ukopisha ifolda yekhono uyiyise kufolda yamakhono ye-ejenti yakho. Ku-Claude Code, sebenzisa:

git clone --depth 1 https://github.com/QingYunA/answer-me-with-html.git /tmp/answer-me-with-html
cp -R /tmp/answer-me-with-html/skills/answer-me-with-html ~/.claude/skills/answer-me-with-html

Ezinye izindawo ezibhalwe phansi zihlanganisa ~/.codex/skills/ ye-Codex, ~/.cursor/skills/ ye-Cursor, kanye ne-~/.config/opencode/skill/ ye-OpenCode. Akukho okunye ukusetha okudingekayo ngemva kokufakwa.

Dala Ikhasi Lakho Lokuqala

1. Buza umbuzo obanzi. Zama Explain the TCP three-way handshake, Map out how the modules in this repository fit together, noma Redis or Memcached for our cache?.
2. Vumela i-ejenti ikhethe indlela yokwethula. Ibhala uhlaka olufushane lwe-Markdown bese iludlulisela ku-CLI efakwe ngaphakathi.
3. Vula umphumela. Ngokuzenzakalelayo, ikhasi elikhiqiziwe livuleka esipheqululini sakho.
4. Thola ifayela eligciniwe. Amakhasi akhiqiziwe agcinwa ngaphansi kwe-~/.answer-me-with-html/pages/.
5. Sebenzisa izilawuli zekhasi. Izilawuli ezisekhoneni eliphezulu kwesokudla zishintsha indikimba noma indlela yombala futhi zikopishe i-Markdown yomthombo.

Uma i-ejenti ingalikhethi ngokuzenzakalelayo ikhono, engeza umyalo oqondile ofana nokuthi Explain it in HTML.

Indlela Ithuluzi Elikhetha Ngayo Izingxenye

I-ejenti iqondanisa isimo solwazi nengxenye efanele:

• flow imele ukwakheka kwesistimu, amaketanga okubizwa, izinqumo, namasistimu ahlanganisiwe.
• sequence ikhombisa imilayezo eshintshaniswa ababambiqhaza abaningana ngokuhamba kwesikhathi.
• tree iveza amafolda, amamojuli, nezigaba zolwazi.
• timeline ihlela umlando, ukukhishwa kwezinguqulo, noma izigaba.
• limits iqhathanisa inani nomkhawulo walo.
• annot ingeza amanothi ezingeni lamagama emshweni.
• kv ibonisa imethadatha noma ulwazi lwebhulokhi yesihloko.
• callout igqamisa isiphetho, isexwayiso, noma ithiphu.
• Amathebula e-Markdown asekela ukuqhathanisa; amaseli aqukethe ok, no, noma warn aba izimpawu ezibonakalayo zesimo.

Bhala Futhi Unikeze Okusalungiswa Ngokwakho

Ungasebenzisa i-CLI ehlanganisiwe ngaphandle kwe-ejenti. Okusalungiswa kuqala nge-front matter ongayikhetha futhi sisebenzisa isihloko ngasinye sezinga lesibili njengephaneli. Isibonelo esilandelayo sakha imidwebo ye-sequence ne-flow yokuxhawulana kwe-TCP:

---
title: TCP three-way handshake
theme: blueprint
---
## Ukuxhawulana kwezindlela ezintathu {span=2}
```sequence num
Client -> Server: SYN, seq=x
Server -> Client: SYN+ACK, seq=y, ack=x+1
Client -> Server: ACK, ack=y+1
note Client, Server: ESTABLISHED
```

## C Izinguquko zesimo {span=2}
```flow LR
(CLOSED) -> LISTEN: passive open
LISTEN -> SYN_RCVD: get SYN / send SYN+ACK
SYN_RCVD -> *ESTABLISHED: get ACK
```

Esihlokweni sephaneli, span=2 yenza iphaneli libe banzi ngamakholomu amabili, rows=2 yenza libe phezulu ngemigqa emibili, kanti bare isusa ibha yesihloko. Ungangeza nemethadatha usebenzisa meta="small text".

Yinikeze Nge-Command Line

Ifayela le-CLI ngu-scripts/am.mjs ngaphakathi kwekhono elifakiwe. Ku-checkout yeriphozithri, chaza indlela yalo bese usebenzisa umyalo owufunayo:

AM=skills/answer-me-with-html/scripts/am.mjs

node $AM render examples/tcp.en.md
node $AM render notes.md -o out.html --no-open
node $AM render notes.md --theme shadcn
node $AM lint notes.md
node $AM list
node $AM config

Umyalo wokuqala unikeza okusalungiswa bese uyasivula. Owesibili ukhetha igama lefayela lokuphumayo futhi uvimbela ukuvulwa kwesiphequluli. Owesithathu ushintsha itimu kulokho kuqalisa okukodwa. Imiyalo esele yenza ukuhlolwa kokubhala, ibhale izingxenye, futhi ibonise izilungiselelo.

Ama-ejenti ngokuvamile athumela okusalungiswa nge-standard input. Nawe ungenza okufanayo:

node $AM render - <<'AM_EOF'
## Iphaneli elilodwa
```flow
A -> B: sawubona
```
AM_EOF

Sebenzisa am help <component> ukuze uhlole i-syntax ephelele yengxenye ethile. Setha imvelo ethi AM_HOME uma ufuna amakhasi akhiqiziwe agcinwe kwenye indawo ngaphandle kohla lwemibhalo oluzenzakalelayo.

Lungiselela Amatimu, Ukuziphatha Kwesiphequluli, Nokuhlolwa Kokubhala

Izilungiselelo ziphathwa ngemiyalo, ngakho awudingi ukuhlela amafayela okumisa ngesandla. Amanani agcinwa ku-~/.answer-me-with-html/config.json.

Ekufakweni kwe-plugin ye-Claude Code, vula umyalo wokumisa osebenzisanayo noma ushintshe isilungiselelo ngokuqondile:

/answer-me-with-html:config
/answer-me-with-html:config open off

Ngenye i-ejenti, sebenzisa /answer-me-with-html config open off noma uyicele ukuthi iyeke ukuvula isiphequluli. Kusuka ku-terminal, sebenzisa:

am config
am config set open off
am config reset

• open ngokuzenzakalelayo iba ngu-on futhi ilawula ukuthi ikhasi elisha livuleka yini esipheqululini.
• always ngokuzenzakalelayo iba ngu-on, kodwa isebenza kuphela uma kufakiwe ukuhlanganiswa kokuhlala kuvuliwe okukhethwayo.
• theme ngokuzenzakalelayo iba ngu-blueprint futhi yamukela no-shadcn.
• mode yamukela u-auto, light, noma dark.
• style yamukela u-off, 80, noma strict. Imodi ezenzakalelayo engu-80 iyaxwayisa ngaphandle kokuvimba ukunikezwa.

Itimu echazwe kokusalungiswa ithatha indawo yokuzenzakalelayo okumisiwe. Amafulegi e---open nawe---no-open athatha indawo yokuziphatha kwesiphequluli kulokho kunikezwa okukodwa kuphela.

Amathiphu Athuthukile

Vula Imodi Yokuhlala Kuvuliwe

Ngokuvamile, i-ejenti idala ikhasi kuphela lapho impendulo izuza khona kwelinye. Imodi yokuhlala kuvuliwe ingeza ikhasi elincane lapho impendulo iqukethe isiphetho, isifinyezo, uhlelo, ukuqhathanisa, ukubuyekeza, noma incazelo. Amakhasi ajwayelekile asebenzisa amaphaneli amabili kuya kwamane futhi anikezwa ngaphandle kokuvula isiphequluli. Ingxoxo evamile nezimpendulo ezingenaso isiphetho kuhlala kungashintshiwe.

Kwi-Claude Code, faka i-plugin eyengeziwe:

/plugin marketplace add QingYunA/answer-me-with-html
/plugin install answer-me-with-html-always@answer-me-with-html

Yimise okwesikhashana ngaphandle kokuyikhipha ngokusebenzisa:

/answer-me-with-html:config always off

Amanye ama-ejenti angamukela umthetho obhaliwe wokuhlala kuvuliwe efayilini lawo lemigomo yomhlaba wonke, njenge-AGENTS.md. Umthetho kufanele utshele i-ejenti ukuthi idale ikhasi elincane leziphetho futhi ilinikeze nge---no-open, kuyilapho yeqa ingxoxo evamile, okukhiphayo komyalo kuphela, nezicelo zombhalo ongenalutho.

Sebenzisa Ukuqinisekiswa Kokubhala Okuqinile

Ukuhlolwa kokubhala kusekelwe emibonweni engahlolwa umshini ethathwe ku-ASD-STE100. Kukhetha imisho emifushane, amagama avamile, imiyalo eqondile, namagama asetshenziswa ngokungaguquki. Izinyathelo zesiNgisi kufanele zihlale ngaphansi kwamagama angu-20, izincazelo ngaphansi kwamagama angu-25, kanti izigaba zingabi nemisho engaphezu kwemithandathu. Ukuhlolwa kwesiShayina kusebenzisa imikhawulo ehambisanayo yezinhlamvu futhi kumaka ukwakheka okuthile okuphindaphindayo noma okungacacile.

Vula ukuqinisekiswa okuvimbelayo emhlabeni wonke usebenzisa:

/answer-me-with-html:config style strict

Ungaphinda ucacise style: ku-draft ukuze ulawule ukuqinisekiswa kwalelo khasi.

Khetha I-template Efanele

I-template ezenzakalelayo ye-sheet ihlela ulwazi njengegridi yamaphaneli. Sebenzisa i-doc ekhasini elinekholomu eyodwa elinethebula lokuqukethwe. Ku-sheet, inkambu ye-front matter ethi cols ilawula inani lamakholomu.

Bhala Ngaphezulu Kwephrezentheshini Ekhasini Ngalinye

Faka izinketho zephrezentheshini ku-front matter ye-draft lapho ikhasi elilodwa lidinga izilungiselelo ezihlukile:

---
template: sheet
theme: shadcn
title: Cache comparison
subtitle: Redis and Memcached
cols: 3
source: Internal architecture review
---

Ezinye izinkambu ze-front matter ziboniswa ngaphansi kwesihloko sekhasi. Uma ingxenye eyakhelwe ngaphakathi ingafaneleki, ifomethi ye-draft iphinde isekele amabhulokhi e-HTML noma e-SVG aluhlaza, nakuba izingxenye ezakhelwe ngaphakathi zinikeza izinzuzo zokuhlela okuzenzakalelayo.

Thuthukisa Iphrojekthi Endaweni

Abanikeli badinga ukufakwa okujwayelekile kwama-dependency ngoba kusetshenziswa i-source namatesti e-repository:

git clone https://github.com/QingYunA/answer-me-with-html.git
cd answer-me-with-html
npm install
npm test
npm run build

Qalisa npm run build ngemva kokushintsha amafayela angaphansi kwe-src/ ukuze wakhe kabusha i-skills/answer-me-with-html/scripts/am.mjs ehlanganisiwe. Ama-dependency amabili esikhathi sokusebenza yi-marked okuhlaziya i-Markdown kanye ne-Dagre yokuhlela amashadi okugeleza; womabili ahlanganiswa ku-CLI.

Isiphetho

Answer me with HTML ihlukanisa ukwenziwa kokuqukethwe nokwakhiwa kwamakhasi. I-agent yakho ibhala i-draft emfushane ye-Markdown, kuyilapho i-CLI inikeza izakhiwo, imidwebo, amatimu, ukuqinisekiswa, kanye nefayela le-HTML eliphathekayo elisebenza ngaphandle kwe-inthanethi. Qala ngokufaka le skill bese ucela incazelo ebonakalayo. Bese uthuthukisa ukuhamba komsebenzi ngokunikezela nge-CLI ngokuqondile, amatimu ekhasini ngalinye, ukuhlolwa okuqinile kokubhala, noma imodi yokusebenza njalo ozikhethela yona.