ckb/.agents/modules/voice/README.pl.md
Michał Kopeć c57ddceffd Template 2.2.0: voice and convert modules
- 2.1.0 new opt-in `voice` module (D-0020): skill ckb-voice rewrites every
  prose file written under apply_to (outputs/answers, documents, reports,
  PROJECT-OVERVIEW) in a voice whose profile is a wiki page,
  wiki/voice/<name>.md (type voice-profile); settings in ckb.yaml (mode,
  profile, writer, apply_to, skip, chat); frozen spans never change, vague
  claims flagged not cut; `writer:` delegates to an external rewriting
  skill such as a personal ghost-writer. ckb-module writes a manifest's
  default_config into the entry's config:. Eval ckb-module/install-voice.
- 2.2.0 new opt-in `convert` module (D-0021): skill ckb-convert and
  convert.py turn Markdown into Word/ODT/PDF/HTML through pandoc with a
  house style in templates/styles/; unit tests and eval
  ckb-module/install-convert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 20:57:39 +01:00

3.1 KiB

Moduł voice

Przeczytaj w: English | 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/<nazwa>.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”):

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.