Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions .agents/skills/controlled-czech/SKILL.md
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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 <https://github.com/sinfin/controlled-czech/blob/main/SPEC.md>.

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 <cesta>`. V repozitáři Controlled Czech použij `go run ./cmd/controlled-czech check <cesta>`.
1 change: 1 addition & 0 deletions .claude/skills/controlled-czech
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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,
Expand Down
1 change: 1 addition & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
@AGENTS.md
10 changes: 8 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:

Expand All @@ -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

Expand Down
7 changes: 6 additions & 1 deletion integrace/AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -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čí:

Expand Down