К основному содержанию
команда CX Codex

learn · rohitg00 — слэш-команда для Claude Code: что делает и как установить

Команда learn показывает советы по работе с Claude Code и сохраняет подтверждённые выводы из сессии. Помогает разобраться с контекстом, режимами и субагентами.

MIT ★ 2 966 обновлён 2026-09-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow
Открыть на GitHub

Что делает learn

Вызов /learn открывает руководство по практикам Claude Code, а /learn <topic> показывает советы по выбранной теме. В нём разбираются режимы работы, контекст и память проекта, составление запросов, субагенты, рабочие деревья и хуки. Есть и памятка по сочетаниям клавиш и встроенным командам.

Вызов /learn save сохраняет вывод из текущей сессии в базу. Для установки в Claude Code сначала добавьте маркетплейс, затем установите плагин. Команда также перечисляет сведения о функциях и моделях Claude Code, поэтому перед применением советов о них сверяйте их со своей версией.

Какие задачи решает

  • Найти советы Claude Code по конкретной теме
  • Сохранить вывод из сессии в базу
  • Разобраться, когда использовать режим Plan или субагентов
  • Вспомнить сочетание клавиш или команду Claude Code

Примеры запросов агенту

  • Покажи советы по работе с контекстом с помощью /learn context.
  • Сохрани выводы из этой сессии командой /learn save.
  • Объясни, когда для задачи стоит использовать субагентов. Запусти /learn.

Как установить learn

1Через маркетплейс плагинов

/plugin marketplace add rohitg00/pro-workflow
/plugin install pro-workflow@pro-workflow

2Вручную: положить файлы

.claude/commands/learn.md

Вызов — /learn. Для всех проектов — ~/.claude/commands/

Вопросы о learn

Как установить learn в Claude Code?

Сначала выполните /plugin marketplace add rohitg00/pro-workflow, затем /plugin install pro-workflow@pro-workflow. Файл команды находится в .claude/commands/learn.md.

Что делает learn?

Команда показывает руководство по практикам Claude Code, а по запросу /learn save сохраняет вывод из текущей сессии в базу.

Как получить советы по отдельной теме?

Передайте тему после команды, например /learn context или /learn prompting.

Исходный текст

learn.md · MIT
---
description: Show Claude Code best practices and save confirmed session learnings.
---

# /learn - Claude Code Best Practices & Learning Capture

Learn Claude Code best practices and capture lessons into persistent memory.

## Usage

- `/learn` — Show best practices guide
- `/learn <topic>` — Show practices for a specific topic (e.g., `/learn context`, `/learn prompting`)
- `/learn save` — Capture a lesson from this session into the database

## Best Practices

### Sessions & Context
- Every Claude Code invocation is a session. Claude reads your project on start.
- Context window is finite (1M tokens on Fable 5.1, Opus 5.5, and Sonnet 5; 200K on Haiku 4.5). Use `/context` to check usage.
- Use `/compact` at task boundaries — after planning, after a feature, when >70%.
- Don't compact mid-task. You lose working context.
- Plan mode now survives compaction (fixed in 2.1.49).
- **Docs:** https://code.claude.com/docs/common-workflows
- **Pattern:** Context Discipline (Pattern 7)

### CLAUDE.md & Memory
- CLAUDE.md is persistent project memory. It loads every session.
- Put: project structure, build commands, conventions, constraints, gotchas.
- Don't put: entire file contents, obvious things, rapidly changing info.
- For complex projects, split into AGENTS.md, SOUL.md, LEARNED.md.
- **Docs:** https://code.claude.com/docs/settings
- **Pattern:** Split Memory (Pattern 4)

### Modes
- **Normal** — Claude asks before edits (default)
- **Auto-Accept** — Claude edits without asking (trusted iteration)
- **Plan** — Research first, then propose plan (complex tasks)
- **Simple** — Bash + Edit tools only (lightweight, no extra overhead)
- Use Plan mode when: >3 files, architecture decisions, multiple approaches, unclear requirements.
- Toggle with `Shift+Tab`.
- **Docs:** https://code.claude.com/docs/common-workflows
- **Pattern:** 80/20 Review (Pattern 5)

### CLI Shortcuts
| Shortcut | Action |
|----------|--------|
| `Shift+Tab` | Cycle modes (Normal/Auto-Accept/Plan) |
| `Ctrl+L` | Clear screen |
| `Ctrl+C` | Cancel generation |
| `Ctrl+B` | Run task in background |
| `Ctrl+F` | Kill all background agents (two-press confirmation) |
| `Ctrl+T` | Toggle task list (agent teams) |
| `Shift+Down` | Navigate teammates (wraps around) |
| `Up/Down` | Prompt history |
| `/compact` | Compact context |
| `/context` | Check context usage |
| `/clear` | Clear conversation |
| `/agents` | Manage subagents |
| `/model` | Switch models |
| `/commit` | Smart commit with quality gates |
| `/insights` | Session analytics and patterns |
- **Docs:** https://code.claude.com/docs/cli-reference

### Worktrees
Native worktree support (2.1.49+):
```bash
claude --worktree    # or claude -w
```
Creates an isolated git worktree automatically. Subagents support `isolation: worktree` in frontmatter.

### Prompting
Good prompts have four parts:
1. **Scope** — What files/area to work in
2. **Context** — Background info Claude needs
3. **Constraints** — What NOT to do
4. **Acceptance criteria** — How to know it's done

Bad: "Add rate limiting"
Good: "In src/auth/, add rate limiting to the login endpoint. We use Express with Redis. Don't change session middleware. Return 429 after 5 failed attempts per IP in 15 min."

### Writing Rules
Rules in CLAUDE.md prevent Claude from going off-track.
- Good: "Always use snake_case for database columns"
- Good: "Run pytest -x after any Python file change"
- Bad: "Write good code"
- Bad: "Be careful"
- **Pattern:** Self-Correction Loop (Pattern 1)

### Skills
Skills are reusable commands defined in markdown with frontmatter. Create one when you repeat the same prompt pattern >3 times.
- **Docs:** https://code.claude.com/docs/settings
- **Pattern:** Learning Log (Pattern 8)

### Subagents
Subagents run in separate context windows for parallel work.
- Use for: parallel exploration, background tasks, independent research.
- Avoid for: single-file reads, tasks needing conversation context.
- Press `Ctrl+B` to send tasks to background.
- Press `Ctrl+F` to kill all background agents (two-press confirmation).
- ESC cancels the main thread only; background agents keep running.
- Create custom subagents in `.claude/agents/` (project) or `~/.claude/agents/` (user).
- Subagents support: custom tools, permission modes, persistent memory, hooks, skill preloading, and **worktree isolation**.
- Agent definitions support `background: true` to always run as background tasks.
- Built-in subagents: Explore (fast read-only), Plan (research), general-purpose (multi-step).
- Use `/agents` to manage subagents interactively.
- **Docs:** https://code.claude.com/docs/sub-agents
- **Pattern:** Parallel Worktrees (Pattern 2)

### Agent Teams (Experimental)
Coordinate multiple Claude Code instances working together as a team.
- Enable: set `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` in settings.json or environment.
- One lead session coordinates, teammates work independently with their own context windows.
- Teammates can message each other directly (unlike subagents which only report back).
- Shared task list with self-coordination and dependency management.
- Display modes: in-process (`Shift+Down` to navigate, wraps around) or split panes (tmux/iTerm2).
- Delegate mode (`Shift+Tab`): restricts lead to coordination only.
- Best for: parallel code review, competing hypotheses debugging, cross-layer changes, research.
- Avoid for: sequential tasks, same-file edits, simple operations.
- **Docs:** https://code.claude.com/docs/agent-teams

### Adaptive Thinking
Claude calibrates reasoning depth to each task automatically.
- Lightweight tasks get quick responses, complex tasks get deep analysis.
- No configuration needed on Fable 5.1, Opus 5.5, and Sonnet 5: they think adaptively by default; tune depth with `effort`.
- Extended thinking is built-in on those tiers — no need to toggle a separate mode.
- Haiku 4.5 is different: it uses manual extended thinking (`budget_tokens`), does not support adaptive thinking, and rejects `effort`.

### Model Selection
- Current lineup: Fable 5.1, Opus 5.5, Sonnet 5, Haiku 4.5. Switch with `/model`.
- See `references/models-2026.md` for strings, prices, and routing.
- Use Haiku 4.5 for quick, read-only exploration subagents.

### Context Compaction
Keeps long-running agents from hitting context limits.
- Auto-compacts at ~95% capacity (configurable via `CLAUDE_AUTOCOMPACT_PCT_OVERRIDE`).
- Compact manually at task boundaries with `/compact`.
- Custom subagents support auto-compaction independently.
- Use PreCompact hooks to save state before compaction.
- Plan mode now survives compaction (2.1.49 fix).

### Hooks
Hooks run scripts on events to automate quality enforcement.
- Types: PreToolUse, PostToolUse, SessionStart, SessionEnd, Stop, UserPromptSubmit, PreCompact, SubagentStart, SubagentStop, **ConfigChange**, Notification
- **ConfigChange** (2.1.49+): fires when settings files change mid-session — useful for security auditing.
- **Stop hook** now receives `last_assistant_message` for context-aware reminders.
- Pro-Workflow ships hooks for edit tracking, quality gates, config monitoring, and learning capture.
- Subagent hooks: define in frontmatter or settings.json for lifecycle events.
- **Docs:** https://code.claude.com/docs/hooks

### Plugins
- Plugins can ship `settings.json` for default permission configuration (2.1.49+).
- Pro-Workflow ships default permissions for quality gate commands (lint, test, typecheck).
- **Docs:** https://code.claude.com/docs/plugins

### Security
- Review permission requests carefully.
- Don't auto-approve shell commands you don't understand.
- Keep secrets out of CLAUDE.md.
- Use `.gitignore` and `.claudeignore` for sensitive files.
- **Docs:** https://code.claude.com/docs/security

### MCP
- Keep <10 MCPs enabled, <80 tools total.
- Disable MCPs you're not actively using.
- Each MCP adds context overhead.
- MCP auth failures are now cached to avoid repeated connection attempts.
- **Docs:** https://code.claude.com/docs/mcp

### Integration
- **VS Code / JetBrains:** https://code.claude.com/docs/ide-integration
- **GitHub Actions:** https://code.claude.com/docs/github-actions
- **Troubleshooting:** https://code.claude.com/docs/troubleshooting

## Learning Path

**Beginner:** Sessions, CLI shortcuts, context management, modes
**Intermediate:** CLAUDE.md, writing rules, prompting, skills
**Advanced:** Subagents, hooks, MCP, GitHub Actions, Pro-Workflow patterns 1-8

## Saving Learnings

When the user runs `/learn save`, capture a lesson from this session.

### Step 1: Identify the learning

Ask the user what they learned, or extract it from the conversation. Format it as:

```
Category: <category>
Rule: <one-line description of the correct behavior>
Mistake: <what went wrong>
Correction: <how it was fixed>
```

### Categories
- Navigation (file paths, finding code)
- Editing (code changes, patterns)
- Testing (test approaches)
- Git (commits, branches)
- Quality (lint, types, style)
- Context (when to clarify)
- Architecture (design decisions)
- Performance (optimization)
- Claude-Code (sessions, modes, CLAUDE.md, skills, subagents, hooks, MCP)
- Prompting (scope, constraints, acceptance criteria)

### Step 2: Save to database

After the user confirms the learning, write it to the database:

```bash
sqlite3 ~/.pro-workflow/data.db "INSERT INTO learnings (project, category, rule, mistake, correction) VALUES ('<project>', '<category>', '<rule>', '<mistake>', '<correction>');"
```

Replace `<project>` with the current project name (from `basename $PWD`), or `NULL` if unknown. Escape single quotes in values by doubling them (`''`).

Alternatively, use the store API:

```bash
node -e "const p = require('path'); const {createStore} = require(p.join(process.env.HOME, '.claude/plugins/marketplaces/pro-workflow/dist/db/store.js')); const s = createStore(); const l = s.addLearning({project: '<project>', category: '<category>', rule: '<rule>', mistake: '<mistake>', correction: '<correction>'}); console.log('Saved as learning #' + l.id); s.close();"
```

### Step 3: Confirm to user

After saving, output a confirmation with the learning ID:

```
Saved as learning #<id>. Use /search <keyword> to find this later.
```

### Auto-capture via [LEARN] tags

You can also emit `[LEARN]` blocks in your response, which the Stop hook will auto-capture:

```
[LEARN] Category: Rule text here
Mistake: What went wrong
Correction: How it was fixed
```

### Example

```
Category: Claude-Code
Rule: Use plan mode before multi-file changes
Mistake: Started editing 5 files without a plan, had to redo
Correction: Enter plan mode first, get approval, then execute
```

After user confirms → run the sqlite3 INSERT → output:

```
Saved as learning #42. Use /search plan to find this later.
```

Learnings are stored in `~/.pro-workflow/data.db` and persist across sessions.

Use `/search <keyword>` to find past learnings.
Use `/list` to see all learnings.

---

**Trigger:** Use when user says "learn", "teach me", "best practices", "remember this", or after making a mistake.

© Rohit Ghumare · MIT · rohitg00/pro-workflow

Похожие слэш-команды

Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →

Сначала — learn от других авторов.

learn Affaan Mustafa Слэш-команда learn находит в текущей сессии повторяемые решения и оформляет их как скиллы. Подходит после сложной отладки или нестандартной задачи. CX Codex +1 ★ 6 739звёзд репо learn LihFolk Команда learn для Claude Code анализирует журнал оценок .lihfolk/ledger.jsonl и собирает правила в .lihfolk/recipes.md. Запускает дистилляцию паттернов для улучшения первых драфтов. CX Codex +1 ★ 98звёзд репо learn-codebase thedotmack Скилл learn-codebase для Claude Code, Codex, Cursor и других платформ ИИ-кодинга, который читает все исходные файлы проекта целиком. Запускается по команде пользователя в начале работы с незнакомым репозиторием. CX Codex +1 5 800установок context-engineering официальный github Правило context-engineering для GitHub Copilot, которое учит структурировать код и проект так, чтобы модель лучше понимала кодовую базу. Советы касаются путей файлов, типов, открытых вкладок и файла COPILOT.md. CX Codex +1 ★ 41 430звёзд репо agent-context-budget WenyuChiou Скилл agent-context-budget для Claude Code, который держит основную сессию маленькой, пока субагенты читают и пишут. Ограничивает размер ответов, выбирает дешёвый тир моделей для механических задач и фиксирует решения как предложения. CX Codex +1 ★ 34звёзд репо learn-taste emilkowalski Скилл learn-taste для Claude Code превращает правки по дизайну в правила с объяснениями. Он разбирает замечания из текущей сессии и предлагает, что сохранить для следующих задач. CX Codex +1 13 700установок learn-agent-skills rohitg00 Интерактивный тьютор по созданию, вызову, тестированию и упаковке скиллов для агентов. Разбирает по одному уроку за вызов и сохраняет прогресс в файле AGENT-SKILLS-LEARNING.md. CX Codex +1 3 700установок Microsoft Learn MCP microsoft MCP-сервер Microsoft Learn MCP, который подключает к IDE официальную документацию Microsoft и Azure прямо из источника. Агент получает актуальные статьи, примеры кода и полный текст страниц через единый интерфейс. CX Codex +1 1 272установок

Из того же набора83

Весь набор →
skill-router Скилл skill-router для Claude Code показывает навыки и слэш-команды pro-workflow по задачам и объясняет, как они запускаются. Указывает, с какого элемента pro-workflow начать. CX Codex +1 ★ 2 966звёзд репо permission-analyst Субагент permission-analyst для Claude Code. Анализирует запросы разрешений и отказы, рекомендует правила permissions и записи autoMode — разбирает случаи, когда промпты тормозят работу или авторежим откатывается к подтверждениям. CX Codex ★ 2 966звёзд репо safe-mode Скилл safe-mode защищает проект от разрушительных команд терминала и ограничивает правки одной папкой через хуки Claude Code. CX Codex +1 ★ 2 966звёзд репо wiki-research-loop Скилл wiki-research-loop для Claude Code запускает цикл веб-исследования и пополняет вики страницами по теме. Агент включает его по запросу research <topic>, для роста вики или автоматического исследования. CX Codex +1 ★ 2 966звёзд репо survey-generator Скилл survey-generator генерирует структурированный обзор научных статей по теме из AI/ML. Результат — wiki-страница в markdown с библиографией, а не одноразовый HTML. CX Codex +1 ★ 2 966звёзд репо context-engineering Скилл context-engineering задаёт правила управления контекстом в Claude Code через четыре операции: запись, выборку, сжатие и изоляцию рабочих сессий. CX Codex +1 ★ 2 966звёзд репо pro-workflow Скилл pro-workflow собирает рабочие привычки для ИИ-кодинга: самокоррекцию, параллельные сессии в worktree, ритуал завершения и точки ревью. CX Codex +1 ★ 2 966звёзд репо pro-workflow Плагин pro-workflow добавляет в Claude Code долговременную память на базе SQLite, базу знаний с поиском FTS5 и набор из 23 слэш-команд. ★ 2 966звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой