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

knowledge-extractor — субагент для Claude Code

Субагент knowledge-extractor извлекает из завершённой работы повторно используемые решения и ошибки и сохраняет их для вики. Запускайте его после крупного этапа разработки.

MIT ★ 937 обновлён 2026-10-29

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

Что делает knowledge-extractor

Субагент читает файл завершённой кампании или недавнюю передачу контекста и выделяет закономерности, ловушки и архитектурные решения. Разовые детали проекта он пропускает. Каждую находку записывает отдельной строкой JSONL в .planning/wiki/_staging/, чтобы затем добавить её в базу знаний.

Для работы использует Read, Write, Glob и Grep. Перед записью проверяет индекс вики, не копирует уже сохранённые закономерности и пропускает находки с низкой уверенностью. Команды Bash, WebSearch, WebFetch и Agent ему недоступны, поэтому он не запускает shell-команды и не делегирует работу.

После извлечения вызовите /learn --compile, чтобы перенести находки из staging в вики. Это отдельный шаг: без него новые записи останутся в .planning/wiki/_staging/.

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

  • сохранить повторяемые решения после завершения задачи
  • зафиксировать причины сбоев и способы их устранения
  • отделить полезные для будущих задач находки от разовых деталей
  • подготовить записи для добавления в базу знаний

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

  • Используй knowledge-extractor, чтобы сохранить повторяемые решения из завершённой работы в staging вики.
  • Изучи недавнюю передачу контекста и запиши найденные ошибки и способы их исправления для вики.
  • После завершения этой задачи извлеки полезные закономерности; затем я запущу /learn --compile.

Как установить knowledge-extractor

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

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

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

.claude/agents/knowledge-extractor.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о knowledge-extractor

Как установить knowledge-extractor в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local и установите файл агента .claude/agents/knowledge-extractor.md.

Что делает knowledge-extractor?

Он анализирует завершённую работу и сохраняет повторно используемые закономерности, ошибки и решения в JSONL-файлы в .planning/wiki/_staging/. Для добавления записей в вики после этого запускают /learn --compile.

Какие инструменты использует субагент?

Он работает с файлами и поиском по проекту через Read, Write, Glob и Grep. Bash, WebSearch, WebFetch и Agent ему недоступны.

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

knowledge-extractor.md · MIT
---
name: knowledge-extractor
description: >-
  Extracts reusable patterns, pitfalls, and decisions from completed
  work and writes them to the wiki staging area. Run after finishing a
  body of work to capture what was learned. Call /learn --compile
  afterward to integrate staged findings into the knowledge wiki.
maxTurns: 30
effort: low
disallowedTools:
  - Bash
  - WebSearch
  - WebFetch
  - Agent
  - NotebookEdit
tools:
  - Read
  - Write
  - Glob
  - Grep
---

# Knowledge Extractor

You extract reusable knowledge from completed work and write it to the
wiki staging area at `.planning/wiki/_staging/` so `/learn --compile`
can integrate it into the knowledge wiki.

## What You Extract

1. **Patterns**: Approaches that worked well and should be repeated
2. **Pitfalls**: Things that broke and how they were fixed
3. **Decisions**: Architectural choices and their reasoning

## How You Work

1. Read the completed campaign file or recent session handoff
2. Identify knowledge worth preserving — only reusable findings, not one-off details
3. Write each finding as a JSONL record to `.planning/wiki/_staging/{source}-{timestamp}.jsonl`
4. Use the format below

## Staging Record Format

One JSON record per line. Each record is one finding:

```json
{"type":"pattern","name":"orientation-neighbor-naming","mechanism":"Name 2 adjacent skills in 'Don't use when' rather than only describing this skill's use case","topic":"skill-orientation","evidence":"hook-surface-update (2026-05-07)","confidence":"high","applies-to":"Any skill corpus where 2+ skills have overlapping but distinct use cases"}
{"type":"pitfall","name":"early-exit-before-check","mechanism":"Placing an early process.exit() before the check that needs to run defeats the check","topic":"hook-design","evidence":"intake-scanner wiki-staging fix (2026-05-07)","confidence":"high","applies-to":"Any Node.js hook that has multiple check paths"}
{"type":"decision","what":"Wiki lives at .planning/wiki/ not .claude/","rationale":"Claude Code silently blocks writes under .claude/","outcome":"completed","topic":"harness-design"}
```

## Field Reference

| Field | Required | Description |
|---|---|---|
| `type` | yes | `pattern`, `pitfall`, or `decision` |
| `name` | yes | Short kebab-case identifier |
| `topic` | yes | Wiki page slug (e.g., `skill-orientation`, `hook-design`) |
| `mechanism` | yes (pattern/pitfall) | What caused success or failure |
| `what` + `rationale` + `outcome` | yes (decision) | Decision record |
| `evidence` | yes | Source: campaign slug and date |
| `confidence` | yes | `high`, `medium`, or `low` |
| `applies-to` | recommended | Scope description |

## Rules

- Only extract knowledge that is REUSABLE across future work
- Don't extract project-specific implementation details
- Don't duplicate patterns already in `.planning/wiki/` (check the index first)
- Skip `confidence: low` findings — a bad entry in the wiki is worse than no entry
- Keep each record focused on one finding
- Create `.planning/wiki/_staging/` if it does not exist
- Timestamp format for filename: use `Date.now()` equivalent (ms since epoch)

## After Extraction

Tell the user: "Staged {N} findings to `.planning/wiki/_staging/`. Run `/learn --compile` to integrate into the wiki."

© SethGammon · MIT · SethGammon/Citadel

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →
openclaw-history-ingest Ar9av Скилл openclaw-history-ingest для Claude Code и пяти других платформ читает сессии и файлы памяти OpenClaw и дистиллирует их в страницы Obsidian-вики. Запускается вручную или через роутер wiki-history-ingest. CX Codex +1 2 200установок memory-extractor parcadei Субагент memory-extractor для Claude Code находит в рассуждениях смену понимания и сохраняет её как рабочее знание. Фиксирует исправления, закономерности, выводы и приёмы отладки. CX Codex ★ 3 951звёзд репо compile-knowledge 5dive-ai Скилл compile-knowledge для Claude Code сохраняет ключевые решения в markdown-файлы с перекрёстными ссылками и обновляет индекс памяти. Запускается по прямой команде или при фиксации архитектурного решения. CX Codex +1 3 300установок wiki-knowledge-complier bradduy Плагин wiki-knowledge-complier превращает документы в личную базу знаний на markdown-файлах: плагин разбирает источники, строит граф сущностей и отвечает на вопросы по ним. ★ 12звёзд репо Cantara wiki — community knowledge web Cantara Cantara wiki — community knowledge web — MCP-сервер для Claude Code, который отдаёт агенту архив открытой вики Cantara: 2 290 статей о норвежском опенсорсе за 2008–2022 годы. CX Codex +1 notion-knowledge-capture makenotion Скилл notion-knowledge-capture для Claude Code переносит итоги диалога и заметки в Notion как статьи базы знаний, инструкции или записи решений. Сохраняет зафиксированные договорённости без выдумывания фактов. CX Codex +1 612установок

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

Весь набор →
arch-reviewer Субагент arch-reviewer проверяет архитектурные границы слоёв, циклические импорты и правила проекта без изменения файлов. CX Codex ★ 937звёзд репо session-handoff Скилл session-handoff собирает итоги текущей сессии в блок HANDOFF, чтобы следующая сессия сразу продолжила работу без повторного аудита. CX Codex +1 ★ 937звёзд репо verify Скилл verify для Claude Code и Codex, самопроверяет конвейер хуков Citadel во время работы. Запускает реальные вызовы инструментов (Write, Edit, Bash, Read), проверяет, что все хуки срабатывают, телеметрия накапливается и нет ошибок. CX Codex +1 ★ 937звёзд репо unharness Скилл unharness для Claude Code готовит план удаления Citadel из проекта и сохраняет переносимый архив. Запускается по просьбе удалить Citadel или очистить проект от harness. CX Codex +1 ★ 937звёзд репо grill Скилл grill превращает размытый план в чёткое техническое задание через интервью: по одному вопросу, каждый с готовым ответом на выбор. CX Codex +1 ★ 937звёзд репо autopilot Скилл autopilot автоматизирует очередь задач из папки .planning/intake/: составляет бриф, вносит правки в код и проверяет результат. CX Codex +1 ★ 937звёзд репо doc-gen Скилл doc-gen создаёт комментарии к функциям, README для каталогов и справку по API, подстраиваясь под стиль проекта. Полезен, когда документацию нужно сверить с кодом, а не пересказать сигнатуры. CX Codex +1 ★ 937звёзд репо policy-enforcer Субагент policy-enforcer для Claude Code сверяет планируемое действие с правилами Citadel и возвращает вердикт: разрешить или заблокировать. Archon и Fleet запускают его перед операциями с низкой обратимостью. CX Codex ★ 937звёзд репо

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

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