Umiejętność agenta Automatyczne publikowanie postów na X (Twitter)

Publikuj na X (Twitter)

Publikuje tekst, obrazy, filmy i długie artykuły na X za pomocą prawdziwej przeglądarki Chrome.

W Codex nie mieszaj tych ścieżek przeglądarki:

• Wtyczka Chrome Codex / @chrome / Rozszerzenie Chrome: użyj dołączonej umiejętności chrome:Chrome i jej klienta przeglądarki Node REPL. Jest to wymagane, gdy użytkownik mówi "Wtyczka Chrome Codex", "Codex 自带的 Chrome 插件", @chrome lub podobnie.
• Chrome Computer Use: używaj mcp__computer_use__.* przeciwko widocznemu interfejsowi Google Chrome tylko wtedy, gdy użytkownik prosi o Computer Use lub nie określił preferencji co do wtyczki Chrome, a Computer Use jest dostępne.
• Tryb skryptu CDP: używaj tylko jako awaryjnego, gdy wybrany tryb jest niedostępny lub użytkownik wyraźnie prosi o tryb CDP/skryptowy.

Katalog skryptów

Ważne: Wszystkie skrypty znajdują się w podkatalogu scripts/ tej umiejętności.

Instrukcje wykonania dla agenta:

1. Określ ścieżkę katalogu tego pliku SKILL.md jako {baseDir}
2. Ścieżka skryptu = {baseDir}/scripts/<nazwa-skryptu>.ts
3. Zamień wszystkie {baseDir} w tym dokumencie na rzeczywistą ścieżkę
4. Rozwiąż środowisko wykonawcze ${BUN_X}: jeśli bun jest zainstalowany → bun; jeśli npx jest dostępny → npx -y bun; w przeciwnym razie zasugeruj zainstalowanie bun

Lista skryptów:

Wybór trybu wykonania (wymagane)

Wybierz dokładnie jeden tryb przed interakcją z X:

1. Jeśli użytkownik wyraźnie prosi o wtyczkę Codex Chrome, @chrome, rozszerzenie Chrome lub "Codex 自带的 Chrome 插件", użyj trybu wtyczki Codex Chrome. Nie wywołuj najpierw Computer Use.
2. Jeśli użytkownik wyraźnie prosi o Chrome Computer Use, użyj trybu Chrome Computer Use. Nie przełączaj się awaryjnie na CDP, Playwright, wbudowaną przeglądarkę ani wtyczkę Chrome bez powiadomienia użytkownika i uzyskania zgody.
3. Jeśli użytkownik wyraźnie prosi o tryb CDP/skryptowy, użyj trybu skryptu CDP.
4. W przeciwnym razie preferuj tryb Chrome Computer Use. Dla artykułów X z obrazami z lokalnej zawartości w Markdown, użyj przetestowanego przepływu edytora X: wstaw każdy obraz treści z paska narzędzi (Wstaw -> Media -> przycisk ikony okna dialogowego Dodaj zdjęcia lub wideo) w miejscu jego zastępczego tekstu, a następnie usuń zastępczy tekst. Użyj trybu skryptu CDP tylko wtedy, gdy wybrany tryb kontroli przeglądarki jest niedostępny lub przepływ przesyłania/wyboru UI jest zawodny.

Nigdy nie używaj wbudowanej przeglądarki w aplikacji do przepływów pracy publikowania na X.

Tryb wtyczki Codex Chrome

Używaj tego trybu, gdy użytkownik prosi o wtyczkę Codex Chrome, @chrome lub ścieżkę rozszerzenia Chrome. Wykorzystuje to rzeczywisty profil Chrome użytkownika i logowanie do X za pośrednictwem dołączonej wtyczki Chrome, a nie Computer Use ani CDP.

Konfiguracja

1. Wczytaj umiejętność chrome:Chrome przed pracą z przeglądarką.
2. Użyj tool_search dla node_repl js, jeśli narzędzie Node REPL js nie jest jeszcze widoczne.
3. Zainicjuj klienta przeglądarki Chrome dokładnie tak, jak określa umiejętność Chrome, a następnie wykonaj lekkie wywołanie, takie jak browser.user.openTabs(), aby zweryfikować połączenie z rozszerzeniem.
4. Jeśli pierwsze lekkie wywołanie zawiedzie, odczekaj 2 sekundy i spróbuj ponownie raz. Jeśli nadal zawodzi, postępuj zgodnie z krokami sprawdzania rozszerzenia i odzyskiwania z umiejętności Chrome. Jeśli kontrole przejdą pomyślnie, ale komunikacja nadal zawodzi, zapytaj użytkownika przed otwarciem nowego okna Chrome. Nie przełączaj się po cichu na Computer Use lub CDP.

Zasady ogólne

• Używaj interfejsów API browser.tabs.*, tab.playwright.*, tab.cua.* i wyboru plików wtyczki Chrome do działań w interfejsie X.
• Polecenia powłoki są dozwolone do wstępnego przetwarzania Markdown i przygotowania schowka z bogatym HTML. W przypadku obrazów w treści artykułu X nie polegaj na wklejaniu obrazów ze schowka; skorzystaj z przepływu przesyłania w edytorze Wstaw -> Media.
• Jeśli przesyłanie pliku kończy się niepowodzeniem z komunikatem Nie dozwolone, powiedz użytkownikowi: Aby włączyć przesyłanie plików, przejdź do chrome://extensions w Chrome, kliknij Szczegóły pod rozszerzeniem Codex i włącz "Zezwalaj na dostęp do adresów URL plików". Szczegóły znajdziesz na https://developers.openai.com/codex/app/chrome-extension#upload-files.
• Jeśli wtyczka Chrome zgłosi zamknięcie natywnego potoku, spróbuj ponownie lekkiego wywołania przeglądarki po 2 sekundach, a następnie uruchom kontrole stanu umiejętności Chrome. Jeśli Chrome działa, rozszerzenie jest włączone, a manifest hosta natywnego jest poprawny, poproś o zgodę na otwarcie nowego okna Chrome i spróbuj ponownie. Nie wysyłaj kolejnych akcji przeglądarki przez uszkodzony potok.
• Nigdy nie klikaj Opublikuj, Wyślij ani żadnej widocznej zewnętrznie akcji wysyłania bez wyraźnego ostatecznego potwierdzenia od użytkownika w bieżącej rozmowie.

Artykuły X

1. Konwertuj Markdown i zachowaj mapę obrazów:

   ${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json
   

2. Odczytaj dane wyjściowe JSON dla title, coverImage i contentImages (placeholder → localPath).
3. Otwórz lub utwórz wersję roboczą artykułu na https://x.com/compose/articles.
4. Prześlij okładkę za pomocą przepływu wyboru plików wtyczki Chrome. Jeśli przesyłanie jest zablokowane przez uprawnienia rozszerzenia, zatrzymaj się i zgłoś dokładną poprawkę uprawnień powyżej.
5. Wypełnij tytuł, a następnie skopiuj bogaty HTML:

   ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html
   

6. Wklej do treści artykułu za pomocą rzeczywistego naciśnięcia klawisza wklejania przez wtyczkę Chrome. W systemie macOS użyj Meta+V.
7. Sprawdź, czy tekst edytora zawiera treść artykułu i symbole zastępcze XIMGPH_. Nie polegaj na tab.clipboard.readText() jako dowodzie zawartości schowka systemowego po zapisach schowka w powłoce; w systemie macOS zweryfikuj przez pbpaste, jeśli to konieczne.
8. Dla każdego elementu contentImages w kolejności symboli zastępczych:
   • Znajdź widoczny tekst zastępczy (XIMGPH_N) i kliknij go, aby ustawić tam kursor.
   • Otwórz menu paska narzędzi Wstaw -> Media.
   • W oknie modalnym kliknij przycisk ikony z aria-label="Dodaj zdjęcia lub wideo"; nie klikaj tekstu/strefy upuszczania ani ukrytego pola wprowadzania pliku.
   • Użyj selektora plików, aby przesłać localPath tego obrazu.
   • Po wyświetleniu obrazu, jeśli XIMGPH_N pozostaje nad nim, zaznacz dokładnie ten symbol zastępczy i naciśnij najpierw Delete. Użyj Backspace tylko wtedy, gdy Delete zawiedzie, a zaznaczony tekst zostanie potwierdzony jako dokładnie ten symbol zastępczy.
   • Sprawdź, czy liczba wystąpień symbolu zastępczego dla tego XIMGPH_N wynosi 0.
9. Otwórz Podgląd i sprawdź tytuł, okładkę, treść, linki i obrazy.
10. Poproś o wyraźne potwierdzenie przed kliknięciem Opublikuj.

Preferencje (EXTEND.md)

Sprawdź EXTEND.md w kolejności priorytetu — pierwszy znaleziony wygrywa:

Jeśli nie znaleziono, użyj domyślnych.

EXTEND.md obsługuje: Domyślny profil Chrome

Wymagania wstępne

• Google Chrome lub Chromium
• środowisko wykonawcze bun
• Pierwsze uruchomienie: zaloguj się ręcznie do X (sesja zostanie zapisana)

Kontrola przed uruchomieniem (opcjonalnie)

Przed pierwszym użyciem zasugeruj uruchomienie kontroli środowiska. Użytkownik może ją pominąć, jeśli woli.

${BUN_X} {baseDir}/scripts/check-paste-permissions.ts

Kontrole: Chrome, izolacja profilu, Bun, dostępność, schowek, naciśnięcie klawisza wklejania, konflikty Chrome.

Jeśli którakolwiek kontrola nie powiedzie się, podaj wytyczne dotyczące naprawy dla każdego elementu:

Linki

• Zwykłe posty: Zobacz references/regular-posts.md w celu ręcznego przepływu pracy, rozwiązywania problemów i szczegółów technicznych
• Artykuły X: Zobacz references/articles.md w celu przewodnika po publikowaniu długich artykułów

Tryb Chrome Computer Use

Używaj tego trybu, gdy użytkownik wyraźnie prosi o Chrome Computer Use lub gdy nie określono preferencji dotyczącej wtyczki Chrome, a Codex może sterować Google Chrome za pomocą Computer Use. Wykorzystuje to istniejące okno Chrome użytkownika, pliki cookie, logowanie, rozszerzenia i sesję X.

Zasady ogólne:

• Rozpocznij każdą turę asystenta, która steruje Chrome, od wywołania get_app_state dla Google Chrome.
• Preferuj akcje na indeksach elementów, jeśli są dostępne; używaj współrzędnych tylko do zaznaczania tekstu w edytorze lub przeciągania.
• Nie używaj wbudowanej przeglądarki, wtyczki Chrome, Playwright ani CDP do działań w interfejsie X w tym trybie, chyba że użytkownik zatwierdzi zmianę trybu.
• Nigdy nie klikaj Opublikuj, Wyślij ani żadnej widocznej zewnętrznie akcji wysyłania bez wyraźnego ostatecznego potwierdzenia od użytkownika w bieżącej rozmowie.

Zwykłe posty:

1. Otwórz lub przejdź w Chrome do https://x.com/compose/post.
2. Wpisz tekst posta do kompozytora za pomocą Computer Use.
3. Dla każdego obrazu uruchom:

   ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts image /bezwzględna/ścieżka/do/obrazu.png
   

4. Wklej za pomocą Computer Use (super+v w systemie macOS, control+v w systemach Windows/Linux), a następnie poczekaj, aż X zakończy przesyłanie multimediów.
5. Poproś o potwierdzenie przed kliknięciem Wyślij.

Posty wideo:

1. Otwórz lub przejdź w Chrome do https://x.com/compose/post.
2. Wpisz tekst posta do kompozytora.
3. Użyj widocznego interfejsu przesyłania multimediów/wyboru plików, aby dołączyć wideo.
4. Poczekaj na zakończenie przesyłania i przetwarzania.
5. Poproś o potwierdzenie przed kliknięciem Wyślij.

Cytowanie tweetów:

1. Otwórz adres URL tweeta w Chrome.
2. Użyj widocznego interfejsu cytowania/udostępniania, aby wybrać Cytowanie.
3. Wpisz komentarz.
4. Poproś o potwierdzenie przed kliknięciem Wyślij.

Artykuły X:

1. Konwertuj Markdown i zachowaj mapę obrazów:

   ${BUN_X} {baseDir}/scripts/md-to-html.ts article.md --save-html /tmp/x-article-body.html > /tmp/x-article.json
   

2. Odczytaj dane wyjściowe JSON dla title, coverImage i contentImages (placeholder → localPath).
3. W Chrome otwórz https://x.com/compose/articles, utwórz lub otwórz wersję roboczą, prześlij okładkę, jeśli jest dostępna, i wypełnij tytuł.
4. Skopiuj bogaty HTML do schowka:

   ${BUN_X} {baseDir}/scripts/copy-to-clipboard.ts html --file /tmp/x-article-body.html
   

5. Wklej do treści artykułu za pomocą Computer Use.
6. Dla każdego wpisu contentImages w kolejności symboli zastępczych:
   • Znajdź dokładny widoczny tekst zastępczy, taki jak XIMGPH_3, i kliknij go, aby ustawić punkt wstawienia.
   • Otwórz rozwijane menu Wstaw na pasku narzędzi, wybierz Media, a następnie kliknij przycisk ikony okna modalnego z etykietą Dodaj zdjęcia lub wideo.
   • Użyj natywnego selektora plików, aby wybrać localPath obrazu.
   • Poczekaj, aż pojawi się blok obrazu i zakończy się wszelka aktywność przesyłania.
   • Jeśli symbol zastępczy pozostaje nad wstawionym obrazem, ponownie zaznacz dokładnie ten tekst zastępczy i naciśnij najpierw Delete. Użyj Backspace tylko wtedy, gdy Delete zawiedzie, a zaznaczony tekst zostanie potwierdzony jako dokładnie ten symbol zastępczy.
7. Sprawdź, czy nie pozostały żadne symbole zastępcze XIMGPH_ i czy wyświetlają się oczekiwane obrazy.
8. Otwórz Podgląd i sprawdź tytuł, okładkę, treść, linki i obrazy.
9. Poproś o wyraźne potwierdzenie przed kliknięciem Opublikuj.

Jeśli zaznaczanie za pomocą Computer Use, przesyłanie z paska narzędzi lub sterowanie selektorem plików staje się zawodne, zatrzymaj się i zgłoś blokadę zamiast po cichu przełączać się na wtyczkę Chrome lub CDP.

Tryb skryptu CDP (awaryjny)

Używaj poniższych sekcji skryptów tylko wtedy, gdy wybrany tryb kontroli przeglądarki jest niedostępny, zawodny lub wyraźnie nie został żądany. Skrypty te uruchamiają lub ponownie wykorzystują rzeczywistą instancję Chrome poprzez CDP i pozostawiają przeglądarkę otwartą do przeglądu.

Nie używaj trybu skryptu CDP, gdy użytkownik wyraźnie wymaga wtyczki Codex Chrome lub Chrome Computer Use, chyba że użytkownik zatwierdzi przełączenie awaryjne po wyjaśnieniu blokady.

Wybór typu posta

O ile użytkownik nie określi wyraźnie typu posta:

• Zwykły tekst + do 10 000 znaków → Zwykły post (członkowie Premium obsługują do 10 000 znaków, bez Premium: 280)
• Plik Markdown (.md) → Artykuł X

Zwykłe posty

${BUN_X} {baseDir}/scripts/x-browser.ts "Cześć!" --image ./zdjęcie.png

Parametry:

Uwaga: Skrypt otwiera przeglądarkę z wypełnioną treścią. Użytkownik przegląda i publikuje ręcznie.

Uwaga dotycząca trybu Codex: Jeśli użytkownik wyraźnie zażądał wtyczki Codex Chrome, użyj trybu wtyczki Codex Chrome. W przeciwnym razie, jeśli Chrome Computer Use jest włączone, użyj trybu Chrome Computer Use zamiast uruchamiać x-browser.ts.

Posty wideo

Tekst + plik wideo.

${BUN_X} {baseDir}/scripts/x-video.ts "Spójrz na to!" --video ./klip.mp4

Parametry:

Uwaga: Skrypt otwiera przeglądarkę z wypełnioną treścią. Użytkownik przegląda i publikuje ręcznie.

Uwaga dotycząca trybu Codex: Jeśli użytkownik wyraźnie zażądał wtyczki Codex Chrome, użyj trybu wtyczki Codex Chrome. W przeciwnym razie, jeśli Chrome Computer Use jest włączone, użyj trybu Chrome Computer Use zamiast uruchamiać x-video.ts.

Limity: Zwykłe maks. 140 s, Premium 60 min. Przetwarzanie: 30-60 s.

Cytowanie tweetów

Cytuj istniejący tweet z komentarzem.

${BUN_X} {baseDir}/scripts/x-quote.ts https://x.com/user/status/123 "Świetna uwaga!"

Parametry:

Uwaga: Skrypt otwiera przeglądarkę z wypełnioną treścią. Użytkownik przegląda i publikuje ręcznie.

Uwaga dotycząca trybu Codex: Jeśli użytkownik wyraźnie zażądał wtyczki Codex Chrome, użyj trybu wtyczki Codex Chrome. W przeciwnym razie, jeśli Chrome Computer Use jest włączone, użyj trybu Chrome Computer Use zamiast uruchamiać x-quote.ts.

Artykuły X

Długie artykuły w Markdown (wymagają X Premium).

${BUN_X} {baseDir}/scripts/x-article.ts artykuł.md
${BUN_X} {baseDir}/scripts/x-article.ts artykuł.md --cover ./okładka.jpg

Parametry:

Frontmatter: title, cover_image obsługiwane w front matter YAML.

Uwaga dotycząca trybu Codex: Jeśli użytkownik wyraźnie zażądał wtyczki Codex Chrome, postępuj zgodnie z trybem wtyczki Codex Chrome powyżej. Jeśli użytkownik wyraźnie zażądał Chrome Computer Use, postępuj zgodnie z trybem Chrome Computer Use. W przeciwnym razie preferuj Chrome Computer Use; dla artykułów Markdown z lokalnymi obrazami treści użyj przepływu przesyłania obrazów z paska narzędzi Wstaw -> Media przed ewentualnym przejściem awaryjnym do x-article.ts w trybie skryptu CDP.

Uwaga dotycząca przełączania awaryjnego CDP: Skrypt otwiera przeglądarkę z wypełnionym artykułem. Użytkownik przegląda i publikuje ręcznie, chyba że użyto --submit.

Bezpieczeństwo publikowania: Nie używaj --submit ani nie klikaj Opublikuj, chyba że użytkownik wyraźnie potwierdzi ostateczną publiczną akcję publikowania.

Kontrola po złożeniu: Skrypt automatycznie weryfikuje po wstawieniu wszystkich obrazów:

• Pozostałe symbole zastępcze XIMGPH_ w treści edytora
• Oczekiwana vs rzeczywista liczba obrazów

Jeśli kontrola nie powiedzie się (ostrzeżenia w wynikach), poinformuj użytkownika o konkretnych problemach przed opublikowaniem.

Rozwiązywanie problemów

Port debugowania Chrome nie jest gotowy

Tylko przełączenie awaryjne CDP: jeśli skrypt kończy się niepowodzeniem z komunikatem Port debugowania Chrome nie jest gotowy lub Nie można się połączyć, najpierw zabij istniejące instancje CDP Chrome, a następnie spróbuj ponownie:

pkill -f "Chrome.*remote-debugging-port" 2>/dev/null; pkill -f "Chromium.*remote-debugging-port" 2>/dev/null; sleep 2

Ważne: Należy to zrobić automatycznie — w przypadku napotkania tego błędu zabij instancje CDP Chrome i ponów polecenie bez pytania użytkownika.

Uwagi

• Pierwsze uruchomienie: wymagane ręczne logowanie (sesja jest utrzymywana)
• W trybie wtyczki Codex Chrome i trybie Chrome Computer Use używaj istniejącej sesji Chrome użytkownika i nie uruchamiaj osobnego profilu CDP
• Skrypty CDP domyślnie tylko wypełniają treść w przeglądarce; użytkownik musi przejrzeć i opublikować ręcznie, chyba że jawnie użyto --submit
• Wieloplatformowe: macOS, Linux, Windows

Wsparcie rozszerzeń

Niestandardowe konfiguracje za pośrednictwem EXTEND.md. Zobacz sekcję Preferencje dla ścieżek i obsługiwanych opcji.