# Moduł `voice` *Przeczytaj w: [English](README.md) | **Polski*** Opcjonalny. Instalacja: „install the voice module”, usunięcie: „uninstall the voice module”. Dopóki nie jest zainstalowany, nic z tego folderu nie działa. ## Co robi Odpowiedzi, dokumenty i raporty, które baza pisze dla ludzi spoza niej, często brzmią jak tekst z modelu. Ten moduł przepisuje je **Waszym głosem**, zanim zostaną zapisane. Głos to strona wiki, `wiki/voice/.md`, więc zespół może go przeczytać, przejrzeć i poprawić jak każdą inną wiedzę. | Skill | Co robi | |---|---| | `ckb-voice` | Przepisuje wychodzący tekst według profilu głosu, buduje profil z przykładowych dokumentów, zapisuje uwagi w rodzaju „nigdy nie piszemy X”, gdy padną, i zmienia ustawienia. | Po instalacji nic się nie zmienia, dopóki nie powstanie pierwszy profil. Powiedz „calibrate our writing style” i podaj kilka dokumentów, które brzmią dobrze. Od tej chwili każdy nowy plik w `outputs/answers/`, `outputs/documents/`, `outputs/reports/` i przegląd projektu powstaje tym głosem. ## Co się zmienia, a co nie Głos zmienia **sformułowania**: typowe dla AI słownictwo, schematyczną budowę, asekuranckie zwroty, płaski rytm, a także ton, formalność i zwroty, które ustala profil. Nigdy nie zmienia **treści**. Frontmatter, `## Sources`, `## Crux` i każdy cytat, `## Notes`, znaczniki sprzeczności, kod, ścieżki, linki, liczby i nazwy wychodzą dokładnie takie, jakie weszły. Przepisanie, które zmieniłoby którekolwiek z nich, jest odrzucane. Ogólnikowe twierdzenie nie jest wycinane, tylko zgłaszane Tobie. Strony wiki nigdy nie są przepisywane; wiki zostaje zwykła. ## Ustawienia W `ckb.yaml`, we wpisie modułu. Zmieniasz je prośbą („set the voice mode to ask”, „make board the default voice”): ```yaml config: mode: auto # auto | ask (raz na plik) | off profile: house # domyślny głos, wiki/voice/house.md writer: ckb-voice # albo inny Twój skill do przepisywania, np. ghost-writer apply_to: [outputs/answers/, outputs/documents/, outputs/reports/, PROJECT-OVERVIEW] skip: [outputs/okf/, outputs/starlight/] chat: false # true = także odpowiedzi w czacie ``` Który głos: nazwany w prośbie („in the board voice”), inaczej `voice:` z Twojej strony w `workload/profiles/` („use my own voice by default”), inaczej `profile`. ## Własny skill do przepisywania Jeśli masz już skill, który lubisz, np. osobisty `ghost-writer` w `~/.claude/skills/`, ustaw `writer: ghost-writer`. Moduł nadal bierze profil z wiki i nadal pilnuje zamrożonych części; przepisuje Twój skill. Jeśli na komputerze kogoś z zespołu tego skilla nie ma, jego sesje wracają do `ckb-voice`. ## Bezpieczeństwo - **Profile są commitowane.** Widzi je każdy, kto sklonuje bazę. Jako próbki dawaj tylko tekst, którym podzielił(a)byś się z zespołem. - **Głosy osób trzecich** („pisz jak Feynman”) powstają z opublikowanych tekstów, a jako próbka zostaje najwyżej kilka linijek. - **Odinstalowanie zostawia profile.** `wiki/voice/` zostaje jako wiedza; ustaje tylko automatyczne przepisywanie.