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

73 lines
3.1 KiB
Markdown

# 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/<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”):
```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.