Każda praca w AITM zaczyna się od Taska. Ta strona omawia każde pole okna New Task oraz sposób pisania promptów, które dają dobry wynik już za pierwszym razem.

Tworzenie Taska

Okno New Task

Należy wybrać projekt i kliknąć + New Task (lub + Task na karcie projektu). Okno ma trzy zakładki — Task (sam formularz), AI Models i Translate — oraz przycisk Save. Po zapisaniu Task pojawia się jako karta w kolejce ze statusem pending i startuje automatycznie, gdy tylko zwolni się slot. Task zapisuje także skrót Ctrl+Enter.

Okno New Task, zakładka Task
Okno New Task — zakładka Task z tytułem, promptem, trybem wykonania, priorytetem, intencją i przełącznikami.

Zakładka Task

  • Title — krótka nazwa Taska. Wymagana. To ona widnieje na listach i w powiadomieniach, więc powinna być konkretna.
  • Prompt — co AI ma zrobić. Wymagany. Należy opisać cel, ograniczenia oraz to, jak wygląda stan „gotowe". Nad polem znajdują się przycisk Optimize oraz selektor języka pisania (domyślnie Auto) z plakietką pokazującą używany język.
  • Solution i Project — zakładka (solution) oraz projekt, do którego należy zmiana. Oba pola są wymagane dla nowego Taska.
  • Execution Mode — Pipeline (pełny Pipeline krok po kroku) lub Agent (jeden autonomiczny Agent). W trybie Agent pojawia się Agent Test Gate z dwoma polami wyboru: Run unit tests i Run E2E tests.
  • Skill — obok przełącznika trybu są dwa małe przyciski automatycznego lub ręcznego użycia Skill; w trybie automatycznym Skills dobierane są na podstawie tekstu promptu. Lista Skill (optional) pozwala wybrać jeden Skill, który jest zawsze dołączany.
  • Priority — Low, Medium (domyślnie) lub High. Taski o wyższym priorytecie są pobierane z kolejki w pierwszej kolejności.
  • Intent — Bug, Feature, Enhancement lub Other. Wymagane; Save odrzuca formularz bez tego pola.
  • Use Worktree, Use Pipeline, Auto-merge → dev — najlepiej zostawić włączone, chyba że istnieje powód, by tego nie robić. Worktree izoluje Task od innych prac w toku; Auto-merge automatycznie scala gotowy branch z dev.
  • Lite mode — pomija krok planowania Architect, gdy model kodujący jest wystarczająco silny, aby zaplanować pracę samodzielnie; przy słabszych modelach i tak używany jest pełny Pipeline.
  • Pipeline Steps — przełączniki dla pojedynczego Taska: Architect, Review + Fix, Unit Tests i E2E Tests. Docs jest zablokowany jako włączony i nie można go pominąć.
  • Dependencies — inne Taski, które muszą zakończyć się przed startem tego Taska.

Zakładka AI Models

Tu można nadpisać providera i model dla każdego kroku AI (architect, code, compliance-check, review, fix, test, e2e, docs) tylko dla tego jednego Taska, wraz z limitami tur i czasu działania. Compliance-check pomija prostsze Taski. Wszystko, co pozostanie puste, jest dziedziczone z ustawień projektu lub globalnych. Przycisk Apply provider to all steps wypełnia całą kolumnę naraz.

Okno New Task, zakładka AI Models
Zakładka AI Models — provider, model i limity dla każdego kroku, tylko dla tego jednego Taska.

Zakładka Translate

Pokazuje tłumaczenie promptu, które można edytować.

Optimize — ulepszanie promptu

Optimize prosi AI o przepisanie roboczego promptu na precyzyjny. Potem można przełączać się między Original prompt a Optimized prompt, otworzyć Changes, aby zobaczyć, co zmieniono, a oryginał pozostaje widoczny pod formularzem jako Original prompt (before optimization). Okno szczegółów Taska pokazuje później obie wersje, oryginał nad zoptymalizowaną.

Szczegóły Taska z oryginalnym i zoptymalizowanym promptem
Szczegóły Taska: oryginalny prompt nad zoptymalizowanym.

Edycja Taska

Ikona Edit (ołówek) na karcie Taska — dostępna, dopóki Task nie jest uruchomiony — otwiera to samo okno, zatytułowane Edit Task, wypełnione bieżącymi wartościami Taska. Wystarczy zmienić potrzebne pola i kliknąć Save.

Edycja istniejącego Taska
Okno Edit Task wypełnione wartościami istniejącego Taska.

Łańcuchy zależnych Tasków

Jeśli praca jednego Taska musi nastąpić, zanim zacznie się inny (na przykład „dodaj kolumnę w bazie danych" przed „użyj kolumny w API"), pierwszy Task należy wskazać w polu Dependencies. Zależny Task czeka, aż jego poprzednik zostanie scalony z dev, i dopiero wtedy startuje, dzięki czemu zawsze zaczyna od bazy kodu, która zawiera już wcześniejszą zmianę.

Skróty podczas pisania (IntelliSense)

Pole promptu (oraz pola wiadomości w Chat i Brainstorm) oferuje autouzupełnianie po wpisaniu jednego z tych znaków:

WpisaćAby wstawić
@keywordsłowo kluczowe
@@keywordsłowo kluczowe wraz z pełną treścią
#taskodwołanie do innego Taska
##bugodwołanie do błędu
$skillSkill
_variablekod zmiennej — dokładna nazwa części aplikacji
~hintwpis z Hint Dictionary

Po rozpoczęciu wpisywania znaku wyzwalającego pojawia się lista z pasującymi podpowiedziami — wybranie jednej wstawia ją do promptu.

Lista rozwijana IntelliSense
Lista IntelliSense podpowiadająca dopasowania podczas wpisywania znaku wyzwalającego.
Widok pełnostronicowy IntelliSense
Pełnostronicowy widok podpowiedzi IntelliSense otwartych w edytorze promptu.
Przycisk wstawiania zmiennej w oknie New Task
Przycisk Var w oknie New Task, służący do wstawiania odwołania do zmiennej bez pisania.

Wskazówki

  • Zamiast opisywać lokalizacje w kodzie słowami, lepiej używać odwołań _variable — jest to szybsze i jednoznaczne dla AI.
  • Gdy zmiana naturalnie dzieli się na uporządkowane kroki, lepiej rozbić ją na zależne Taski niż pisać jeden gigantyczny prompt.
  • Nie wolno zapomnieć o polu Intent — bez niego Task się nie zapisze.
  • Task w stanie failed zachowuje pełne wyjście konsoli i przyczynę niepowodzenia; warto je przeczytać, dopracować prompt i spróbować ponownie.