Skip to content
Apothem
Сравнение

Apothem против сырых правил CodeBuddy

Почему проектные правила CodeBuddy стоит направлять через Apothem, а не писать файлы .codebuddy/rules вручную для каждого проекта.

CodeBuddy читает проектные правила из .codebuddy/rules/*.md. Эти файлы можно вручную писать для каждого проекта бесконечно. Адаптер codebuddy в Apothem формирует один из них из общего профиля и поддерживает его согласованным во всех окружениях и во всех проектах. На этой странице сравнивается ручное сопровождение такой конфигурации с управлением ею через Apothem.

Сравнение усилий

ЗадачаРучная конфигурацияПод управлением Apothem
Написать правилаКопировать одни и те же дисциплины в .codebuddy/rules/ для каждого проектаФормируются из одного общего корпуса
Источник истиныФайлы каждого проектаОдна каноническая группа
Поддерживать правила согласованными между окружениямиВыводить заново для каждого инструментаПроецируются автоматически
Обновить правилаВручную редактировать каждый проектapothem update --harness codebuddy --project <path>
Удалить конфигурациюУдалять вручнуюapothem uninstall с резервной копией с меткой времени
Делиться переиспользуемыми навыками и командамиВручную копировать каждую папку навыка в ~/.codebuddy/skills/ и поддерживать копии актуальнымиЗаписываются адаптером в ~/.codebuddy/skills/, одна копия для всех проектов, и обновляются при apothem update

Чем управляет Apothem

Адаптер codebuddy формирует общие правила в отдельном файле <project>/.codebuddy/rules/apothem-rules.md. Он также записывает две папки в вашем домашнем каталоге, общие для всех проектов: навыки и команды, обёрнутые как навыки, попадают в ~/.codebuddy/skills/, а правила и шаблоны, на которые ссылаются эти навыки, — в ~/.config/apothem/rules/ и ~/.config/apothem/templates/. Ваш файл памяти CODEBUDDY.md, разрешения и серверы MCP в .codebuddy/settings.json, а также любые другие файлы правил, которые вы пишете, полностью принадлежат оператору: адаптер распознаёт эти поверхности, но никогда их не редактирует. Каждое изменение общих правил перегенерирует файл правил при следующем apothem update.

Путь миграции

  1. Выполните apothem profile init, чтобы создать общий профиль, если вы ещё этого не сделали.
  2. Перенесите дисциплины из существующих файлов .codebuddy/rules/ в общий корпус.
  3. Выполните apothem install --harness codebuddy --project <path>, чтобы сформировать файл apothem-rules.md рядом с вашими нетронутыми правилами.
  4. Выполните apothem verify --harness codebuddy --project <path>, чтобы подтвердить, что конфигурация установлена.
  5. Используйте apothem update --harness codebuddy --project <path> для каждого последующего изменения.

Читать далее

On this page