Poproś asystenta AI o napisanie klienta WebSocket w Delphi, a otrzymasz kod pewny siebie, dobrze zorganizowany i subtelnie błędny. Właściwość, która nie istnieje. Komponent umieszczony w niewłaściwym module. API usunięte trzy wydania temu. Potem spędzasz dwadzieścia minut, ustalając, która z czterech wiarygodnie wyglądających linii jest tą, która się nie kompiluje.
Powód jest prosty. Te modele uczyły się na publicznym kodzie, a komponenty eSeGeCe są komercyjne, więc model nigdy ich nie czytał. Zna ogólny kształt biblioteki komponentów Delphi, a resztę uzupełnia z pamięci o innych bibliotekach.
Opublikowaliśmy umiejętności agentów, aby zlikwidować tę lukę. Są bezpłatne, na licencji MIT, a do ich instalacji nie potrzebujesz licencji.
Czym jest umiejętność agenta
Umiejętność to folder z plikami Markdown, który agent ładuje na żądanie. Nasze zawierają publiczne API każdej biblioteki: każdy komponent, jego właściwości, zdarzenia i metody, moduł lub przestrzeń nazw, w której się znajduje, edycję, która go zawiera, oraz prawdziwe przykłady zaczerpnięte z dem dołączonych do produktu. Są generowane ze źródeł biblioteki przy każdym wydaniu, więc opisują wersję, którą naprawdę masz, a nie tę, którą model pamięta jedynie w połowie.
Wszystko znajduje się w jednym repozytorium, github.com/esegece-com/agent-skills, spakowane jako sześć wtyczek.
Instalacja
W Claude Code i GitHub Copilot CLI dodaj raz marketplace, a następnie zainstaluj wybrane wtyczki:
/plugin marketplace add esegece-com/agent-skills
/plugin install sgcwebsockets-delphi@esegeceW Codex CLI:
codex plugin marketplace add esegece-com/agent-skills
codex plugin add sgcwebsockets-delphi@esegeceW VS Code otwórz paletę poleceń i uruchom "Chat: Install Plugin From Source". W przypadku Cursor i każdego innego agenta, który odczytuje folder z umiejętnościami, skopiuj folder umiejętności z repozytorium do .cursor/skills/, .claude/skills/, .github/skills/, .agents/skills/ lub .junie/skills/, zależnie od agenta.
Sześć wtyczek to sgcwebsockets-delphi, sgcwebsockets-dotnet, sgcsign-delphi, sgcopenapi-delphi, sgcindy-delphi i sgcbiometrics-delphi.
Dlaczego sgcWebSockets to 18 umiejętności, a nie jedna
sgcWebSockets rejestruje 222 komponenty. Jedna umiejętność obejmująca je wszystkie byłaby zbyt duża, aby była użyteczna: agent ładowałby całą bibliotekę, żeby odpowiedzieć na pytanie o MQTT. Dlatego została podzielona według obszarów, 18 umiejętności obejmuje rdzeń WebSocket, brokery wiadomości, podprotokoły sgc, kanały danych giełdowych, AI i LLM, integracje z usługami, HTTP i transporty, uwierzytelnianie, P2P i WebRTC, IoT oraz sześć kolejnych dla widgetów sgcHTML.
Agent poproszony o połączenie z brokerem MQTT ładuje umiejętność dotyczącą brokerów wiadomości i nic więcej. Wtyczka .NET stosuje to samo podejście z 7 umiejętnościami.
Co znajduje się w środku
Każda umiejętność zaczyna się od napisanego ręcznie przewodnika: do czego służy, jakiej klauzuli uses lub dyrektywy using potrzebujesz, jakie pytania warto zadać programiście przed napisaniem kodu oraz jakie błędy naprawdę sprawiają ludziom kłopot. Dalej następuje materiał generowany, pełna dokumentacja API z sygnaturą Delphi i C++Builder dla każdej składowej, C# w przypadku wtyczki .NET, strony typów opcji i typów wyliczeniowych, aby agent używał stałych, które istnieją, przykłady wydestylowane z dołączonych dem oraz edycja wymagana przez każdy komponent.
Ten ostatni punkt oszczędza szczególny rodzaj zmarnowanego popołudnia. "Nie mam tego komponentu na palecie" to zwykle kwestia edycji, a nie instalacji, a umiejętność odpowiada na to pytanie, zanim je zadasz.
Szczerze o .NET
Dostarczany zestaw .NET udostępnia 70 z 222 komponentów rejestrowanych przez bibliotekę Delphi. Zamiast pozwalać agentowi zgadywać, wtyczka .NET zawiera generowaną stronę pokrycia, która wymienia 152 komponenty dostępne wyłącznie w Delphi, wraz z modułem, w którym każdy z nich się znajduje. Agent, który w przeciwnym razie wymyśliłby wiarygodnie wyglądające API C#, ma teraz gdzie zajrzeć, a szczera odpowiedź na pytanie "czy mogę to zrobić w C#" jest oddalona o jedną stronę.
Prywatność
Umiejętność to dokumentacja. Nic się nie wykonuje, nic nigdzie nie jest wysyłane i nie są zbierane żadne dane telemetryczne. Umiejętności zawierają wyłącznie publiczne i opublikowane API, więc ciała metod, pola prywatne i składowe chronione są celowo pominięte. Ich instalacja nie umieszcza źródeł biblioteki ani na Twoim dysku, ani na niczyim innym.
Utrzymywanie ich w aktualności
Umiejętności są generowane na nowo ze źródeł biblioteki przy każdym wydaniu, więc podążają za produktem, zamiast zostawać w tyle. Uruchom ponownie polecenie instalacji, aby pobrać nową wersję. Jeśli API w Twoim kodzie nie zgadza się z tym, co opisuje agent, sprawdź plik reference/history.md wewnątrz umiejętności, ponieważ zwykłe wyjaśnienie jest takie, że pracujecie na różnych kompilacjach.
Pełne szczegóły i ścieżki instalacji ręcznej znajdziesz na stronie umiejętności agentów AI.
Jeśli agent nadal się myli mimo zainstalowanych umiejętności, to błąd w dokumentacji i chcemy o nim usłyszeć. Zgłoś problem na GitHub lub skontaktuj się z nami — odpowiedź otrzymasz od osób, które napisały ten kod.