← ClaudeAtlas

doc-stylelisted

Стиль документации: язык, заголовки, гибридные ссылки, статусы. Триггеры: style, format, language, frontmatter, hybrid, link, ссылка, заголовок, проза.
Orange-hanter/cod-doc · ★ 0 · AI & Automation · score 70
Install: claude install-skill Orange-hanter/cod-doc
# Skill — Documentation style ## Когда подгружается Задачи, в которых **пишется или редактируется доковая проза** — capability, audit, kickoff, README, HANDBOOK. Триггер-keywords: `style`, `format`, `frontmatter`, `hybrid`, `link`, `ссылка`, `заголовок`, `markdown`, `проза`, `документация`, `doc`. ## Язык - **Проза — на языке проекта** (для cod-doc по умолчанию русский, если пользователь не сказал иное). - **Идентификаторы** (поля, типы, status, имена сущностей и таблиц, task_id, doc_key) — **всегда на английском**, даже в русской прозе. - Не смешивай транслит и кириллицу в идентификаторах. ## Заголовки - `# Title` — один на документ, в начале (после frontmatter). - `## N. Section` — нумерация для длинных доков; для коротких — без цифр. - `### Subsection` — третий уровень. Глубже — редкое исключение. ## Гибридные ссылки Формат: ``` 📁 /path/to/file.ext | 🗃️ doc:sanitized_path | 🔑 sha:12hexchars ``` Полный формат — для записей в `MASTER.md` Validation Table (раздел 5.1). Для inline — markdown-relative: `[label](relative/path.md)`. Статусы (badge'и): - `🟢 VERIFIED` — все три компонента согласованы. - `🟡 DRAFT` — черновик, ещё не прошёл валидацию. - `🟡 LEGACY` — корректный, но обзорный; canonical_source где-то ещё. - `🔴 STALE` — хэш устарел. - `🔴 BROKEN` — файл / doc-key отсутствует. ## Frontmatter Каждый документ в `docs/system/` имеет YAML-frontmatter; обязательные поля — `type`, `status`, `source_of_truth`, `owner`. Полная спецификация: [standards/f