Przejdź do treści

Skills

do-not-ship-an-empty-surface

Pusty ekran, zakładka czy kategoria to obietnica, której produkt nie dotrzymuje. Ukryj ją, dopóki nie ma treści, albo jeszcze jej nie buduj.

AntywzorzecPochodzenie: cleanStatus: activev0.1.0 · Apache-2.0

Nadane przez osobę, która przeczytała kartę, a nie deklarowane przez sam plik. Karta, którą agent destyluje podczas przebiegu z niezaufaną treścią, rodzi się skażona i czeka na recenzję, zanim kiedykolwiek zostanie pobrana.

Kiedy przychodzi na myśl

  • dodawanie zakładki bez danych
  • w kategorii nie ma wpisów
  • ekran zastępczy
  • już wkrótce

Wartość zwykle kryje się w Unikaj i Sprawdź. Rób to sekcja, którą pisze każdy.

Treść karty powyżej to tłumaczenie. Angielski oryginał jest tym, co importuje CLI, co agent czyta w czasie działania i czego dotyczy hasz poniżej.

Wyzwalacz

Masz zamiar wypuścić miejsce docelowe w nawigacji, które dla większości użytkowników będzie puste: zakładkę bez wierszy, kategorię bez wpisów, dashboard, którego źródło danych nie jest podłączone, stronę z napisem "wkrótce".

Nie dotyczy to powierzchni pustej dlatego, że użytkownik jeszcze niczego nie zrobił. Lista zadań bez zadań jest poprawna i powinna mówić, jak dodać jedno.

Rób

  1. Zdecyduj, jaki to rodzaj pustki. Pustka-bo-użytkownik-jest-nowy potrzebuje dobrego stanu pustego z kolejną akcją w środku. Pustka-bo-jeszcze-tego-nie-zbudowaliśmy powinna po prostu nie istnieć.
  2. Dla drugiego rodzaju: w ogóle nie renderuj miejsca docelowego. Generuj trasę tylko wtedy, gdy jest za nią coś realnego.
  3. Jeśli musi istnieć na potrzeby dewelopmentu, zabezpiecz ją flagą deweloperską, żeby zainstalowana wersja nie mogła się do niej dostać.
  4. Tam, gdzie pustka jest właśnie tym, co warto powiedzieć — hub z jednym wpisem, dopiero rozpoczęty feed — powiedz to słowami i uczyń zaproszenie do wniesienia wkładu główną treścią strony.

Unikaj

"Wkrótce", "Brak danych" bez wyjaśnienia i wpis w nawigacji prowadzący do pustej kolumny. Każdy z nich kosztuje czytelnika kliknięcie i nic nie zwraca, a po dwóch takich przestaje ufać nawigacji — koszt płacony przez każdą inną stronę produktu.

Unikaj też wersji, która wygląda dobrze: strony kategorii, która renderuje się poprawnie z zerem elementów. Nie wygląda na zepsutą, więc nikt jej nie zgłasza, a po cichu mówi, że projekt porzucił ten temat.

Sprawdź

Załaduj powierzchnię z pustym źródłem danych i przeczytaj, co zobaczyłby użytkownik pierwszy raz. Jeśli odpowiedzią jest nagłówek i pusta przestrzeń, to nie powinno było zostać wypuszczone.

Dla tras generowanych sprawdzenie jest mechaniczne: sprawdź, że lista tras jest wyprowadzana z treści, więc kategoria bez wpisów nie produkuje żadnej strony.

Ryzyko

Ukrywanie miejsca docelowego, dopóki nie ma treści, sprawia, że nawigacja zmienia się wraz z napływem danych, co może dezorientować — menu, które rośnie między odwiedzinami, potrzebuje powodu, który użytkownik może wywnioskować.

Można to też przesadzić, aż do ukrywania funkcji, które są po prostu niepopularne. Granica przebiega tam, czy powierzchnia kiedykolwiek może coś pokazać: niezbudowane jest ukryte, nieużywane pokazuje się z dobrym stanem pustym.

Jak użyć

Karta to dane. Sklonuj repozytorium i zaimportuj ją ścieżką — to, co przychodzi przez sieć, jest traktowane jako skażone i wstrzymywane do zatwierdzenia. Taki jest pożądany sposób działania i dlatego nie ma tu instalatora w jednej linijce.

git clone https://github.com/brcampidelli/chimera-agent.git
chimera skills-import chimera-agent/skills/do-not-ship-an-empty-surface/SKILL.md

Integralność

SHA-256 pliku w postaci opublikowanej. Importujący może sprawdzić, że otrzymał dokładnie to, co pokazała ta strona.

c4dbc6291edf3d41c3820bea6ed19cd283dd90e75d41d61dad97bdab972b7965

Przeczytaj kartę w repozytorium