Hlela Futhi Uhlole I-Claude Code Harness Yakho nge-harness-map

Okwenziwa yi-harness-map

harness-map ifunda ukucushwa okuzungeze i-Claude Code bese ikuguqula kube imephu eyodwa ebonakalayo yokwakheka. Lokhu kucushwa okuzungezile, okubizwa ngokuthi i-harness, kuhlanganisa amafayela eziqondiso afana ne-CLAUDE.md, inkumbulo ezenzakalelayo, amaseva e-MCP, amakhono, izimvume, ama-hook, imithetho, kanye nezilungiselelo ezihlobene.

I-harness esebenzayo ingashintsha kuye ngefolda lapho i-Claude Code iqala khona nangendlela i-agent entsha eyethulwa ngayo. Iseshini eyinhloko, i-fork, i-subagent, i-Explore noma i-Plan agent, umlingani weqembu, noma ukusebenzisa i-claude -p kungathola ulwazi oluhlukile. I-harness-map yenza lo mehluko ubonakale kufolda ngayinye ekhethiwe yokuqala nasendleleni ngayinye yokuqalisa.

Le phrojekthi isebenzisa i-Python 3 futhi ayidingi amaphakheji engeziwe e-Python. Imibhalo yayo ifunda ukucushwa ngaphandle kokukushintsha, ikhiqize ifayela elihlelekile le-harness.json, bese yakha umbiko we-harness-map.html ongabukwa esipheqululini.

Izici ezibalulekile

• Ukuhlaziya okuqondene nefolda: Qhathanisa izinkomba zokuqala eziningi ngokudingekayo ngokuphinda i---cwd.
• Ukuboniswa kokudluliselwa kwe-agent: Bona ukuthi ingxenye ngayinye itholwa yini eseshinini yomzali, ifundwa futhi efayelini, noma ayidluliselwa ku-agent entsha.
• Ukuhlaziya ukusebenzisana kwemithetho: Hlola izindlela ezinhlanu zokuphathwa: ukufaka esikhundleni, ukuhlanganisa lapho ukuphika kunokubaluleka, ukusebenzisa yonke imithetho, ukuhlanganisa ngaphandle kokubaluleka, nokukhetha umthetho owodwa kuphela.
• Izimo zobungozi nokunakwa: Thola izimo ezifana nokuhlukaniswa kwenkumbulo ezenzakalelayo ngokwefolda noma ukusebenza kweqembu okudlulisela imodi yezimvume ku-agent entsha.
• Ukuhlola ukuvuthwa: Buyekeza amazinga 1 kuya ku-5 kuzo zonke iziyalo eziyisithupha ze-harness eshadini elinamakhona ayisithupha.
• Okuphumayo okunaka ubumfihlo: Qopha imethadatha yesakhiwo ngenkathi ushiya ngaphandle imizimba yeziqondiso, amanani eziguquguquko zemvelo, amathokheni, izimpikiswano zemiyalo, neminye imininingwane ebucayi.
• Ukuboniswa okuphathekayo: Namathisela i-harness.json yomunye umuntu kusixhumi esibonakalayo sombiko ukuze udwebe kabusha imephu yakhe.

Ngaphambi kokuba uqale

Udinga i-Python 3, i-Git, kanye nokufinyelela ekucushweni kwe-Claude Code okungokwe-akhawunti yakho evamile yomsebenzisi. Akudingeki ukufaka amaphakheji nge-pip.

Qalisa i-harness-map njengomsebenzisi ofanayo osebenzisa i-Claude Code. Ungasebenzisi i-sudo. Ukusebenzisa ngamalungelo omlawuli kungashintsha ifolda yasekhaya esebenzayo futhi kuveze ukucushwa komunye umsebenzisi, ngakho umbhalo wenqaba ukusebenza ngaleyo ndlela.

Khetha amafolda angempela ovame ukuqala kuwo i-Claude Code. Ukuskena ifolda yomzali akuvezi konke ukucushwa okungasebenza lapho uqala ngaphakathi kwephrojekthi yengane, ngoba ukucushwa kuxazululwa kuya phezulu kusukela kufolda ngayinye yokuqala.

Ukufakwa

Clone-a i-repository bese ungena kufolda yayo:

git clone https://github.com/Dominic-DK/harness-map.git
cd harness-map

Ungabuyekeza iphrojekthi ku-github.com/Dominic-DK/harness-map. Iphrojekthi isatshalaliswa ngaphansi kwe-MIT License.

Isinyathelo 1: Skena i-harness yakho ye-Claude Code

Qalisa i-harness-map.py ngempikiswano eyodwa ye---cwd endaweni ngayinye yokusebenza ofuna ukuyiqhathanisa. Umyalo olandelayo uskena amafolda amabili ayizibonelo bese ubhala umphumela ku-harness.json:

python3 harness-map.py --cwd ~/work/a --cwd ~/work/b -o harness.json

Ungaphinda i---cwd kaningi ngokudingekayo. Uma uyishiya, i-harness-map iskena ifolda yamanje kuphela:

python3 harness-map.py -o harness.json

Ukuskena kokuqala kufunda amafayela okucushwa futhi kwenza ukuhlola okungaqedwa kusetshenziswa lawo mafayela kanye nezibalo ezihlanganisiwe zenani lomlando wezingxoxo.

Shintsha isikhathi somlando wezingxoxo

Isikhathi esimisiwe sokuhlanganisa yizinsuku ezingu-30. Sebenzisa i---days uma udinga iwindi lokubuka elihlukile. Isibonelo, lo myalo usebenzisa izinsuku ezingu-90:

python3 harness-map.py --cwd ~/work/a --days 90 -o harness.json

Ukuhlaziya izingxoxo kubala imicimbi kuphela. Akukopishi umbhalo wengxoxo, okuqukethwe kwemiyalo, noma okuqukethwe kwamafayela kumphumela.

Isinyathelo 2: Phrinta uhlelo lokuhlola lwe-agent

Okunye ukuhlola kudinga ukuthi i-agent yenze izivivinyo ezilawulwayo kunokuhlola nje ukucushwa okumile. Phrinta izinqubo nemithetho yokuphepha ehlinzekwe yiphrojekthi ngalo myalo:

python3 harness-map.py --probe-plan

Funda lo mphumela ngaphambi kokucela i-agent ukuthi yenze ukuhlola. Landela iziqondiso ezikhiqiziwe kunokuzakhela imiyalo yokuhlola. Ukuhlola kungahlanganisa ukufunda ukucushwa, ukubala imicimbi efanele yomlando, nokuhlola ukuziphatha ngaphakathi kwefolda yesikhashana.

Isinyathelo 3: Yenza noma weqe ukuhlola

Yenza i-agent ilandele uhlelo lokuhlola oluphrintiwe bese igcina lokho ekubonile ku-probes.json. Ukuhlola ngakunye kuqopha okwenziwe nalokho okwabonwa njengobufakazi obusekelayo.

Lesi sinyathelo siyazikhethela. Uma ungakwenzi ukuhlola, into ehambisanayo ivela njengokuthi ayihlolwanga futhi ikhishwa ekubalweni kwamazinga. Gwema ukumemezela mathupha ukuziphatha okuyimpumelelo okungazange kubonwe ngempela, ikakhulukazi ekuhloleni kwezinga lesi-5.

Isinyathelo 4: Hlanganisa imiphumela yokuhlola

Phinda usebenzise ukuskena ngamafolda okuqala afanayo bese wengeza i---probes probes.json:

python3 harness-map.py --cwd ~/work/a --cwd ~/work/b --probes probes.json -o harness.json

Ukusebenzisa isethi efanayo ye---cwd kugcina ukubalwa kokugcina kuhambisana nezindawo zokusebenza ezihlanganiswe ekuskeneni kokuqala.

Isinyathelo 5: Yakha bese uvula umbiko

Khiqiza umbiko we-HTML efayelini le-JSON eliqediwe:

python3 build.py harness.json

Ku-macOS, yivule ngale ndlela:

open harness-map.html

Ku-Linux, sebenzisa:

xdg-open harness-map.html

Ku-Windows, sebenzisa:

start harness-map.html

Ukufunda imephu ye-harness

Embikweni, shintsha phakathi kwamafolda okuqalisa nezindlela zokuqalisa ukuze ubone i-harness esebenzayo esimweni ngasinye. Engxenyeni ngayinye, umbiko uhlukanisa izimo ezintathu zokudluliswa:

• I-agent entsha iyithola ngokuqondile kuseshini yomzali.
• I-agent entsha iyifunda futhi efayelini.
• Ingxenye ayidluliselwa ku-agent entsha.

Lokhu kuqhathanisa kusiza ukuchaza ukuthi kungani ama-agent amabili asebenzisa i-repository efanayo engase aziphathe ngendlela ehlukile. Isibonelo, i-subagent ingase ingakutholi konke okutholakala kuseshini eyinhloko, kuyilapho izilungiselelo ezihlotshaniswa nefolda ethile yokuqala zingase zingasebenzi kwenye indawo.

Qonda imithetho egqagqene

Umbiko ubonisa nokuthi imithetho egqagqene ixazululwa kanjani. Kuya ngohlobo lokumisa, inani elilandelayo lingase lithathe indawo yelinye, imithetho ingase ihlanganiswe lapho ukwenqatshelwa kunikezwa kuqala, isenzo ngasinye esifanayo singase sisebenze, umbhalo ungase uhlanganiswe ngaphandle kokulandelana kokubaluleka, noma kukhethwe inketho eyodwa kuphela.

Buyekeza lokhu kusebenzisana lapho umyalelo, imvume, noma i-hook ibonakala ingasebenzi. Inkinga ingase ibe yindlela imithetho ehlanganiswa ngayo, hhayi ifayela elilahlekile.

Ukuqonda ukuhlolwa kwezinga lokuvuthwa

harness-map inika izindawo eziyisithupha amaphuzu kusukela ezingeni 1 kuya ezingeni 5:

1. Ukwakhiwa kwemiyalelo
2. Imemori nendawo
3. Ububanzi bamathuluzi
4. Ukuvimbela kusengaphambili
5. Ukuqinisekisa kwangemva kwesenzo nokubonakala
6. Ukwakhiwa kokudlulisela imisebenzi

Iskripthi singakwazi ukubala ngokuzenzakalelayo kuze kufike ezingeni 4 lapho idatha etholakalayo ikusekela lokho. Umphumela uqopha ukuthi yiziphi izimo eziphumelele nokuthi ukuhlola kumile kuphi. Izincazelo zamaphuzu zigcinwe ku-SCORECARD ngaphakathi kwe-harness-map.py.

Izinga 5 lidinga ubufakazi obuvela ekuhlolweni okubukwe ngempela. Isibonelo, ukuvimbela kusengaphambili kufinyelela ezingeni 5 kuphela lapho kunerekhodi elibonisa ukuthi ukwenqatshelwa kwamisa umyalo ngempela. Ukuba nokwenqatshelwa ekumisweni kuphela akwanele.

Ukuhlola kungase futhi kwehlise amaphuzu lapho ukumisa kukhona kodwa kubonakala kungasetshenziswa, njengethuluzi elingazange lisetshenziswe ngesikhathi esikhethiwe somlando noma amasessioni asebenze ngaphansi kwemodi yemvume ehlukile kunaleyo emisiwe.

Lapho kuskenwa amafolda okuqala amaningi, izinga eliboniswayo liyimediyani yamaphuzu ezinga lamafolda. Uma inani lamafolda lilingana, kusetshenziswa inani eliphakathi eliphansi. Umbiko ubonisa nobubanzi obusuka kokuncane kuya kokukhulu.

Amazinga aphezulu awasho ngokuzenzakalelayo ukuthi angcono. harness-map ilinganisela izinga elidingwa yindawo ngayinye kusukela emaphethini okusetshenziswa, okuhlanganisa ukuthi usebenza wedwa yini, ukuthi uvame kangakanani ukuqala ama-agent angaphansi, nokuthi uvame kangakanani ukusebenzisa imiyalo okunzima ukuyihlehlisa. Igqamisa izindawo ezingaphansi kwesidingo esilinganisiwe, kunokuxwayisa ngawo wonke amaphuzu angaphansi kwezinga 5.

Ubumfihlo nokubuyekezwa komphumela

Iskena sifunda amafayela kodwa asiguquli ukumisa. Sinciphisa ngamabomu lokho okukopishwa emiphumeleni yaso:

• Kuma-CLAUDE.md namafayela emithetho, siqopha izindlela, inani lemigqa, nokuthi afundwa nini, kodwa hhayi umbhalo wawo.
• Kuzilungiselelo, siqopha amamodi emvume, inani lemithetho, namagama eziguquguquko zemvelo, kodwa hhayi amanani eziguquguquko zemvelo noma okuqukethwe yimithetho.
• Kuma-hook, siqopha umcimbi, umthombo, negama lefayela elisebenzisekayo, kodwa sishiya ngaphandle izimpikiswano zemiyalo nezindlela.
• Kuma-server e-MCP, siqopha amagama nemithombo, kodwa sishiya ngaphandle imiyalo, izimpikiswano, ama-header, namathokheni.
• Ezindleleni, sishintsha isiqalo sangempela sohla lwemibhalo yasekhaya sibe yi-~.

Amafayela angakwazi ukufundwa afakwa ohlwini lwe-unreadable. Ngokwephrojekthi, i-Claude Code nayo ayikwazi ukufunda lawo mafayela ngaphansi kwezimvume zomsebenzisi ofanayo.

Umphumela usenamagama amafolda nohlu lwama-plugin afakiwe. Vula futhi uhlole kokubili i-harness.json ne-harness-map.html ngaphambi kokwabelana ngawo.

I-.gitignore ye-repository ilungiselelwe ukugcina i-harness.json ne-harness-map.html ngaphandle kokulawulwa kwenguqulo, kodwa kusafanele uqinisekise amafayela afakwe ku-staging ngaphambi kokwenza i-commit.

Dlulisela ukuhamba komsebenzi ku-agent yokubhala ikhodi

Ungacela i-Claude Code noma enye i-agent yokubhala ikhodi ukuthi ilandele imiyalelo ye-repository. Faka esikhundleni samafolda ayisibonelo ngamafolda okuqala owasebenzisa kakhulu. Isicelo esifanele singaba:

Read the README at https://github.com/Dominic-DK/harness-map and follow the direct execution steps.
My usual starting folders are ~/work/a and ~/work/b.
Perform the step 3 agent checks according to the documented safety rules and record the results.
When finished, open harness-map.html in a browser and summarize the result in about five clear sentences.

Gcina ukubhekwa ngumuntu esigabeni sokuhlola. I-agent kufanele ilandele uhlelo oluqondile lokuphepha olukhiqizwe yi---probe-plan.

Amathiphu athuthukile

Skena zonke izindawo zokungena ezibalulekile

Ungacabangi ukuthi ukuskena impande ye-repository kuhlanganisa amaphrojekthi angaphansi. Faka uhla lwemibhalo ngayinye oqala kuyo i-Claude Code njengendlela ehlukile ye---cwd. Lokhu kudala ukuqhathanisa okuwusizo kakhulu kwemiyalelo ezuzwe njengefa, imingcele yememori, nokutholakala kwamathuluzi.

Khetha isikhathi sokubheka esihambisana nomsebenzi wakho

Isikhathi esimisiwe sezinsuku ezingu-30 sifanele umsebenzi wakamuva, kodwa amathuluzi asetshenziswa ngokungavamile angadinga isikhathi eside. Sebenzisa i---days ngamabomu ngoba ubufakazi bokungasetshenziswa bungathinta amaphuzu okuvuthwa.

Hlukanisa ukumiswa ekuziphatheni okuqinisekisiwe

Phatha okutholwe okusekelwe kumafayela njengobufakazi bokumiswa okuhlosiwe, hhayi njengobufakazi bokuthi isilawuli siyasebenza ngesikhathi sokusebenza. Sebenzisa ama-probe okuzikhethela lapho udinga ukuqiniseka ukuthi ama-hook, imikhawulo, noma okunye ukuziphatha kuyasebenza ngempela.

Qhathanisa imibiko ngaphandle kokuveza ukumiswa okuluhlaza

Uma othile ekuthumelela harness.json ebuyekeziwe, sebenzisa indawo yokunamathisela yombiko ukuze uyidwebe kabusha. Nakuba amanani abucayi esusiwe, bobabili kufanele bahlole i-JSON kuqala ngoba amagama amaphrojekthi, amagama amafolda, namagama ama-plugin kusekhona.

Sebenzisa enye indlela lapho i-Python ingatholakali

Uma i-Python 3 ingatholakali, kopisha okuqukethwe kwe-PROMPT.md ukufake ku-agent. I-agent ingafunda ukumiswa ngokuqondile, idale i-JSON ngefomethi efanayo, bese yakha isikrini. I-README ixwayisa ngokuthi le ndlela inamathuba amakhulu kuneskripthi okushiya izinto noma ukubala ngokungalungile.

Imikhawulo eyaziwayo

• Imithetho yokudlulisela umsebenzi imisiwe ku-SPAWN_RULES ku-harness-map.py; ayitholakali ngokubheka izikhathi zakho zokusebenza ezibukhoma.
• I-README ithi le mithetho ilandela imibhalo ye-Claude Code 2.1.287 eyahlolwa ngo-October 2, 2026. Ukuziphatha kungahluka ezinguqulweni zakamuva.
• Imithombo ecashuniwe yimibhalo esemthethweni ye-sub-agents, agent teams, kanye ne-memory.
• Iphrojekthi iphawula ukungafani okukodwa: imibhalo ithi ama-subagent awafundi imemori ezenzakalelayo, kanti indawo yokusebenza yombhali kubikwa ukuthi yadlulisela uhlu lwememori ku-subagent. Umbiko uphawula lokhu njengomehluko phakathi kwemibhalo nokubonwayo.
• Izilungiselelo ezitholakala kuphela kulayini womyalo ezifana ne---agents kanye ne---permission-mode azigcinwa kumafayela, ngakho-ke iskena ngeke ikwazi ukuzithola.
• Kuma-plugin afakiwe, iskena sifunda inguqulo entsha kunazo zonke etholakala kuhla lokufakwa kwe-plugin.

Isiphetho

i-harness-map inikeza indlela esebenzayo yokuqonda ukumiswa okutholwa yi-Claude Code ngempela kuwo wonke amaphrojekthi nezindlela zokuqalisa ama-agent. Qala ngokuskena zonke izinkomba zokusebenza ezibalulekile, ngokuzikhethela sebenzisa ama-probe abhaliwe, wakhe kabusha idatha ngobufakazi bazo, bese ukhiqiza umbiko we-HTML. Sebenzisa ukuboniswa nokuhlolwa kwezinga lokuvuthwa ukuze uthole izikhala zokumiswa, kodwa buyekeza amafayela akhiqiziwe ngaphambi kokuwabelana futhi uphathe imithetho yokudlulisela ebhaliwe njengexhomeke enguqulweni.