Sales: CRM lokalny

Co robi ten skill

Lokalny CRM handlowca — master danych o klientach w plikach na dysku. Prowadzi Klienci/_klienci.csv (jeden wiersz na klienta) i folder per klient z details.md.

Jak to działa

Jeden wiersz CSV, jeden folder. Możesz uruchomić skill dwa razy z tymi samymi danymi — duplikat nie powstanie. Zapis CSV jest atomowy — plik nigdy nie zostaje w uszkodzonym stanie.

Bez statusów pipeline’u, bez pól szans sprzedaży. To lista kontaktów i struktura folderów — fundament, z którego czytają pozostałe skille sprzedaży.

Co zyskujesz

• Lokalne, offline-first źródło prawdy o każdym kliencie — bez zewnętrznych usług
• Strukturę folderów, po której poruszają się wszystkie pozostałe skille sprzedaży
• Czyste dane bez duplikatów, nawet jeśli dodasz tego samego klienta dwa razy

Inne skille korzystają z tych danych

sales-meeting-recap, sales-pre-meeting-brief, sales-followup-email i sales-offer czytają foldery i CSV, które ten skill tworzy.

Skill file

---
name: sales-client-crm-local
description: 'ZAWSZE używaj tego skilla, gdy user dodaje, aktualizuje albo poprawia dane klienta/organizacji — nawet jeśli nie pada explicite słowo "CRM". Triggery: "dodaj klienta", "nowy klient", "stwórz folder klienta", "zaktualizuj klienta", "/sales-client-crm-local". Skill jest lokalnym, master źródłem prawdy o klientach: prowadzi lekki indeks `Klienci/_klienci.csv` (jeden wiersz na klienta — numer + dane kontaktowe) oraz folder `Klienci/<numer>-<slug>/` per klient z lustrzanym `details.md`. Offline-first; idempotentny (update zamiast duplikacji); atomowe zapisy CSV.'
argument-hint: "<nazwa firmy lub imię nazwisko>"
---

# Sales Client CRM (local) — lokalny master danych o kliencie

Jesteś lokalnym CRM-em handlowca. Trzymasz w jednym miejscu dane każdego klienta: lekki indeks `{CRM}` (numer + dane kontaktowe) oraz folder per klient z lustrzanym `details.md`.

## Konfiguracja

- `{KLIENCI}` — folder z klientami (domyślnie `Klienci/`)
- `{CRM}` — indeks klientów (domyślnie `{KLIENCI}/_klienci.csv`)

## Model danych

`{CRM}` — jeden wiersz na klienta:
```
id, nazwa_firmy, imie_nazwisko, mail, telefon, nip, ostatnia_aktywnosc, utworzono, notatka
```

- `id` — zero-padded 4 cyfry (`0001`, `0002`…). Niezmienny.
- Numer `0000` zarezerwowany na Twoją własną firmę.

## Workflow

**Krok 1:** Znajdź workspace, rozpoznaj akcję (CREATE vs UPDATE) i dane klienta.

**Krok 2:** Wylicz slug (ASCII kebab-case z firma+osoba) i sprawdź idempotentnie, czy klient istnieje.

**Krok 3 CREATE:** Nadaj kolejny wolny numer → dopisz wiersz do `{CRM}` atomowo → utwórz folder z `details.md` i `Activity.md`.

**Krok 3 UPDATE:** Zmień wiersz w `{CRM}` i odśwież `details.md`.

## Czego NIE robić

- Nie dodawaj statusów pipeline'u sprzedaży
- Nie duplikuj klientów
- Nie pisz do CSV nieatomicznie
- Nie rozjeżdżaj `details.md` z CSV

Kiedy używać

• “dodaj klienta” / “nowy klient”
• “zaktualizuj dane Kowalskiego”
• /sales-client-crm-local

Jak zainstalować

1. Pobierz folder skilla przyciskiem Pobierz powyżej lub z GitHub
2. W Voicie Desktop: przejdź do zakładki Local → znajdź sekcję Skills → kliknij ikonę folderu, żeby otworzyć go w Finderze
3. Przenieś pobrany folder skilla do tego katalogu
4. Otwórz nowy czat — skill jest teraz dostępny
5. Wywołaj naturalnym językiem lub komendą /<nazwa-skilla>

→ Pełny przewodnik: Jak zainstalować skille w Voicie