Agent Office’ni sozlash va umumiy 3D ish maydonida AI kod yozuvchi ishchilarni boshqarish

Agent Office nima qiladi

Agent Office sun’iy intellekt yordamidagi dasturiy ta’minot ishlab chiqishni umumiy multfilm uslubidagi 3D ofisga aylantiradi. Har bir GitHub repozitoriysi alohida qavatga aylanadi; unda stollar, kod yozuvchi ishchilar, terminallar, issue va pull request taxtalari, vazifalar navbati, xizmatlar hamda loyiha uchun maxsus sozlamalar mavjud.

Siz stolga Claude Code, OpenCode yoki Codex ishchisini joylashtirishingiz, uning stol ustidagi noutbukda ishlayotgan jonli terminalini kuzatishingiz va shu terminalni jamoa a’zolari bilan birga ochishingiz mumkin. Ishchilar asosiy checkout ichida yoki alohida Git worktree’larda ishlashi mumkin, bu esa bitta ishchi katalogini bo‘lishmasdan bir nechta vazifani parallel bajarish imkonini beradi.

Ilova shuningdek ko‘p foydalanuvchili harakatlanish, ovozli aloqa, ekran ulashish, saqlanib qoluvchi chat va terminal tarixi, ishchi bildirishnomalari, kompyuterni kuzatish, loyihalar bo‘ylab navigatsiya, GitHub issue va pull request jarayonlari hamda tuzilgan ko‘p agentli uchrashuvlarni taqdim etadi.

Asosiy tushunchalar

Har bir repozitoriy uchun bittadan qavat

Agent Office birinchi marta ishga tushganda lift oynasida ochiladi va autentifikatsiyadan o‘tgan GitHub CLI hisobingizga ko‘rinadigan repozitoriylardan birini tanlashni so‘raydi. Repozitoriyni owner/name ko‘rinishida ham kiritishingiz mumkin.

Repozitoriy quyidagi joyga klonlanadi:

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

Har bir loyiha qavatida mustaqil ishchilar, stollar, taxtalar, navbatlar, xizmatlar, rasmlar va ranglar bo‘ladi. Bir qavatdagi odamlar faqat shu qavatdagi boshqalarni ko‘rishi va eshitishi mumkin.

Stollardagi ishchilar

Bo‘sh stolga Claude Code, OpenCode, Codex yoki umumiy login shell joylashtirilishi mumkin. Band stol ishchining jonli terminali va holatini ko‘rsatadi. Agent hook’lari yoki plaginlari ishchi ishlayotganini, kiritish ma’lumotini kutayotganini yoki ishni tugatganini bildiradi.

GitHub taxtalari va vazifalarni avtomatlashtirish

Issues taxtasi issue’larni ochiq, jarayonda va yopilgan guruhlarga ajratadi. Pull request taxtasi qoralamalar, ko‘rib chiqishlar, tasdiqlar, birlashtirishlar, yopilishlar, CI holati va diff hajmini ko‘rsatadi. Vazifalarni bevosita ishchilarga berish yoki avtomatik bajarish uchun doimiy navbatga qo‘shish mumkin.

Talablar va o‘rnatish

Taqdim etilgan README Agent Office’dan foydalanish tartibini tushuntiradi, ammo paket menejeri orqali o‘rnatish buyrug‘ini o‘z ichiga olmaydi. Loyihani repozitoriyning tarqatish yoki yig‘ish yo‘riqnomalaridan foydalanib o‘rnating, so‘ng agent-office bajariladigan fayli shell’ingizda mavjudligiga ishonch hosil qiling.

Ishga tushirishdan oldin server foydalanadigan GitHub CLI hisobida autentifikatsiyadan o‘ting:

gh auth status

Agar autentifikatsiya mavjud bo‘lmasa, GitHub CLI orqali kirish jarayonini yakunlang:

gh auth login

Tanlangan hisob Agent Office qaysi repozitoriylarni topa olishini va issue izohlarini joylash kabi GitHub amallarida qaysi shaxsiy ma’lumotlardan foydalanilishini belgilaydi.

Agar muayyan turdagi ishchini yollamoqchi bo‘lsangiz, kompyuterda kamida bitta qo‘llab-quvvatlanadigan kod yozuvchi agent CLI sozlangan bo‘lishi kerak. Agent Office Claude Code, OpenCode va Codex ishchilarini qo‘llab-quvvatlaydi.

Birinchi ofisingizni ishga tushiring

Ilovani quyidagi buyruq bilan ishga tushiring:

agent-office

1. Ilova ko‘rsatgan manzil orqali brauzeringizda Agent Office interfeysini oching.
2. Liftning loyiha tanlagichidan gh orqali mavjud repozitoriyni tanlang yoki uning to‘liq owner/name nomini kiriting.
3. Agent Office repozitoriyni ~/agent-office ichiga klonlayotganda kuting.
4. Qahramoningizning teri rangi, soch turmagi, soch rangi va ko‘ylagini tanlang.
5. Yangi loyiha qavatiga kiring.

Keyinroq boshqa loyiha qo‘shish yoki unga tashrif buyurish uchun shimoliy devordagi liftga boring va E tugmasini bosing. Shuningdek, yuqori chap burchakdagi loyiha nomini bosib, boshqa qavatni tanlashingiz mumkin.

Ixtiyoriy ishga tushirish sozlamalari

README bir nechta foydali server parametrlarini hujjatlashtiradi. Masalan:

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

--city Berlin parametri quyosh chiqishi, quyosh botishi va ob-havoni Berlin shahriga moslaydi. --max-workers 4 parametri barcha qavatlarda bir vaqtda ishlayotgan ishchilar soniga server miqyosida cheklov qo‘yadi. Umumiy shell’lar va taxta agentlari ham ushbu cheklovga hisoblanadi.

Jamoa bildirishnomalarini Slack yoki Discord’ning kiruvchi webhook’iga ulash mumkin:

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

Byudjet ogohlantirishlari va yollashni to‘xtatib turish --budget va --budget-pause orqali mavjud. Bu boshqaruvlar faqat kuzatiladigan Claude Code xarajatlaridan foydalanadi. Ular OpenCode yoki Codex xarajatlarini bevosita cheklay olmaydi, biroq kuzatiladigan yollash chegarasiga yetilganda barcha yangi ishchilarni ishga tushirish to‘xtatiladi.

Asosiy boshqaruvlarni o‘rganing

• WASD: Qavat bo‘ylab yuring.
• Space: Sakrang.
• Sichqonchani sudrash: Kamerani aylantiring.
• E: Stollar, taxtalar, liftlar, o‘rindiqlar, narvonlar va boshqa ofis obyektlari bilan o‘zaro aloqada bo‘ling.
• Tab: Asosiy menyuni oching.
• T: So‘nggi chat satrlarini o‘qing.
• P: Bo‘sh stolda ishchi yollashdan oldin vazifa yozing.
• B: Bo‘sh stolda umumiy login shell’ini oching.
• C: Band stoldagi o‘zgarishlarni tekshiring.
• N: Eng uzoq kutayotgan ishchining oldiga boring.
• R: Chiqib ketgan qo‘llab-quvvatlanadigan ishchi sessiyasini davom ettiring.
• /: Chat va ishchi terminali tarixidan qidiring.

Asosiy menyu ishchilar, odamlar, issue’lar, pull request’lar, navbat, xizmatlar, qidiruv, ovozli aloqa, ekran ulashish, sozlamalar va boshqa holat panellari uchun oynalarni ochadi. Tez-tez ishlatiladigan elementlarni yuqori panelning boshiga mahkamlash mumkin, brauzerga xos joylashuv tanlovlari esa saqlanib qoladi.

Birinchi kod yozuvchi ishchingizni yollang

1. Bo‘sh stolga boring.
2. E tugmasini bosing.
3. Claude Code, OpenCode yoki Codex’ni tanlang.
4. Ishchi bajarishi kerak bo‘lgan vazifani kiriting.
5. Zarur bo‘lsa, o‘z git worktree’i opsiyasini yoqing.
6. Ishchini yollashni tasdiqlang va uning terminali noutbukda paydo bo‘lishini kuzating.

Agentni tanlashdan oldin vazifani tuzmoqchi bo‘lsangiz, bo‘sh stol yonida P tugmasini bosishingiz mumkin. Agent Office 16 ta stolni taqdim etadi. Agar ularning barchasi band bo‘lsa, vaqtinchalik pufik ish joylarida yana 12 nafargacha ishchi joylashishi mumkin.

Parallel vazifalar uchun ajratilgan worktree’lardan foydalaning

Bir nechta ishchi bir vaqtning o‘zida repozitoriyga o‘zgartirish kiritishi mumkin bo‘lsa, o‘z git worktree’i opsiyasini yoqing. Agent Office office/<name> branch’ini yaratadi va uning checkout’ini quyidagi joyga joylashtiradi:

.agent-office/worktrees/

Bu parallel ishchilarning bir xil checkout’ni o‘zgartirishiga yo‘l qo‘ymaydi. Worktree’dan foydalanayotgan ishchini uyiga jo‘natishda branch va worktree’ni saqlab qolish, faqat worktree’ni o‘chirish yoki ikkalasini ham o‘chirish mumkin. Agent Office commit qilinmagan o‘zgarishlar va masofaviy repozitoriyga yuborilmagan commitlar haqida ogohlantiradi.

Saqlab qolingan worktree’larni xavfsiz bo‘lganda tozalash uchun quyidagini ishga tushiring:

agent-office prune

Ishchi terminalini oching va hamkorlik qiling

Band stol yonida uning haqiqiy PTY terminalini WebSockets orqali ochish uchun E tugmasini bosing. Bir nechta hamkasb bir vaqtning o‘zida sessiyaga yozishi mumkin, kechroq qo‘shilganlar esa mavjud terminal tarixini ko‘radi.

Terminal sarlavhasida hozirda terminalni kim ochgani ko‘rsatiladi. Shuningdek, boshqa kishi matn kiritayotganida yozish haqida bildirishnoma chiqadi. Bu hamkorlarning bir-biri kiritayotgan ma’lumotni ustidan yozib yuborish ehtimolini kamaytiradi.

Ishchi terminallari va ularning so‘nggi 3 000 qatori saqlanadi. Agent jarayonlari asosiy serverdan alohida ishlaydi, shuning uchun ishchilar server qayta yuklanganda yoki jarayon qayta ishga tushirilganda ham davom etishi mumkin. Server qaytgach, ochiq terminallar avtomatik ravishda qayta ulanadi.

Ishchining joriy holatini tushuning

Ishchining antennasi va animatsiyasi uning holatini bildiradi. Ishchilar ishlamoqda, kiritish kerak yoki tayyor holatlarida ko‘rinishi mumkin. Ularning animatsiyalari fayllarni o‘qish, kodni tahrirlash, testlarni ishga tushirish, internetdan qidirish yoki takroriy xatolarga duch kelish kabi harakatlarni ham aks ettiradi.

Ishchiga yordam kerak bo‘lganda yoki u vazifasini tugatganda, Agent Office bildirishnoma beradi va ishchini kutayotganlar sonida ko‘rsatadi. Eng uzoq kutayotgan ishchiga o‘tish uchun N tugmasini bosing. N tugmasini takroran bosish kutayotgan ishchilar bo‘ylab navbatma-navbat o‘tkazadi.

O‘zgarishlarni ko‘rib chiqing va pull request oching

Band stol yonida C tugmasini bosing yoki terminaldan O‘zgarishlarni tanlang. O‘zgarishlar ko‘rinishida o‘zgartirilgan fayllar va office ochilgan branch bilan doimiy yangilanib turadigan diff ko‘rsatiladi.

Bu ko‘rinishdan quyidagilarni bajarishingiz mumkin:

• O‘zgartirilgan fayllar va ularning diff’larini tekshirish.
• Ishchi o‘zgarishlarini commit qilish.
• Keraksiz o‘zgarishlarni bekor qilish.
• Branch’ni push qilish.
• Pull request ochish.

Ajratilgan worktree’dan foydalanayotgan ishchi uchun ish tayyor bo‘lganda stol yonida O tugmasini bosing. Agent Office branch’ni push qiladi va vazifadan kelib chiqib tayyorlangan sarlavha hamda tavsif bilan pull request ochadi. GitHub issue’dan kelib chiqqan ishda Closes #n havolasi bo‘ladi. Pull request’ni ko‘rish uchun O tugmasini yana bosing.

GitHub issue’lari bilan ishlang

Issue’lar taxtasida ochiq, jarayondagi va yopilgan issue’lar ko‘rsatiladi. Uning tavsifi va izohlarini o‘qish, izoh qoldirish, ishchiga yuborish yoki vazifalar navbatiga qo‘shish uchun issue’ni tanlang.

Issue kartasini jismonan olib yurishingiz ham mumkin:

1. Issue yozuviga ishora qilib E tugmasini bosing yoki issue oynasidagi Olib qo‘yish tugmasidan foydalaning.
2. Yangi ishchi yollash uchun kartani bo‘sh stolga olib boring.
3. Kartani shu ishchiga berish uchun band stolga olib boring.
4. Navbatga qo‘shish uchun uni vazifalar navbatiga olib boring.
5. Kartani taxtaga qaytarmoqchi bo‘lsangiz, Q tugmasini bosing.

Ishchi issue kartasini olganda, Agent Office GitHub orqali ushbu issue’ni ishchiga biriktiradi va uni jarayondagi holatga o‘tkazadi. Issue’larni bajarilgan yoki rejalashtirilmagan deb yopish, shuningdek ixtiyoriy izoh qoldirish mumkin.

Pull request’larni ko‘rib chiqing va birlashtiring

PR taxtasi pull request’larni draft, ko‘rib chiqilmoqda, tasdiqlangan, birlashtirilgan va yopilgan holatlar bo‘yicha guruhlaydi. Unda CI holati va diff hajmi ham ko‘rsatiladi.

Pull request’ni oching va uning diff’ini tekshirish uchun O‘zgartirilgan fayllarni tanlang. Fayllarni papkalar daraxti yoki tekis ro‘yxat ko‘rinishida ko‘rsatish mumkin. Ko‘rib chiqish izohlari ularga tegishli qatorlar ostida ko‘rsatiladi.

• Faylni ko‘rib chiqilgan deb belgilash uchun V tugmasini bosing.
• Fayllar o‘rtasida o‘tish uchun J va K tugmalaridan foydalaning.
• PR’ni ishchiga topshirish uchun Ko‘rib chiqishni tanlang.
• Ishchi fikr-mulohazalarni ko‘rib chiqishi, tekshiruvlardan muvaffaqiyatli o‘tishni ta’minlashi va birlashtirishi uchun Izohlarni tuzatish va birlashtirishni tanlang.
• Branch asosiy branch bilan ziddiyatga ega bo‘lsa, Ziddiyatlarni tuzatish va birlashtirishdan foydalaning.

Agent Office pull request’ni squash qilishi, birlashtirishi yoki rebase qilishi mumkin. Shuningdek, talab qilinadigan tekshiruvlardan muvaffaqiyatli o‘tilgach, GitHub’dan avtomatik birlashtirishni so‘rashi mumkin. Pull request birlashtirilganda, office birlashtirish gongini chaladi, konfetti sochadi va faol ishchilarni jonlantiradi.

Vazifalar navbati bilan ishni avtomatlashtiring

Vazifalar navbatiga shimoliy devordagi doska yoki asosiy menyu orqali kirish mumkin. Erkin matnli vazifa qo‘shing yoki issue’ni navbatga qo‘ying, so‘ng Agent Office ishni avtomatik tayinlasin.

Stol bo‘sh bo‘lganda va navbatning bir vaqtdagi ishchilar soni sozlamasi yana bir ishchiga ruxsat berganda, keyingi vazifa ajratilgan Git worktree’da yangi ishchiga beriladi. Navbatdagi bir vaqtdagi ishchilarning standart soni uchta. Bir vaqtda ishlaydigan ishchilar sonini nolga o‘rnatish navbatni pauza qiladi.

Navbatdagi ishlar GitHub’da tayinlanadi va natijada yaratilgan pull request paydo bo‘lganda navbat taxtasiga bog‘lanadi. Ishini tugatgan workerlar navbatga boshqa vazifa uchun joy kerak bo‘lguncha tekshirish uchun o‘z stollarida qoladi. Navbat holati qayta ishga tushirishlardan keyin ham saqlanadi.

Maxsus taxta agentlaridan foydalaning

Issues taxtasi, PR taxtasi va vazifalar navbatining har birida kiosk agenti mavjud. Kiosk yoniga boring va unga prompt berish uchun E tugmasini bosing.

• Issues agenti: gh orqali issues’larni topadi, yaratadi, saralaydi, yorliqlaydi va yopadi.
• PR agenti: pull request’larni umumlashtiradi, ko‘rib chiqadi, ularga izoh qoldiradi va birlashtiradi.
• Navbat agenti: so‘rovni bir yoki bir nechta navbatdagi vazifaga aylantiradi, navbat holatini bildiradi va vazifalarni olib tashlaydi.

Navbat agenti kod o‘zgarishlarini bevosita amalga oshirmaydi. U yangi workerlar ishni ajratilgan worktree’larda bajarishi uchun navbatdagi vazifalarni yaratadi. Uning terminalini ko‘rish uchun kioskda O tugmasini, agentni uyiga yuborish uchun esa X tugmasini bosing.

Tuzilgan ko‘p-agentli yig‘ilishlarni o‘tkazing

Yig‘ilish xonasi ikki nafardan besh nafargacha worker guruhlarini qo‘llab-quvvatlaydi. Yig‘ilishni xona, asosiy menyu, issue yoki pull request’dan boshlang. Har bir ishtirokchining rolini qayta nomlashingiz mumkin.

Mavjud shakllar:

• Munozara: Workerlar yondashuvlarni taklif qiladi, bir-birini tanqid qiladi va yakuniy qaror chiqaradi.
• Rahbar va jamoa: Rahbar vazifani bo‘ladi, qismlarni taqsimlaydi va natijalarni birlashtiradi.
• Map-reduce: Mapperlar alohida fayllar, modullar, issue’lar yoki boshqa qismlarni qayta ishlaydi, so‘ng bir worker topilmalarni birlashtiradi.
• Qizil / ko‘k: Qizil jamoa workerlar xatolar, xavfsizlik xatarlari va chekka holatlarni aniqlaydi, ko‘k jamoa workerlar esa asosli topilmalarni bartaraf etadi.
• Ko‘rib chiqish hay’ati: Ko‘rib chiquvchilar pull request’ni turli nuqtayi nazarlardan tekshiradi, so‘ng rahbar natijalarni birlashtirib, ko‘rib chiqish xulosasini joylaydi.

Har bir yig‘ilish chiqish faylini belgilaydi va o‘z branch’ida ishlaydi. Chiqish tayyor bo‘lganda pull request yaratish uchun Open PR tugmasidan foydalaning. Yig‘ilishlarda raundlar chegarasi va butun stol uchun token budjeti mavjud bo‘lib, bu ularning cheksiz davom etishiga yo‘l qo‘ymaydi.

Xizmatlar, resurslar va xarajatlarni kuzating

Ishlab chiqish xizmatlari

Worker npm run dev, preview build yoki python -m http.server kabi veb-serverni ishga tushirganda, u bir necha soniya ichida Services taxtasida ko‘rinadi. Har bir yozuv worker, branch va sahifa sarlavhasini ko‘rsatadi. Uni tanlash serverni o‘z kompyuteringizdan ochish buyrug‘ini nusxalaydi.

Mashina yuklamasi va worker cheklovlari

G‘arbiy devordagi monitor joriy CPU va xotira sarfini, besh daqiqalik tarixni hamda ishlayotgan workerlar sonini ko‘rsatadi. Xotira 90 foizga yetganda yoki CPU taxminan yarim daqiqa davomida 90 foiz band bo‘lib turganda, Agent Office mashina yuqori yuklama ostida ekanidan ogohlantiradi.

Server darajasidagi --max-workers qiymati qat’iy yuqori chegarani belgilaydi. Administrator sozlamalarda faol limitni pasaytirishi mumkin, ammo uni ishga tushirishda belgilangan qiymatdan oshira olmaydi. Imkoniyat to‘liq band bo‘lganda, qo‘lda yollashlar sabab ko‘rsatilgan holda rad etiladi, navbatdagi vazifalar esa bo‘sh joyni kutadi.

Foydalanish va xarajatlar hisoboti

Claude Code workerlar kuzatilgan sessiya xarajati va tokenlar haqida hisobot beradi. OpenCode tokenlar hamda model/provayder hisob-kitoblarini, mavjud bo‘lsa, farzand sessiyalarni ham qo‘shgan holda bildiradi. Codex kesh va reasoning tafsilotlarini o‘z ichiga olgan qayd etilgan root-sessiya tokenlari haqida hisobot beradi, ammo xarajat yoki API chaqiruvlari sonini ko‘rsatmaydi.

Besh soatlik sessiya, haftalik kvota va modelga xos haftalik limit mavjudligini ko‘rish uchun menyudan Claude limitsni yoqing. Claude reja o‘rniga API kalitidan foydalanganda bu panel yashiriladi va u OpenCode yoki Codex ma’lumotlarini o‘z ichiga olmaydi.

Ilg‘or hamkorlik bo‘yicha maslahatlar

• Bir vaqtda kodlash uchun sukut bo‘yicha worktree’lardan foydalaning: Bu workerlarning commit qilinmagan fayllarni bo‘lishishi yoki bir-birining branch’larini o‘zgartirishining oldini oladi.
• Rejalashtirishni amalga oshirishdan ajrating: Ishni tashkil qilish uchun issue va navbat agentlaridan foydalaning, so‘ng yangi worktree workerlariga kod o‘zgarishlarini kiritishga imkon bering.
• Navbatdagi parallel ishlashni mashina limitidan past tuting: Interaktiv workerlar, umumiy shell’lar va taxta agentlari uchun imkoniyat qoldiring.
• Ish stoli bildirishnomalaridan foydalaning: Ular ofis yorlig‘i fonda turganida kiritishingiz kerak bo‘lgan yoki ishini tugatgan workerga to‘g‘ridan-to‘g‘ri o‘tishingizga yordam beradi.
• Jamoa webhook’larini sozlang: Slack yoki Discord bildirishnomalari qarovsiz qolgan workerlarni jamoa payqashiga yordam beradi.
• Sessiyalarni qayta ochishdan oldin qidiring: Chat va saqlanib qolgan barcha terminal chiqishini, jumladan qayta ishga tushirishdan oldingi tarixni qidirish uchun / tugmasini bosing.
• Yordamchi ishlar uchun umumiy shell’dan foydalaning: Sun’iy intellekt workerini yollamasdan testlar, Git buyruqlari yoki ishlab chiqish serverlari uchun hamkorlikdagi terminal kerak bo‘lganda bo‘sh stolda B tugmasini bosing.
• Workerlarni uyiga yuborishdan oldin tekshiring: Terminal tarixini va o‘zgarishlarni ko‘rib chiqing, so‘ng worker branch’i va worktree’sini saqlash yoki olib tashlashni hal qiling.

Xulosa

Agent Office sun’iy intellekt kodlash agentlari, Git worktree’lari, umumiy terminallar, GitHub taxtalari, navbatlar, bildirishnomalar va ko‘p foydalanuvchili hamkorlikni bitta fazoviy interfeysda birlashtiradi. Bitta loyiha qavati va bitta ajratilgan worker bilan boshlang, keyin jamoangiz parallel AI yordamidagi ishlab chiqishga ko‘nikgani sari navbatdagi vazifalar, taxta agentlari, pull request jarayonlari va tuzilgan yig‘ilishlarni joriy qiling.