Sanidi Ofisi ya Mawakala na Simamia Wafanyakazi wa Usimbaji wa AI katika Nafasi ya Kazi ya Pamoja ya 3D

Agent Office Hufanya Nini

Agent Office hubadilisha uundaji wa programu unaosaidiwa na AI kuwa ofisi ya pamoja ya katuni ya 3D. Kila hazina ya GitHub huwa ghorofa tofauti yenye madawati, wafanyakazi wa kuandika msimbo, vituo vya kuamrisha, mbao za issues na pull requests, foleni ya kazi, huduma, na mipangilio mahususi ya mradi.

Unaweza kumkalisha mfanyakazi wa Claude Code, OpenCode, au Codex kwenye dawati, kutazama kituo chake cha kuamrisha moja kwa moja kwenye kompyuta ya mezani, na kufungua kituo hicho hicho pamoja na wenzako. Wafanyakazi wanaweza kufanya kazi kwenye checkout kuu au kwenye Git worktrees zilizotengwa, hivyo kuwezesha kuendesha kazi nyingi kwa wakati mmoja bila kushiriki saraka ya kazi.

Programu hii pia hutoa mwendo wa wachezaji wengi, mawasiliano ya sauti, kushiriki skrini, historia endelevu ya gumzo na vituo vya kuamrisha, arifa za wafanyakazi, ufuatiliaji wa mashine, usogezaji wa miradi, mtiririko wa kazi wa GitHub wa issues na pull requests, pamoja na mikutano iliyopangwa ya mawakala wengi.

Dhana Muhimu

Ghorofa moja kwa kila hazina

Mara ya kwanza Agent Office inapoanza, hufunguka kwenye lifti na kukuuliza uchague hazina inayoonekana kwa akaunti yako iliyothibitishwa ya GitHub CLI. Unaweza pia kuingiza hazina kwa muundo wa owner/name.

Hazina inanakiliwa kwenye:

~/agent-office/<owner>/<repo>

Kila ghorofa ya mradi ina wafanyakazi, madawati, mbao, foleni, huduma, picha, na rangi zake huru. Watu walio kwenye ghorofa moja pekee ndio wanaoweza kuwaona na kuwasikia wengine walioko kwenye ghorofa hiyo.

Wafanyakazi kwenye madawati

Dawati lililo wazi linaweza kuwa na Claude Code, OpenCode, Codex, au shell ya kuingia inayoshirikiwa. Dawati lenye mfanyakazi huonyesha kituo cha kuamrisha na hali ya mfanyakazi moja kwa moja. Hooks au programu-jalizi za mawakala huripoti ikiwa mfanyakazi anafanya kazi, anasubiri ingizo, au amemaliza.

Mbao za GitHub na uendeshaji wa kazi kiotomatiki

Ubao wa issues hupanga issues katika makundi ya wazi, zinazoendelea, na zilizofungwa. Ubao wa pull requests huonyesha rasimu, mapitio, uidhinishaji, miunganisho, kufungwa, hali ya CI, na ukubwa wa diff. Kazi zinaweza kukabidhiwa moja kwa moja kwa wafanyakazi au kuongezwa kwenye foleni endelevu kwa utekelezaji wa kiotomatiki.

Mahitaji na Usakinishaji

README iliyotolewa inaeleza jinsi ya kutumia Agent Office lakini haina amri ya usakinishaji kupitia kidhibiti cha vifurushi. Sakinisha mradi kwa kutumia maagizo ya usambazaji au ujenzi ya hazina, kisha hakikisha kitekelezi cha agent-office kinapatikana kwenye shell yako.

Kabla ya kuanza, thibitisha akaunti ya GitHub CLI ambayo seva inapaswa kutumia:

gh auth status

Ikiwa uthibitishaji haupo, kamilisha mchakato wa kuingia wa GitHub CLI:

gh auth login

Akaunti iliyochaguliwa huamua ni hazina zipi Agent Office inaweza kugundua na ni utambulisho upi unaotumika kwa vitendo vya GitHub kama vile kuchapisha maoni kwenye issues.

Unapaswa pia kuwa na angalau CLI moja ya wakala wa uandishi wa msimbo inayotumika na iliyosanidiwa kwenye mashine ikiwa unapanga kuajiri aina hiyo ya mfanyakazi. Agent Office inatumia wafanyakazi wa Claude Code, OpenCode, na Codex.

Anzisha Ofisi Yako ya Kwanza

Washa programu kwa:

agent-office

1. Fungua kiolesura cha Agent Office kwenye kivinjari chako ukitumia anwani iliyoonyeshwa na programu.
2. Tumia kiteuzi cha mradi kwenye lifti kuchagua hazina inayopatikana kupitia gh, au andika owner/name yake kamili.
3. Subiri Agent Office inakili hazina chini ya ~/agent-office.
4. Chagua rangi ya ngozi, mtindo wa nywele, rangi ya nywele, na shati la mhusika wako.
5. Ingia kwenye ghorofa mpya ya mradi.

Ili kuongeza au kutembelea mradi mwingine baadaye, tembea hadi kwenye lifti iliyo kwenye ukuta wa kaskazini na ubonyeze E. Unaweza pia kubofya jina la mradi katika kona ya juu kushoto na kuchagua ghorofa nyingine.

Usanidi wa hiari wa kuwasha

README inaandika chaguo kadhaa muhimu za seva. Kwa mfano:

agent-office --city Berlin --max-workers 4

Chaguo la --city Berlin hufanya mawio, machweo, na hali ya hewa vifuate Berlin. Chaguo la --max-workers 4 huweka kikomo cha seva nzima kwa wafanyakazi wanaoendesha kwa wakati mmoja katika maghorofa yote. Shell zinazoshirikiwa na mawakala wa mbao pia huhesabiwa katika kikomo hiki.

Arifa za timu zinaweza kuunganishwa na webhook inayoingia ya Slack au Discord:

agent-office --webhook <incoming-webhook-url>

Maonyo ya bajeti na kusitisha uajiri yanapatikana kupitia --budget na --budget-pause. Vidhibiti hivi hutumia matumizi yaliyofuatiliwa ya Claude Code pekee. Haviwezi kuweka kikomo cha moja kwa moja kwa matumizi ya OpenCode au Codex, ingawa kufikia kiwango cha uajiri kinachofuatiliwa husitisha wafanyakazi wote wapya.

Jifunze Vidhibiti vya Msingi

• WASD: Tembea kuzunguka ghorofa.
• Space: Ruka.
• Kuburuza kipanya: Zungusha kamera.
• E: Wasiliana na madawati, mbao, lifti, viti, ngazi, na vitu vingine vya ofisi.
• Tab: Fungua menyu kuu.
• T: Soma mistari ya hivi karibuni ya gumzo.
• P: Andika kazi kabla ya kuajiri kwenye dawati lililo wazi.
• B: Fungua shell ya kuingia inayoshirikiwa kwenye dawati lililo wazi.
• C: Kagua mabadiliko kwenye dawati lenye mfanyakazi.
• N: Mtembelee mfanyakazi ambaye amekuwa akisubiri kwa muda mrefu zaidi.
• R: Endeleza kikao cha mfanyakazi anayetumika ambacho kilitoka.
• /: Tafuta kwenye gumzo na historia ya vituo vya kuamrisha vya wafanyakazi.

Menyu kuu hufungua madirisha ya wafanyakazi, watu, issues, pull requests, foleni, huduma, utafutaji, sauti, kushiriki skrini, mipangilio, na paneli nyingine za hali. Vipengee vinavyotumiwa mara kwa mara vinaweza kubandikwa kwenye upau wa juu, na chaguo za mpangilio mahususi kwa kivinjari huhifadhiwa.

Ajiri Mfanyakazi Wako wa Kwanza wa Kuandika Msimbo

1. Nenda kwenye dawati tupu.
2. Bonyeza E.
3. Chagua Claude Code, OpenCode, au Codex.
4. Weka kazi unayotaka mfanyakazi aikamilishe.
5. Ikifaa, washa own git worktree.
6. Thibitisha kumwajiri na utazame terminali ya mfanyakazi ikitokea kwenye kompyuta mpakato.

Unaweza kubonyeza P kwenye dawati tupu unapotaka kutunga kazi kabla ya kuchagua wakala. Agent Office ina madawati 16. Yakiwa yamechukuliwa, vituo vya muda vya mifuko ya maharagwe vinaweza kuchukua hadi wafanyakazi 12 wa ziada.

Tumia worktree zilizotengwa kwa kazi sambamba

Washa own git worktree wakati wafanyakazi wengi wanaweza kuhariri hazina kwa wakati mmoja. Agent Office huunda tawi la office/<name> na kuweka checkout yake hapa:

.agent-office/worktrees/

Hii huwazuia wafanyakazi wanaofanya kazi sambamba kurekebisha checkout hiyo hiyo. Unapomrudisha nyumbani mfanyakazi wa worktree, unaweza kuhifadhi tawi na worktree, kufuta worktree pekee, au kufuta vyote viwili. Agent Office huonya kuhusu mabadiliko ambayo hayajawekwa kwenye commit na commits ambazo hazijafikia remote.

Ili kusafisha worktree zilizohifadhiwa wakati ni salama kufanya hivyo, endesha:

agent-office prune

Fungua na Ushirikiane kwenye Terminali ya Mfanyakazi

Bonyeza E kwenye dawati lililochukuliwa ili kufungua terminali yake halisi ya PTY kupitia WebSockets. Wenzako wengi wanaweza kuandika kwenye session hiyo kwa wakati mmoja, na wanaojiunga baadaye hupokea scrollback iliyopo.

Kichwa cha terminali kinaonyesha ni nani aliyeifungua kwa sasa. Pia huonyesha taarifa ya kuandika mtu mwingine anapoingiza maandishi, hivyo kupunguza uwezekano wa washirika kubadilishana maandishi ya ingizo.

Terminali za wafanyakazi na mistari yao 3,000 ya mwisho huhifadhiwa. Michakato ya mawakala huendeshwa tofauti na seva kuu, kwa hiyo wafanyakazi wanaweza kuendelea wakati seva inapopakiwa upya au mchakato unapoanzishwa tena. Terminali zilizofunguliwa huunganishwa kiotomatiki seva inaporejea.

Elewa hali hai ya mfanyakazi

Antena na uhuishaji wa mfanyakazi huonyesha hali yake. Wafanyakazi wanaweza kuonekana kuwa working, needs input, au done. Uhuishaji wao pia huonyesha vitendo kama vile kusoma faili, kuhariri msimbo, kuendesha majaribio, kutafuta kwenye wavuti, au kukumbana na hitilafu zinazorudiwa.

Mfanyakazi anapohitaji msaada au anapokamilisha kazi yake, Agent Office hucheza arifa na kumweka mfanyakazi huyo kwenye hesabu ya wanaosubiri. Bonyeza N kumwendea mfanyakazi wa zamani zaidi anayesubiri. Kubonyeza N mara kwa mara huzunguka kati ya wafanyakazi wanaosubiri.

Kagua Mabadiliko na Fungua Pull Request

Kwenye dawati lililochukuliwa, bonyeza C au chagua Changes kutoka kwenye terminali. Mwonekano wa mabadiliko huonyesha faili zilizobadilishwa na diff inayosasishwa mfululizo dhidi ya tawi ambalo ofisi ilifunguliwa juu yake.

Kutoka kwenye mwonekano huu, unaweza:

• Kagua faili zilizobadilishwa na diff zake.
• Weka mabadiliko ya mfanyakazi kwenye commit.
• Tupa mabadiliko usiyoyataka.
• Push tawi.
• Fungua pull request.

Kwa mfanyakazi anayetumia worktree iliyotengwa, bonyeza O kwenye dawati kazi ikiwa tayari. Agent Office hupush tawi na kufungua pull request yenye kichwa na maelezo yaliyotungwa kutokana na kazi hiyo. Kazi iliyotokana na issue ya GitHub huwa na rejeleo la Closes #n. Bonyeza O tena ili kutazama pull request.

Fanya Kazi na GitHub Issues

Ubao wa issues huonyesha issues zilizo wazi, zinazoendelea, na zilizofungwa. Chagua issue ili kusoma maelezo na maoni yake, kuchapisha maoni, kuituma kwa mfanyakazi, au kuiongeza kwenye foleni ya kazi.

Pia unaweza kuchukua kadi ya issue moja kwa moja:

1. Elekeza kwenye noti ya issue na bonyeza E, au tumia Pick it up kwenye dirisha la issue.
2. Carry kadi hadi kwenye dawati tupu ili kumwajiri mfanyakazi mpya.
3. Carry hadi kwenye dawati lililochukuliwa ili kumpa mfanyakazi huyo.
4. Carry hadi kwenye foleni ya kazi ili kuiweka kwenye foleni.
5. Bonyeza Q ikiwa unataka kurudisha kadi kwenye ubao.

Mfanyakazi anapopokea kadi ya issue, Agent Office huikabidhi issue hiyo kupitia GitHub na kuihamisha hadi hali ya in-progress. Issues pia zinaweza kufungwa kama zimekamilika au hazijapangwa, pamoja na maoni ya hiari.

Kagua na Unganisha Pull Requests

Ubao wa PR huweka pull requests katika hali za draft, in-review, approved, merged, na closed. Pia huripoti hali ya CI na ukubwa wa diff.

Fungua pull request na uchague Files changed ili kukagua diff yake. Faili zinaweza kuonyeshwa kama mti wa folda au orodha bapa. Maoni ya ukaguzi huonekana chini ya mistari inayohusiana.

• Bonyeza V kuashiria faili kuwa imekaguliwa.
• Tumia J na K kusogea kati ya faili.
• Chagua Review ili kumpa mfanyakazi PR.
• Chagua Fix comments & merge ili mfanyakazi ashughulikie maoni, afanye ukaguzi ufaulu, na aunganishe.
• Tawi likigongana na msingi wake, tumia Fix conflicts & merge.

Agent Office inaweza kusquash, kuunganisha, au kurebase pull request. Pia inaweza kuiomba GitHub iunganishe kiotomatiki baada ya ukaguzi unaohitajika kufaulu. Pull request inapounganishwa, ofisi hupiga kengele yake ya muunganisho, huachilia confetti, na kuwawekea wafanyakazi wanaofanya kazi uhuishaji.

Otomatisha Kazi kwa Foleni ya Kazi

Foleni ya kazi inapatikana kwenye ubao mweupe wa ukuta wa kaskazini au kwenye menyu kuu. Ongeza kazi ya maandishi huru au weka issue kwenye foleni, kisha iruhusu Agent Office igawie kazi hiyo kiotomatiki.

Dawati linapopatikana na mipangilio ya ulinganifu wa foleni inaporuhusu mfanyakazi mwingine, kazi inayofuata hupokea mfanyakazi mpya katika Git worktree iliyotengwa. Ulinganifu chaguo-msingi wa foleni ni wafanyakazi watatu. Kuweka workers at once kuwa sufuri husitisha foleni.

Kazi za masuala zilizo kwenye foleni hugawiwa kwenye GitHub, na ombi la kuvuta linalotokana na kazi hiyo huunganishwa kwenye ubao wa foleni linapotokea. Wafanyakazi waliokamilisha kazi hubaki kwenye madawati yao kwa ajili ya ukaguzi hadi foleni ihitaji nafasi hiyo kwa kazi nyingine. Hali ya foleni huhifadhiwa hata baada ya kuwasha upya mfumo.

Tumia Mawakala Maalum wa Ubao

Ubao wa masuala, ubao wa maombi ya kuvuta, na foleni ya kazi kila moja ina wakala wa kibanda. Tembea hadi kwenye kibanda na ubonyeze E ili kumpa maagizo.

• Wakala wa masuala: Hutafuta, huunda, hupanga, huweka lebo, na hufunga masuala kupitia gh.
• Wakala wa PR: Hutoa muhtasari, hukagua, hutoa maoni kuhusu, na huunganisha maombi ya kuvuta.
• Wakala wa foleni: Hubadilisha ombi kuwa kazi moja au zaidi zilizo kwenye foleni, huripoti hali ya foleni, na huondoa kazi.

Wakala wa foleni hatekelezi mabadiliko ya msimbo yenyewe. Huunda kazi za foleni ili wafanyakazi wapya waweze kufanya kazi hiyo kwenye miti ya kazi iliyotengwa. Bonyeza O kwenye kibanda ili kukagua terminal yake au X ili kumtuma wakala nyumbani.

Endesha Mikutano Iliyopangwa ya Mawakala Wengi

Chumba cha mikutano kinaunga mkono vikundi vya wafanyakazi wawili hadi watano. Anzisha mkutano kutoka kwenye chumba, menyu kuu, suala, au ombi la kuvuta. Kila mshiriki ana jukumu unaloweza kulibadilisha jina.

Mifumo inayopatikana inajumuisha:

• Mjadala: Wafanyakazi hupendekeza mbinu, hukosoana, na kutoa uamuzi wa mwisho.
• Kiongozi na timu: Kiongozi hugawanya kazi, hukabidhi sehemu, na kuunganisha matokeo.
• Map-reduce: Wapangaji huchakata faili, moduli, masuala, au sehemu nyingine tofauti kabla ya mfanyakazi mmoja kuunganisha matokeo.
• Timu nyekundu / bluu: Wafanyakazi wa timu nyekundu hutambua hitilafu, hatari za usalama, na hali za pembezoni, huku wafanyakazi wa timu ya bluu wakishughulikia mambo yaliyothibitishwa.
• Jopo la ukaguzi: Wakaguzi huchunguza ombi la kuvuta kwa mitazamo tofauti kabla ya kiongozi kuunganisha na kuchapisha ukaguzi.

Kila mkutano hutangaza faili la matokeo na huendeshwa kwenye tawi lake. Matokeo yanapokuwa tayari, tumia Open PR kuunda ombi la kuvuta. Mikutano ina mipaka ya raundi na bajeti ya tokeni ya meza nzima, hivyo kuizuia kuendelea bila kikomo.

Fuatilia Huduma, Rasilimali, na Matumizi

Huduma za uundaji

Wakati mfanyakazi anapoanzisha seva ya wavuti kama npm run dev, muundo wa hakikisho, au python -m http.server, huonekana kwenye ubao wa Huduma ndani ya sekunde chache. Kila ingizo hutambua mfanyakazi, tawi, na kichwa cha ukurasa. Kulichagua kunakili amri ya kufungua seva hiyo kutoka kwenye kompyuta yako mwenyewe.

Mzigo wa mashine na mipaka ya wafanyakazi

Kifuatiliaji cha ukuta wa magharibi huonyesha matumizi ya sasa ya CPU na kumbukumbu, historia za dakika tano, na idadi ya wafanyakazi wanaoendesha. Kumbukumbu ikifikia asilimia 90, au CPU ikibaki na shughuli ya asilimia 90 kwa takribani nusu dakika, Agent Office huonya kwamba mashine iko chini ya mzigo mkubwa.

Thamani ya kiwango cha seva ya --max-workers hutoa kikomo cha juu kisichoweza kuvukwa. Msimamizi anaweza kupunguza kikomo kinachotumika kwenye mipangilio lakini hawezi kukiongeza zaidi ya thamani ya kuanzisha. Uwezo ukiwa umejaa, uajiri wa mikono hukataliwa kwa maelezo, huku kazi zilizo kwenye foleni zikisubiri nafasi ifunguke.

Ripoti za matumizi na gharama

Wafanyakazi wa Claude Code huripoti gharama ya kipindi na tokeni zilizofuatiliwa. OpenCode huripoti tokeni na makadirio ya modeli/mtoa huduma, ikijumuisha vipindi vya watoto inapopatikana. Codex huripoti tokeni zilizorekodiwa za kipindi kikuu, ikijumuisha mgawanyo wa akiba na hoja, lakini si gharama wala idadi ya miito ya API.

Washa Claude limits kutoka kwenye menyu ili kuonyesha matumizi ya mpango wa Claude kwa kipindi cha saa tano, mgao wa kila wiki, na kikomo chochote cha kila wiki cha modeli maalum. Paneli hii hufichwa Claude anapotumia ufunguo wa API badala ya mpango, na haijumuishi OpenCode au Codex.

Vidokezo vya Juu vya Ushirikiano

• Tumia miti ya kazi kwa chaguo-msingi unapoweka msimbo kwa wakati mmoja: Hii huwazuia wafanyakazi kushiriki faili ambazo hazijafanyiwa commit au kubadilisha matawi ya wenzao.
• Tenganisha upangaji na utekelezaji: Tumia mawakala wa masuala na foleni kupanga kazi, kisha waache wafanyakazi wapya wa miti ya kazi wafanye mabadiliko ya msimbo.
• Weka ushindani wa foleni chini ya kikomo cha mashine: Acha uwezo kwa wafanyakazi wanaoingiliana, maganda yanayoshirikiwa, na mawakala wa ubao.
• Tumia arifa za eneo-kazi: Zinaweza kukupeleka moja kwa moja kwa mfanyakazi anayehitaji maelekezo au aliyemaliza kazi wakati kichupo cha ofisi kiko nyuma.
• Sanidi webhooks za timu: Arifa za Slack au Discord husaidia timu kuwaona wafanyakazi ambao wameachwa bila uangalizi.
• Tafuta kabla ya kufungua tena vipindi: Bonyeza / kutafuta kwenye mazungumzo na matokeo yote ya terminal yaliyohifadhiwa, ikijumuisha historia ya kabla ya kuwasha upya.
• Tumia ganda linaloshirikiwa kwa kazi za usaidizi: Bonyeza B kwenye dawati tupu unapohitaji terminal ya ushirikiano kwa majaribio, amri za Git, au seva za uundaji bila kuajiri mfanyakazi wa AI.
• Kagua kabla ya kuwatuma wafanyakazi nyumbani: Kagua historia ya terminal na mabadiliko, kisha amua kama uhifadhi au uondoe tawi na mti wa kazi wa mfanyakazi.

Hitimisho

Agent Office huunganisha mawakala wa AI wa kuandika msimbo, miti ya kazi ya Git, terminali zinazoshirikiwa, mbao za GitHub, foleni, arifa, na ushirikiano wa wachezaji wengi katika kiolesura kimoja cha anga. Anza na sakafu moja ya mradi na mfanyakazi mmoja aliyejitenga, kisha anzisha kazi zilizo kwenye foleni, mawakala wa ubao, mtiririko wa maombi ya kuvuta, na mikutano iliyopangwa kadiri timu yako inavyozoea uundaji sambamba unaosaidiwa na AI.