Cline Rules (.clinerules/): lokalizacja i sposób odczytu przez narzędzia

Reguły Cline to pliki Markdown w .clinerules/, które Cline łączy z regułami globalnymi i AGENTS.md. Opcjonalny frontmatter paths ogranicza regułę do pasujących plików.

Lokalizacja

• Obszar roboczy: .clinerules/*.md lub .cline/rules/*.md; przeszukiwane są obie lokalizacje.
• Globalnie: Documents\Cline\Rules w systemie Windows, ~/Documents/Cline/Rules w systemach macOS i Linux, a także ~/.cline/rules i ~/Cline/Rules.
• Automatycznie wykrywane pliki wspólne dla różnych narzędzi: AGENTS.md, ~/.agents/AGENTS.md, .cursorrules i .windsurfrules.

Format

Pliki Markdown, opcjonalnie z numerami w nazwach, np. 01-coding.md, i opcjonalnym nagłówkiem YAML. Tablica paths z wzorcami glob aktywuje regułę, gdy dowolny wzorzec pasuje do pliku znajdującego się w kontekście. Brak nagłówka oznacza, że reguła jest zawsze aktywna, paths: [] — że nigdy, a błędny YAML powoduje domyślną aktywację reguły.

Klucze frontmatter: paths

---
paths:
  - "src/components/**"
  - "src/hooks/**"
---

# Components and hooks

- Function components only.
- Hook names start with use and the files live in src/hooks/.
- Split any component that grows past 200 lines.
- Add a test next to each new hook.

Priorytety i scalanie

Reguły globalne i obszaru roboczego są łączone, a w razie konfliktu pierwszeństwo mają reguły obszaru roboczego. Każdą regułę można niezależnie włączyć lub wyłączyć.

Wskazówki

• Do kontekstu zaliczają się wymienione ścieżki, otwarte lub widoczne karty, edytowane pliki i oczekujące zmiany.
• Ponieważ błędny YAML powoduje domyślną aktywację reguły, literówka w paths sprawi, że reguła będzie zawsze aktywna. Po edycji sprawdź ten wpis.
• Utwórz reguły z panelu Rules w VS Code lub za pomocą polecenia ukośnikowego /newrule.

Inne pliki z instrukcjami