Jinsi inavyofanya kazi
Jinsi RADAR inavyofanya kazi.
Muhtasari wa kiufundi kwa wasanidi. RADAR huendesha mawakala wa uandishi wa msimbo na hufunga kazi tu baada ya kuendesha tena yenyewe jaribio la ukubalifu la kazi hiyo. “Imekamilika” ya wakala ni dai; kuendesha tena ndio ushahidi.
01 Mzunguko
Mzunguko mmoja kwa kila kazi.
Kila kazi hupitia mzunguko uleule, na kila hatua huendeshwa tu ikiwa hatua iliyotangulia imefaulu.
- 01 · fungua Kazi na jaribio la ukubalifu Huandikwa kabla kazi haijaanza
- 02 · lease Mmiliki mmoja, worktree yake Lease na fence token
- 03 · kazi Wakala hufanya kazi Katika nakala yake mwenyewe ya mradi
- 04 · dai Wakala husema amemaliza Huandikwa kama dai, si kama matokeo
- 05 · hakiki RADAR huendesha jaribio tena Kwenye toleo la sasa la kazi
- likifaulu Imefungwa Ushahidi huhifadhiwa kwenye daftari
- likishindwa · nafasi n kati ya 3 Imefunguliwa tena, pamoja na maelezo ya kushindwa Wakala yuleyule hujaribu tena kuanzia hatua 03
- baada ya nafasi 3 Wakala mwingine huchukua kazi Hadi nafasi 3 zaidi, kuanzia hatua 03
- baada ya 3 zaidi Kazi inakusubiri Daftari hukataa nafasi zaidi
- Fungua
- Kazi hufunguliwa pamoja na lengo lake na amri ya ukubalifu inayoweza kuendeshwa tena. Amri hiyo hukaguliwa kazi inapofunguliwa, bila kuendeshwa: kigezo kisichoweza kuendeshwa kama kilivyoandikwa hukataliwa wakati huo, badala ya kugunduliwa mwishoni.
- Lease
- Kazi hushikiliwa na mmiliki mmoja kwa wakati mmoja, kupitia lease na fence token. Uandishi kutoka kwa mmiliki aliyepitwa na wakati hukataliwa.
- Kazi
- Wakala hufanya kazi katika git worktree yake mwenyewe, kwenye branch yake mwenyewe.
- Dai
- Ripoti ya wakala kwamba amemaliza huandikwa kama dai. Dai halifungi kazi.
- Hakiki
- RADAR huendesha amri ya ukubalifu yenyewe, kwenye toleo la sasa la kazi. Ripoti ya wakala mwenyewe husomwa, lakini si ushahidi.
- Funga au fungua tena
- Likifaulu, kazi inaweza kufungwa, na rekodi ya uhakiki huhifadhiwa kama ushahidi wake. Likishindwa, kazi hufunguliwa tena pamoja na maelezo ya kushindwa.
- Mipaka
- Nafasi tatu kwa mtendaji, kisha nafasi tatu kwa wakala mwingine anayechukua kazi. Baada ya hapo daftari hukataa nafasi zaidi na kazi inakusubiri. Kubadilisha modeli, kipindi au mashine hakuanzishi hesabu upya, na kila jaribio jipya lazima lieleze kilichobadilika.
02 Daftari
Rekodi moja ambayo kila wakala huiandikia.
Kila wakala husoma na kuandika kwenye daftari lilelile la kazi: faili ya SQLite iliyo kwenye kompyuta yako. Ndiyo rekodi pekee ya nani anashikilia kila kazi, kipi kilidaiwa na jaribio lilionyesha nini.
- Kazi
- Lengo na amri ya ukubalifu, vinavyoandikwa kabla kazi haijaanza.
- Umiliki
- Mmiliki wa sasa wa kila kazi, pamoja na lease na fence token yake.
- Nafasi
- Huhesabiwa kwa kila kazi, katika mawakala, modeli na mashine zote.
- Madai
- Ripoti ya wakala kwamba kazi imekamilika, ikitengwa na matokeo.
- Rekodi za uhakiki
- Kila uendeshaji wa jaribio la ukubalifu, ukifungamanishwa na commit na working tree ulipoendeshwa.
- Mabadiliko
- Amri ya ukubalifu iliyobadilishwa hurekodiwa pamoja na toleo la zamani na jipya; ubatilishaji nao hurekodiwa.
Kumbukumbu
Maamuzi na mafunzo ni madokezo ya Markdown yenye chanzo na wigo. Faharasa ya ndani huyatafuta bila mtandao, na hook huweka yanayolingana mbele ya wakala kabla hajachukua hatua. Kwa kuwa madokezo ni Markdown ya kawaida, unaweza kuyafungua katika Obsidian.
03 Utengaji
Kila nafasi katika nakala yake mwenyewe.
- Kila nafasi hufanyika katika git worktree yake, kwenye branch yake. Watendaji wawili hawashiriki tree moja kamwe.
- Mtendaji hawezi kuandika upya amri yake ya ukubalifu. Msimamizi pekee ndiye anayeweza kuibadilisha, na kabla tu kazi haijafungwa; kila badiliko huhifadhi toleo la zamani na jipya.
- Kazi hufika kwenye branch yako kuu (main) tu baada ya uhakiki kufaulu, na amri ya ukubalifu huendeshwa mara moja zaidi baada ya merge.
- Force-push hukataliwa kwa kila jukumu.
- Kanuni hizi huendeshwa kama msimbo, kabla na baada ya modeli kuitwa. Si prompt, kwa hiyo wakala hawezi kuzikwepa kwa maneno.
04 Mawakala
Mawakala unaowatumia tayari.
RADAR huendesha Claude Code, Codex CLI, OMP na Hermes Agent, kwenye kompyuta yako au kwenye seva zako mwenyewe za Linux. Haiwachukui nafasi: wao bado ndio wanaofanya kazi.
- Claude Code
- Codex CLI
- OMP
- Hermes Agent
- Mkataba mmoja
- Kanuni zilezile, daftari lilelile, lango lilelile la uhakiki na mipaka ileile ya nafasi hutumika kwa wote wanne.
- Msimamizi
- Wakala unayezungumza naye ndiye msimamizi: hufungua kazi, huzikabidhi kwa watendaji na hufunga kazi tu kukiwa na rekodi ya uhakiki iliyofaulu.
- Watendaji
- Watendaji hufanya kazi katika worktree zao wenyewe. Hawawezi kufunga kazi wala kubadilisha amri yao ya ukubalifu.
05 Ndani kwanza
Ndani kwanza.
RADAR haihitaji akaunti wala wingu.
- Kwenye mashine yako
- Daftari, madokezo ya kumbukumbu, worktree na kila uendeshaji wa uhakiki, kwenye kompyuta yako au kwenye seva zako mwenyewe za Linux.
- Kinachohitaji mtandao
- Mawakala wako, wanaowasiliana na watoa huduma wao wenyewe kama wanavyofanya leo. Kila huduma nyingine ya nje ni ya hiari na imezimwa hadi utakapoiwasha.
- Mahitaji
- Windows au Linux (macOS bado haiungwi mkono), Python 3.12 au mpya zaidi, na Git. RADAR hutumia maktaba ya kawaida ya Python pekee.
- Gharama
- Haina bili yake yenyewe. Mawakala huendelea kutumia akaunti ulizowaingiza nazo. API ya kulipia hutumika tu ukitaja mtoa huduma na bajeti.
- Usakinishaji
- Mpe wakala wako wa uandishi wa msimbo kiungo cha hazina na useme “sakinisha hii”. Hukagua kompyuta yako, hukuuliza kabla ya kusakinisha chochote kinachokosekana, husakinisha RADAR ndani ya virtual environment na kukueleza kile ambacho radar init na radar doctor zinasema.
06 Amri
Orodha fupi ya amri.
Amri utakazotumia kwanza. Vishika-nafasi viko ndani ya mabano ya pembe.
| Amri | Inachofanya |
|---|---|
radar init | Huandaa saraka ya nyumbani ya RADAR na daftari. |
radar doctor | Hukagua usakinishaji na kuorodhesha huduma za hiari ambazo bado hazijasanidiwa. |
radar task new --project P --goal "…" --accept "<command>" | Hufungua kazi pamoja na amri yake ya ukubalifu. |
radar dispatch <task> | Hukabidhi kazi kwa wakala, anayefanya kazi katika worktree yake mwenyewe. |
radar status | Huonyesha mfumo mzima. |
radar verify <task> | Huendesha tena amri ya ukubalifu kwenye toleo la sasa. |
radar task done <task> --evidence "<verification report>" | Hufunga kazi. Hukataliwa hadi uhakiki ufaulu. |
radar collect | Hukusanya kazi iliyokamilika. |
radar integrate | Huunganisha kazi iliyohakikiwa kwenye main. |
radar stop | Huegesha kazi na kuweka STOP. |
radar go | Huondoa STOP na kuorodhesha kinachoweza kuendelea. |
radar memory search --local "<words>" | Hutafuta madokezo ya kumbukumbu bila mtandao. |
radar uiradar web | Hufungua cockpit kwenye terminal au kwenye kivinjari. |
radar help --all | Huorodhesha kila amri. radar <command> -h hutoa maelezo zaidi. |
07 Kile isichofanya
Kile ambacho RADAR haifanyi.
- Haichukui nafasi ya mawakala wako. Wao bado ndio huandika msimbo; RADAR huwapa daftari moja, ukaguzi mmoja wasioweza kuuruka na kumbukumbu moja.
- Haiandiki majaribio yako. Ukaguzi ni mzuri kwa kadiri jaribio lake lilivyo zuri; RADAR hufanya jaribio liandikwe waziwazi kabla kazi haijaanza, ili mtu aweze kulisoma.
- Haifungi kazi isiyo na jaribio. Kazi isiyo na amri ya ukubalifu inayoweza kuendeshwa hukataliwa inapofunguliwa.
- Haiwazuii mawakala wako kutumia mtandao. Bado huwasiliana na watoa huduma wao wenyewe, kama wanavyofanya leo.
- Toleo huria ni la wasanidi binafsi, si la timu; toleo la kampuni linatengenezwa.
08 Hali
Katika ufikiaji wa mapema
Ufikiaji wa mapema sasa. Chanzo huria itakapotolewa hadharani.
RADAR iko katika ufikiaji wa mapema. Itachapishwa kama chanzo huria chini ya leseni ya Apache-2.0 itakapotolewa hadharani. Ili kujiunga, tuandikie.