Skip to content
Apothem
ハウツーレシピ

プロファイルを編集する

共有プロファイルを変更し、インストール済みの全ハーネスを再生成します。

目標: 共有プロファイルの値を変更し、それをインストール済みの全ハーネスへ 反映させます。

前提条件

  • PATH 上の apothem CLI(または自己完結型の形式: PYTHONPATH="$HOME/.apothem/src" を前に付けて python -m apothem を実行するか、npx @ahmed-g-gad/apothem を使用)。
  • ~/.config/apothem/profile.yaml にあるプロファイル。存在しない場合は apothem profile init で作成してください。

プロファイルの形

プロファイルは単一の YAML ドキュメントです。そのトップレベルのキーは 次のとおりです:

  • identity(必須)—— name、加えて任意の role、email、website、 github。
  • preferences —— language、style(concise / verbose / balanced)、 formatter、test_framework。
  • rules —— 対応するハーネスと共有される追加ルール文字列のリスト。
  • seriousness —— EXPLORING、PERSONAL_USE、SHARED、PUBLIC_LAUNCH のいずれか。
  • enforcement —— オプトインのトグル(sprints、agent_teams、 multitasking、continuous_execution、learning_loop)。すべての フラグはデフォルトでオフです。
  • harnesses —— ハーネス id をキーとするハーネスごとのオーバーライド。
  • exclude_harnesses —— 一括(--harness all)コマンドでスキップされる ハーネス id。
  • mcp_servers —— サーバー名をキーとする MCP サーバーの定義。
  • agent_mcp_servers —— ヘルパー名ごとに、そのヘルパーが呼び出せる MCP サーバー(ヘルパーに MCP サーバーへのアクセスを与えるを参照)。 デフォルトでは空であるため、どのヘルパーも MCP ツールに到達しません。
  • workspace —— Apothem が共有作業ディレクトリを置く場所 (directory_name、scope)。
  • schema_version —— 任意のプロファイルスキーマのバージョン。これを持たない プロファイルはバージョン 1 として読み込まれます。

すべてのフィールドはプロファイルフィールドに一覧されています。

手順

  1. 現在のプロファイルを調べます:

    apothem profile show

  2. 編集します。システムエディターで開きます:

    apothem profile edit

    あるいは、コマンドラインから単一のドット区切りキーを設定します。値は そのまま(リテラルに)保存され(true/false および明示的な [..]/{..} 入力は例外)、書き込みの前にプロファイルがスキーマに対して 検証されます —— 無効な設定は拒否され、ディスク上のプロファイルは 変更されません:

    apothem profile set seriousness SHARED
apothem profile set identity.name "Ada Lovelace"

  3. 変更がネイティブ構成に届くよう、ハーネスを再生成します。 ユーザースコープのハーネスの場合:

    apothem update --harness claude-code

    プロジェクトスコープのハーネスの場合は、プロジェクトルートを渡します。 インストール済みの全ハーネスを更新するには all を使用します:

    apothem update --harness cursor --project /path/to/project
apothem update --harness all --project /path/to/project

検証

apothem profile show
apothem verify --harness all

profile show は編集内容を反映します。

apothem verify --harness all は、プロファイルの exclude_harnesses に記載されたものを除く、登録済みのすべてのハーネスを確認します。そのため、除外されていないほかのすべてのハーネスがインストールされていない限り、非ゼロ終了コードで終了します。プロジェクトスコープのハーネスには --project PATH も必要です。指定しない場合、バッチは project.required エラーで停止します。更新したハーネスだけを確認するには、そのハーネス名を指定して同じコマンドを実行してください：

apothem verify --harness <name>

インストールしていないハーネスがあってもよい、システム全体の確認には、apothem doctor を実行します。

関連

  • 再生成の前に新しいハーネスをプロファイル管理下に置くには、ハーネスを追加する を行います。
  • 更新 は、再生成の手順と並行してエンジンを アップグレードする方法を扱います。

ハウツーレシピ

ハーネスの追加、プロファイルの編集、スクリプトインストーラーの操作のための、タスクに焦点を当てたレシピ。

ハーネスを追加する

ハーネスアダプターを有効化し、そのネイティブ構成を共有プロファイルから生成します。

On this page

前提条件プロファイルの形手順検証関連