diff --git a/.agents/skills/controlled-czech/SKILL.md b/.agents/skills/controlled-czech/SKILL.md index 2da1918..623d159 100644 --- a/.agents/skills/controlled-czech/SKILL.md +++ b/.agents/skills/controlled-czech/SKILL.md @@ -1,6 +1,6 @@ --- name: controlled-czech -description: Použij při psaní, úpravě nebo revizi českých technických textů: dokumentace, specifikace, koncepty, ADR, issue, PR popisy, runbooky, produktové požadavky a informačně husté AI výstupy. Nepoužívej pro marketing, beletrii, osobní komunikaci ani brand voice. +description: "Pravidla Controlled Czech pro srozumitelnou a informačně hustou technickou češtinu. Použij při psaní, úpravě nebo revizi českých technických textů: dokumentace, specifikace, koncepty, ADR, issue, PR popisy, runbooky, produktové požadavky a informačně husté AI výstupy. Nepoužívej pro marketing, beletrii, osobní komunikaci ani brand voice." --- # Controlled Czech @@ -18,4 +18,11 @@ Cíl: maximum informace při minimálním čtecím úsilí. 9. Rozlišuj fakt, požadavek, rozhodnutí, důvod, předpoklad, omezení, otevřenou otázku a příklad. 10. Požadavky formuluj pomocí `musí`, `nesmí`, `měl by`, `neměl by` a `může`. -Pokud je v projektu dostupný Controlled Czech `SPEC.md`, je kanonický. Při nejasnosti načti jen příslušné pravidlo `CCxxx`, ne celou specifikaci. +Kanonická specifikace s pravidly `CCxxx`: + +1. `SPEC.md` v kořenu projektu, pokud existuje, +2. jinak . + +Při nejasnosti načti jen příslušné pravidlo `CCxxx`, ne celou specifikaci. + +Pokud je v projektu dostupný linter `controlled-czech`, spusť nad výsledným dokumentem `controlled-czech check `. V repozitáři Controlled Czech použij `go run ./cmd/controlled-czech check `. diff --git a/.claude/skills/controlled-czech b/.claude/skills/controlled-czech new file mode 120000 index 0000000..89809bf --- /dev/null +++ b/.claude/skills/controlled-czech @@ -0,0 +1 @@ +../../.agents/skills/controlled-czech \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 331feb1..4119538 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,14 @@ # Changelog +## 0.1.1 — Draft + +- oprava YAML frontmatteru skillu; neuvozený `description` s dvojtečkou nešel načíst striktním YAML parserem, +- popis skillu nově uvádí účel skillu, ne jen situace použití, +- skill odkazuje na kanonický `SPEC.md` také přes URL pro projekty bez lokální kopie specifikace, +- skill doporučuje spustit linter nad výsledným dokumentem, +- podpora Claude Code: `CLAUDE.md` importuje `AGENTS.md` a skill je dostupný přes `.claude/skills/controlled-czech`, +- postup integrace pro Claude Code v `README.md` a `integrace/AGENTS.md`. + ## 0.1.0 — Draft - první návrh specifikace Controlled Czech, diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 0000000..43c994c --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1 @@ +@AGENTS.md diff --git a/README.md b/README.md index b0adaff..146bf3e 100644 --- a/README.md +++ b/README.md @@ -84,7 +84,13 @@ Doporučená integrace je **skill**, ne kopie celé specifikace do `AGENTS.md`. Repo obsahuje hotový skill v [`.agents/skills/controlled-czech/SKILL.md`](.agents/skills/controlled-czech/SKILL.md). -Pro Codex stačí zkopírovat adresář `.agents/skills/controlled-czech/` do projektu. Codex repo-local skills automaticky objeví. Do počátečního kontextu načte pouze název a popis skillu; celý `SKILL.md` načte až při použití. Viz [dokumentace Codex Skills](https://developers.openai.com/codex/skills/). +**Codex:** zkopírujte adresář `.agents/skills/controlled-czech/` do projektu. Codex repo-local skills automaticky objeví. Do počátečního kontextu načte pouze název a popis skillu; celý `SKILL.md` načte až při použití. Viz [dokumentace Codex Skills](https://developers.openai.com/codex/skills/). + +**Claude Code:** zkopírujte stejný adresář do projektového `.claude/skills/controlled-czech/`, nebo do uživatelského `~/.claude/skills/controlled-czech/`. Claude Code adresář `.agents/skills/` nenačítá. Viz [dokumentace Claude Code Skills](https://code.claude.com/docs/en/skills). + +Claude Code standardně nečte `AGENTS.md`. Pokud projekt používá `AGENTS.md`, vytvořte `CLAUDE.md` s řádkem `@AGENTS.md`. + +Tento repozitář udržuje skill v `.agents/skills/` a pro Claude Code jej zpřístupňuje symlinkem `.claude/skills/controlled-czech`. Pokud agent skills objevuje automaticky, pravidla není nutné duplikovat v `AGENTS.md`. Pro explicitní trigger stačí jedna věta: @@ -103,7 +109,7 @@ Preferuj informační hustotu před stylem. Jedna věta má vyjadřovat jednu hl Další hotové varianty jsou v [`integrace/`](integrace/). -Tento repozitář používá stejný princip pro vlastní práci AI agentů: kořenový [`AGENTS.md`](AGENTS.md) obsahuje jen trvalé projektové podmínky a odkaz na repo-local skill. +Tento repozitář používá stejný princip pro vlastní práci AI agentů: kořenový [`AGENTS.md`](AGENTS.md) obsahuje jen trvalé projektové podmínky a odkaz na repo-local skill. [`CLAUDE.md`](CLAUDE.md) stejné instrukce importuje pro Claude Code. ## Specifikace diff --git a/integrace/AGENTS.md b/integrace/AGENTS.md index bb1f97d..c941573 100644 --- a/integrace/AGENTS.md +++ b/integrace/AGENTS.md @@ -6,7 +6,12 @@ Do `AGENTS.md` nekopírujte celou specifikaci, pokud agent podporuje skills. Dlo Nainstalujte skill z [`.agents/skills/controlled-czech/`](../.agents/skills/controlled-czech/) do umístění, ze kterého váš agent načítá skills. -Pro Codex lze adresář vložit přímo do projektového `.agents/skills/`. Skill se může aktivovat podle svého popisu bez kopírování pravidel do `AGENTS.md`. +- **Codex** načítá projektové skills z `.agents/skills/`. +- **Claude Code** načítá projektové skills z `.claude/skills/` a uživatelské z `~/.claude/skills/`. Adresář `.agents/skills/` nenačítá. + +Skill se může aktivovat podle svého popisu bez kopírování pravidel do `AGENTS.md`. + +Claude Code standardně nečte `AGENTS.md`. Pokud projekt používá `AGENTS.md`, vytvořte `CLAUDE.md` s řádkem `@AGENTS.md`. Pokud chcete explicitní trigger, stačí: