DevHub · Dla agentów AI
Przepływy pracy
Każdy przepływ podaje wywołania po kolei. Wszystkie identyfikatory bierz z wyników, nigdy z pamięci.
Odpowiedz, jak lub dlaczego coś działa
Dział zatytułowany „Odpowiedz, jak lub dlaczego coś działa”vault_list, jeśli nie maszvaultId. Przy pytaniu o jedno repozytorium wybierz vault tego repozytorium.knowledge_searchz pytaniem. Użyjrag_contextzamiast tego, gdy potrzebujesz opartego na źródłach kontekstu do rozumowania.- Przeczytaj najlepszy wynik:
knowledge_getdla wyniku,vault_file_readdla ścieżki notatki. - Pusty wynik:
vault_overviewpokazuje, które foldery zasilają wyszukiwanie,vault_files_searchczyta wszystkie foldery,knowledge_index_statusmówi, czy indeks jest gotowy. - Kod źródłowy otwieraj dopiero po vaulcie i tylko dla tego, czego vault nie mówi. Gdy oba się różnią, rację ma kod; zapisz poprawkę (zobacz „Zapisz wiedzę”).
Zmień kod
Dział zatytułowany „Zmień kod”context_pull.workspace_listpoworkspaceId;vault_listpo vault.vault_overviewna vaulcie repozytorium. Potemknowledge_searcho reguły tego repozytorium.repo_index_status;repo_index_refresh, jeśli indeks jest nieaktualny.repo_symbol_search, aby znaleźć miejsce,repo_filedla jego otoczenia,repo_impactirepo_callersprzed zmianą sygnatury.file_read, potemfile_replacelubfile_edit. Dla nowego plikufile_create.npm_script_list, potemnpm_script_runz własnym skryptem kontroli lub testów projektu.repo_index_refresh, potemrepo_changed, aby zobaczyć, że Twoje pliki trafiły do indeksu.- Podaj, co się zmieniło, i wynik kontroli.
Zbadaj coś przed budowaniem
Dział zatytułowany „Zbadaj coś przed budowaniem”investigation_list. Teren mógł być już zbadany, a odrzucony wariant warto znać.investigation_createz tytułem i repozytoriami.- Po każdym zakończonym kawałku badania
investigation_add. Jeden dokument na jeden sposób zrobienia rzeczy: analiza (co jest), wariant (jak wejść), plan (co zrobić), ustalenie (co rozstrzygnięto). - Nie możesz zamknąć śledztwa. Napisz w odpowiedzi, że jest gotowe do zamknięcia.
Pracuj z planu
Dział zatytułowany „Pracuj z planu”plan_ready, bezplanId, aby zobaczyć wszystkie plany. Nigdy nie zakładaj, że krok jest wolny, bo wygląda na następny.plan_claimzplanId,stepId. Podajby, jeśli punkt końcowy Cię nie identyfikuje. Odpowiedź zawiera krok, jego wznowienie i katalog roboczy.- Przeczytaj zlecenie kroku i
nextSteps. Decyzje właściciela umieszczone tam mają pierwszeństwo przed zleceniem. - Pracuj tylko w katalogu roboczym, który zwrócił claim.
- Przy długim kroku wywołuj
plan_renew. Claim, którego nikt nie odnawia, wygasa, a krok trafia do kogoś innego. - Zrób commit z trailerem kroku, potem
plan_closez sha commitów. Scala katalog roboczy i zapisuje, co weszło. Użyjas: "withdrawn"dla kroku, który się nie wydarzy; nic nie jest scalane. step_logna koniec każdego podejścia, także nieudanego: co zrobiono i co dalej.step_update, jeśli zmienił się status lub następne kroki.
Aby samemu otworzyć plan: plan_create, gdy śledztwo ustaliło, co robić, potem step_add dla każdego kawałka. Rozmiar kroku dobierz tak, by wszedł jako jeden commit. Wskaż kroki, na które czeka (bramki), i pliki, których dotyka (zakres).
Zapisz wiedzę
Dział zatytułowany „Zapisz wiedzę”vault_overviewlubvault_files_search, aby znaleźć miejsce notatki i sprawdzić, czy już istnieje. Ścieżkę weź z wyniku.vault_file_replace, aby poprawić notatkę,vault_file_createdla nowej. Vault musi zezwalać na zapis przez MCP.knowledge_index_refresh, jeśliknowledge_searchjeszcze nie zwraca Twojej notatki.- Coś poszło źle i powód warto opisać:
learning_note, jedna notatka na lekcję. Trwały fakt o pracy lub użytkowniku:memory_note.
Zapytaj innego agenta
Dział zatytułowany „Zapytaj innego agenta”agent_list. Pokazuje każdego agenta, klienta, który go uruchamia, i to, czy w ogóle może działać.agent_runzagentIditask. Po 45 sekundach może odpowiedziećRUNNING <runId>. To nie jest porażka.agent_run_statuszwait. Nie uruchamiaj zadania ponownie.
Sprawdź, co zrobiono
Dział zatytułowany „Sprawdź, co zrobiono”audit_summarydla pytania „czy teraz coś nie działa”,audit_listdla jednego nieudanego wywołania.display_screenshotpodisplay_list, aby zobaczyć wynik na ekranie, jeśli użytkownik na to pozwala.