跳到正文
cccskills
免费在 GitHub 公开

claude-md

Create, improve, or audit CLAUDE.md files that explain a project's purpose, structure, and development workflow to AI agents. Organize essential instructions, remove redundant content, and link to detailed documents where needed.

中文简介正在准备中。当前显示英语简介。

原文查看原文说明

Створення або оновлення файлів CLAUDE.md відповідно до найкращих практик для оптимального онбордингу AI-агента

查看安装方法

适用场景

  • Creating project instructions for AI agents
  • Condensing an overly long CLAUDE.md
  • Auditing existing instructions without editing files
  • Organizing instructions for individual directories

包含的文件(1)

  • SKILL.md13.0 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Введення користувача

$ARGUMENTS

Ви ПОВИННІ врахувати введення користувача перед продовженням (якщо не порожнє). Користувач може вказати:

  • create — створити новий CLAUDE.md з нуля
  • update — покращити існуючий CLAUDE.md
  • audit — проаналізувати та звітувати про якість поточного CLAUDE.md
  • Конкретний шлях для створення/оновлення (напр., src/api/CLAUDE.md для інструкцій, специфічних для каталогу)

Основні принципи

LLM не мають стану: CLAUDE.md — головний файл проєкту, що завантажується в кожну розмову (разом з автоматичною пам'яттю та правилами без обмеження області). Він слугує головним документом онбордингу AI-агентів у вашу кодову базу.

Золоті правила

  1. Менше — краще: Найсучасніші LLM можуть дотримуватись ~150-200 інструкцій. Системний промпт Claude Code вже використовує ~50. Тримайте CLAUDE.md зосередженим та лаконічним.

  2. Універсальна застосовність: Включайте лише інформацію, релевантну для КОЖНОЇ сесії. Інструкції для конкретних завдань належать до окремих файлів.

  3. Не використовуйте Claude як лінтер: Рекомендації зі стилю роздувають контекст та погіршують дотримання інструкцій. Використовуйте натомість детерміністичні інструменти (prettier, eslint тощо).

  4. Ніколи не генеруйте автоматично: CLAUDE.md — найвпливовіша точка AI-системи. Створюйте його вручну з ретельним обмірковуванням.

Потік виконання

1. Аналіз проєкту

Спочатку проаналізуйте поточний стан проєкту:

  1. Перевірити наявні файли CLAUDE.md:

    • Кореневий рівень: ./CLAUDE.md або .claude/CLAUDE.md
    • Специфічні для каталогу: **/CLAUDE.md
    • Глобальний конфіг користувача: ~/.claude/CLAUDE.md
  2. Визначити структуру проєкту:

    • Технологічний стек (мови, фреймворки)
    • Тип проєкту (монорепо, окремий додаток, бібліотека)
    • Інструменти розробки (пакетний менеджер, система збірки, тест-раннер)
  3. Переглянути існуючу документацію:

    • README.md
    • CONTRIBUTING.md
    • package.json, pyproject.toml, Cargo.toml тощо

2. Стратегія контенту (ЩО, ЧОМУ, ЯК)

Структуруйте CLAUDE.md навколо трьох вимірів:

ЩО — Технологія та структура

  • Огляд технологічного стеку
  • Організація проєкту (особливо важливо для монорепо)
  • Ключові каталоги та їхнє призначення

ЧОМУ — Призначення та контекст

  • Що робить проєкт
  • Чому були прийняті певні архітектурні рішення
  • За що відповідає кожен основний компонент

ЯК — Робочий процес та конвенції

  • Робочий процес розробки (bun vs node, pip vs uv тощо)
  • Процедури та команди тестування
  • Методи верифікації та збірки
  • Критичні «підводні камені» або неочевидні вимоги

3. Стратегія поступового розкриття

Для великих проєктів рекомендуйте створити папку agent_docs/:

agent_docs/
  |- building_the_project.md
  |- running_tests.md
  |- code_conventions.md
  |- architecture_decisions.md

У CLAUDE.md посилайтесь на ці файли інструкціями:

For detailed build instructions, refer to `agent_docs/building_the_project.md`

Важливо: Використовуйте посилання файл:рядок замість фрагментів коду, щоб уникнути застарілого контексту.

4. Обмеження якості

При створенні або оновленні CLAUDE.md:

  1. Цільова довжина: Менше 200 рядків
  2. Без правил стилю: Видалити будь-які інструкції лінтингу/форматування
  3. Без інструкцій для конкретних завдань: Перемістити до окремих файлів
  4. Без фрагментів коду: Використовувати посилання на файли замість цього
  5. Без надлишкової інформації: Не повторювати те, що є в package.json або README

5. Обовʼязкові секції

Добре структурований CLAUDE.md має включати:

# Назва проєкту

Короткий однорядковий опис.

## Технологічний стек
- Основна мова та версія
- Ключові фреймворки/бібліотеки
- База даних/сховище (якщо є)

## Структура проєкту
[Лише для монорепо або складних структур]
- `apps/` - Точки входу додатків
- `packages/` - Спільні бібліотеки

## Команди розробки
- Встановлення: `команда`
- Тестування: `команда`
- Збірка: `команда`

## Критичні конвенції
[Лише неочевидні, високовпливові конвенції]
- Конвенція 1 з коротким поясненням
- Конвенція 2 з коротким поясненням

## Відомі проблеми / Підводні камені
[Речі, що постійно створюють труднощі розробникам]
- Проблема 1
- Проблема 2

6. Антипатерни, яких слід уникати

НЕ включайте:

  • Рекомендації зі стилю коду (використовуйте лінтери)
  • Документацію щодо використання Claude
  • Довгі пояснення очевидних патернів
  • Скопійовані приклади коду
  • Загальні найкращі практики («пишіть чистий код»)
  • Інструкції для конкретних завдань
  • Автозгенерований контент
  • Розлогі списки TODO

7. Контрольний список валідації

Перед фіналізацією перевірте:

  • Менше 200 рядків
  • Кожен рядок застосовний до ВСІХ сесій
  • Без правил стилю/форматування
  • Без фрагментів коду (використані посилання на файли)
  • Команди перевірені на працездатність
  • Поступове розкриття використано для складних проєктів
  • Критичні підводні камені задокументовані
  • Немає надлишковості з README.md

Формат виводу

Для create або за замовчуванням:

  1. Проаналізувати проєкт
  2. Створити чернетку CLAUDE.md за структурою вище
  3. Представити чернетку для перегляду
  4. Записати у відповідне місце після затвердження

Для update:

  1. Прочитати існуючий CLAUDE.md
  2. Аудит за найкращими практиками
  3. Визначити:
    • Контент для видалення (правила стилю, фрагменти коду, специфічне для завдань)
    • Контент для скорочення
    • Відсутню важливу інформацію
  4. Представити зміни для перегляду
  5. Застосувати зміни після затвердження

Для audit:

  1. Прочитати існуючий CLAUDE.md
  2. Згенерувати звіт з:
    • Поточна кількість рядків vs ціль
    • Відсоток універсально застосовного контенту
    • Список знайдених антипатернів
    • Рекомендації для покращення
  3. НЕ модифікувати файл, лише звітувати

Обробка AGENTS.md

Якщо користувач запитує створення/оновлення AGENTS.md:

Починаючи з v2.1.277, Claude Code читає AGENTS.md напряму як інструкції проєкту — але лише тоді, коли ні в робочому каталозі, ні в жодному каталозі вище немає CLAUDE.md, .claude/CLAUDE.md чи CLAUDE.local.md. ~/.claude/CLAUDE.md, керований CLAUDE.md і .claude/rules/ не враховуються в цій перевірці та завантажуються паралельно. Поведінку визначає Project instructions у /config: claude-md-or-agents-md (за замовчуванням), claude-md-and-agents-md, claude-md або managed-only. Там, де пряме читання недоступне — версії до v2.1.277 (до v2.1.281 на Bedrock/Vertex/Foundry, за LLM-шлюзами або з вимкненою телеметрією) або перша сесія після оновлення — використовуйте запасний варіант: імпортуйте файл з CLAUDE.md через @AGENTS.md або зробіть CLAUDE.md символічним посиланням на нього.

AGENTS.md — це міжінструментальний файл контексту проєкту, тобто документ тієї ж категорії, що й CLAUDE.md, а не формат визначення агентів. Він існує для того, щоб кілька кодових агентів могли користуватися спільним набором конвенцій проєкту:

  • Команди збірки, тестування та лінтингу
  • Стиль коду та архітектурні конвенції
  • Структура репозиторію та розташування компонентів

Субагенти визначаються окремо — у .claude/agents/*.md, а не в AGENTS.md.

Застосовуйте аналогічні принципи:

  • Тримайте зосередженим та лаконічним
  • Використовуйте поступове розкриття
  • Посилайтесь на зовнішні документи замість вбудовування контенту

Примітки

  • Завжди перевіряйте працездатність команд перед їх включенням
  • Якщо сумніваєтесь — не включайте; менше — краще
  • Системне нагадування повідомляє Claude, що CLAUDE.md «може бути або не бути релевантним» — чим більше шуму, тим більше він ігнорується
  • Монорепо найбільше виграють від чіткої структури ЩО/ЧОМУ/ЯК
  • Файли CLAUDE.md для конкретних каталогів мають бути ще більш зосередженими

Останнє оновлення: 18 жовтня 2026 Версія Claude Code: 2.1.302 Джерела:

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Turn ideas and reference materials into a blog draft through research, discussion, and an approved outline. Produce cited articles tailored to the intended audience, then revise them while keeping each draft version.

中文简介正在准备中。当前显示英语简介。

  • Turning an idea into a blog draft
  • Writing an article from research materials
  • Agreeing on an outline before drafting
luongnv89/claude-howto4.4万2026年10月20日 更新

Turn ideas and reference materials into a blog draft with source citations. Work through research, topic development, an approved outline, and revisions, while saving source summaries and numbered drafts to track how the article develops.

中文简介正在准备中。当前显示英语简介。

  • Turning an idea into a structured blog draft
  • Writing an article from research and reference materials
  • Revising an existing draft while keeping earlier versions
luongnv89/claude-howto4.4万2026年10月20日 更新

Turn ideas and reference materials into a blog draft through research, outline approval, and revision. The workflow includes source citations, adjustments for the intended audience and tone, and separate files for each draft version.

中文简介正在准备中。当前显示英语简介。

  • Turning research materials into a blog post
  • Planning an article for a specific audience
  • Drafting articles with source citations
luongnv89/claude-howto4.4万2026年10月20日 更新

Turn ideas and reference materials into a blog draft through research, outline approval, and revision. The workflow includes source citations, adjustments for the intended audience and tone, and separate files for each draft version.

中文简介正在准备中。当前显示英语简介。

  • Turning research materials into a blog post
  • Planning an article for a specific audience
  • Drafting articles with source citations
luongnv89/claude-howto4.4万2026年10月20日 更新

Keep marketing copy, customer messages, and public content consistent with a defined brand voice. The skill provides rules for a friendly, professional tone, concise sentences, concrete examples, preferred terminology, and clear calls to action.

中文简介正在准备中。当前显示英语简介。

  • Keeping marketing copy consistent in tone
  • Writing customer messages in the brand's voice
  • Aligning terminology across public content
luongnv89/claude-howto4.4万2026年10月20日 更新

Create marketing copy, customer messages, and public content with a consistent brand voice. Apply clear vocabulary, concise sentences, concrete examples, and a friendly, professional tone so readers can understand the value being offered.

中文简介正在准备中。当前显示英语简介。

  • Aligning marketing copy with a consistent brand voice
  • Keeping customer messages friendly and professional
  • Simplifying technical explanations for general readers
luongnv89/claude-howto4.4万2026年10月20日 更新

查看 luongnv89 的全部技能

报告此技能的问题