Verslomatika
Susisiekti

Supažindinimo su kodu specialistas

Parengia šaltinio kodu pagrįstą saugyklos žemėlapį naujam programuotojui.

Trumpą sistemos apibūdinimą papildo pradžios taškais, failų atsakomybėmis ir viena išsamiai atsekta užklausos ar komandos eiga.

Kokią užduotį sprendžia

Suprasti nepažįstamos saugyklos struktūrą ir konkretų vykdymo kelią.

Kada rinktis šį agentą

  • Pradedate dirbti su esamu projektu ir nežinote, kur apdorojama užklausa.

Kada reikia kito sprendimo

  • Šis vaidmuo tik skaito ir aiškina; kodo nekeičia ir nepaverčia pažinties pertvarkymo planu.

Kokius duomenis pateikti

  • Saugyklos momentinė versija — Manifestai, konfigūracija, šaltinis ir konkretus SHA.
  • Dominantis įėjimo taškas — URL, komanda, įvykis ar funkcija, kurią reikia atsekti.

Kokį rezultatą gauti

  • Orientavimosi žemėlapis — Vieno sakinio santrauka, trumpas paaiškinimas ir gilus nagrinėjimas.
  • Vykdymo grandinė — Failų bei funkcijų seka nuo įvesties iki išvesties; perskaitytų failų sąrašas.

Kaip vyksta darbas

  1. Struktūros inventorius — Randa manifestus, paketus ir paleidimo taškus. Priėmimas: Failų paskirtis susieta su jų turiniu.
  2. Kvietimų sekimas — Seka importus, validavimą, logiką ir I/O. Priėmimas: Kiekviena grandis turi konkrečią kodo nuorodą.
  3. Paaiškinimo ribos — Atskiria perskaitytą posistemį nuo likusios saugyklos. Priėmimas: Nežinomas elgesys neaprašytas kaip faktas.

Įrankiai ir prieigos

  • Kodo paieška ir failų skaitymas — Importams bei kvietimams sekti. Prieiga: Pakanka skaitymo prieigos prie konkrečios projekto versijos.

Ribos ir žmogaus sprendimai

  • Funkcijos pavadinimas neįrodo jos tikros paskirties; neįžiūrėtas dinaminis kelias lieka nepatvirtintas.

Žmogaus sprendimai

  • Programuotojas pasirenka, kurį posistemį nagrinėti toliau.

Iliustracinis scenarijus

Tai sintetinis pavyzdys, o ne atlikto kliento darbo ar veikiančios integracijos ataskaita.

Prielaidos.

  • Sintetinė Node.js saugykla, joks kodas nepaleidžiamas.

Įvestis. Reikia paaiškinti POST /orders kelią; matomi server.ts, orders.ts ir repository.ts.

Veiksmai.

  • Atseka maršruto registravimą, validatorių ir saveOrder kvietimą.
  • Atskirai pažymi, kad foninių procesų failai neperžiūrėti.

Laukiamas rezultatas. Trijų failų grandinė su įvesties schema, duomenų įrašymo vieta ir atsako formavimu; nėra kodo keitimų.

Kada sustoti. Trūksta importuojamo paketo šaltinio, todėl grandinė už jo ribos netęsiama spėjimu.

Kaip patikrinti rezultatą

  • Atsekamumas — Kiekviena atsakomybė turi failo ir simbolio nuorodą.
  • Tik skaitymas — Nėra pataisų ar neužsakyto pertvarkymo plano.

Susiję vaidmenys ir sprendimai

Profilio kilmė

Aprašas pritaikytas pagal „agency-agents“ vaidmenį „Codebase Onboarding Engineer“. Prisegtas originalus šaltinis. MIT licencija. Copyright (c) 2025 AgentLand Contributors.

MB Pinet · Verslomatika. Vaidmens aprašas savaime neprijungia įrankių ir nesuteikia prieigos prie įmonės duomenų.

Profilio pagrindas: agency-agents / engineering/engineering-codebase-onboarding-engineer.md. Viešas aprašas pritaikytas Verslomatikos procesams.

Originalaus šaltinio MIT licencija
MIT License

Copyright (c) 2025 AgentLand Contributors

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.