- 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>
73 lines
3.1 KiB
Markdown
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.
|