Часто задаваемые вопросы
Распространённые вопросы о назначении Apothem, поддерживаемых окружениях, необязательности наборов планов, настройке правил, типах артефактов и расположении состояния экосистемы.
Распространённые вопросы, в порядке частоты.
Что такое apothem?
Apothem — это независимый от хоста менеджер конфигурации для окружений ассистентов по написанию кода. Вы описываете один общий профиль, и Apothem материализует его в нативную поверхность конфигурации каждого инструмента — объединяя поведенческие правила, творческие стандарты, слэш-команды, постоянных делегированных исполнителей, хуки и навыки в единый управляемый корпус, который остаётся согласованным во всех окружениях.
С какими окружениями ассистентов работает Apothem?
Apothem не зависит от окружения. Адаптеры для конкретных окружений в каталоге
src/apothem/harnesses/<harness>/ проецируют общий профиль в
нативный каталог конфигурации каждого инструмента. Реестр окружений, используемый во время
выполнения, — авторитетный источник для набора поддерживаемых окружений;
страницы окружений описывают каждое из них. В настоящее время реестр
охватывает следующие поддерживаемые окружения:
Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi CodeАдаптер Claude Code материализуется в ~/.claude/; его диспетчер хуков нейтрален к хосту —
он разрешает корень экосистемы сначала из $CLAUDE_PROJECT_DIR, затем из
$LLM_PROJECT_DIR, затем пробует поиск относительно скрипта и рабочего каталога и в
конце откатывается к $HOME/.claude.
Обязательно ли использовать конвейер наборов планов?
Нет. Конвейер наборов планов — это один из компонентов экосистемы. Поведенческие правила, творческие стандарты, хуки и набор инструментов валидаторов полезны сами по себе.
Как настроить правила без форка репозитория?
Добавьте строку в список rules: в ~/.config/apothem/profile.yaml и повторно запустите
установку или обновление. Файлы правил в src/apothem/rules/ редактируют упакованное
дерево исходников, которое архивный установщик заменяет при запуске с --yes.
Как временно отключить правило?
Либо переименуйте файл так, чтобы он не соответствовал шаблону src/apothem/rules/*.md,
либо переместите его в соседний каталог, который загрузчик не
сканирует.
В чём разница между правилами, навыками и делегированными исполнителями?
- Правила управляют поведением — всегда активные или фильтруемые по пути обязательства, которым следует ассистент.
- Навыки — это переиспользуемые обнаруживаемые техники: сигнал обнаружения, процедура и хук обеспечения соблюдения.
- Делегированные исполнители — это постоянные роли с собственными ограничениями инструментов и системными подсказками, диспетчеризуемые через протокол оркестрации исполнителей.
Как сообщить о проблеме безопасности?
См. SECURITY.md. Поддерживаемые каналы — это GitHub Security
Advisories и [email protected].
Как внести вклад?
См. Внесение вклада. Кратко: прочитайте
CONTRIBUTING.md, сделайте форк репозитория, откройте PR с заполненным
каноническим шаблоном PR и убедитесь, что проверки CI проходят — в
руководстве разработчика перечислены шлюзы, которые должен пройти PR.
Где хранится состояние экосистемы?
- Состояние планов по набору планов хранится в
<project>/.apothem/plans/{suite}/. - Память Apothem хранится в
.apothem/memory/под корнем установки (для Claude Code:~/.claude/.apothem/memory/;~/.apothem/memory/, когдаworkspace.scopeравенuser-home;<project>/.apothem/memory/для установок в масштабе проекта). Собственная автопамять Claude Code хранится в корне конфигурации окружения, вprojects/{hash}/memory/(для Claude Code:~/.claude/projects/{hash}/memory/). - Межпроектная память хранится в том же корне конфигурации окружения, в
.apothem/memory/(для Claude Code:~/.claude/.apothem/memory/). - Черновики по сессии хранятся в
<project>/.apothem/plans/{suite}/_inputs/.
Могу ли я продолжить длительную работу в новой сессии или на другой машине?
Да. Длительная работа выносит своё полное состояние в локальный для проекта
набор планов .apothem/plans/ — контракт возобновления плюс протокол холодного старта —, так
что работа не живёт внутри одной истории чата. Поскольку состояние находится в
файлах вашего проекта, новая сессия на любой учётной записи или машине,
указывающая на тот же проект, продолжает работу на месте. Apothem сам не
переносит файлы между учётными записями; они перемещаются так же, как уже
перемещаются файлы вашего проекта (контроль версий, общая рабочая копия,
синхронизируемый каталог). См. Возобновляемое планирование.
Нужен ли Apothem pip?
Нет — не для самого движка. Движок — это самодостаточное дерево исходного кода с
поставляемыми зависимостями — он запускается как python -m apothem из любого
извлечённого дерева, кэша npx или дерева плагина на системном Python 3.10+ и не
устанавливает никакого собственного кода в site-packages (click и rich —
единственные предварительные требования к интерпретатору). Единственное
необязательное исключение: если click или rich отсутствует, установщик
предлагает выполнить pip install только для этих двух за вас — с вашего
подтверждения или через --yes / APOTHEM_AUTO_INSTALL_DEPS=1. Собственные
пакеты Apothem никогда не устанавливаются в site-packages.
Как хуки работают без установленного пакета?
apothem install материализует диспетчер хуков и шлюз соответствия
в корне окружения (для Claude Code: ~/.claude/.apothem/support/hooks/ и
~/.claude/.apothem/support/conformity/), а отрисованные записи хуков вызывают эти
скрипты по абсолютному пути. Оба являются автономными скриптами на стандартной библиотеке, поэтому хуки
работают на машине, которая никогда не видела pip install.
Как полностью удалить?
Запустите apothem uninstall --harness <name> для каждого установленного окружения, удалите
движок согласно вашему каналу установки и удалите ~/.apothem/ (резервные копии) плюс
~/.config/apothem/ (ваш профиль), если хотите нулевой остаток.
Руководство по удалению проходит по каждому каналу.
Под какой лицензией находится экосистема?
MIT — см. LICENSE.