Skip to content
Apothem
ハーネスアダプター

OpenCode

OpenCode(ベータ版)向けの Apothem ハーネスアダプター。

ベンダー: OpenCode インストール名: opencode ステータス: ベータ版 ネイティブ設定: ~/.config/opencode/

インストール

apothem install --harness opencode

アダプターは OpenCode の JSON 設定を書き込み、Apothem のスキルを OpenCode のスキル面にインストールし、コマンドプロンプトを OpenCode の Markdown コマンドファイルに変換し、Apothem のヘルパー定義を OpenCode のサブヘルパーとして正規化します。

書き込まれるファイル:

~/.config/opencode/opencode.json
~/.config/opencode/apothem/rules/00-apothem-profile.md
~/.config/opencode/commands/
~/.config/opencode/skills/
~/.config/opencode/agents/
~/.config/opencode/.apothem/support/{rules,templates,hooks}/

プロファイルからネイティブ設定へのマッピング

アダプターは、あなたのプロファイルドキュメント、4 つのコアルール、ルールインデックスを指定する instructions ファイルリストを含めて opencode.json をレンダリングし、その後、共有された各 Apothem コホートを、OpenCode のネイティブ面または Apothem 所有のサポートサブツリーのいずれかへ伝播します。 既存の、一致する Apothem 管理の子要素は、置き換えの前にバックアップされます。

互換性に関する注意

OpenCode は、instructions リストが指定するすべてのファイルを、すべてのセッションに結合します(OpenCode のルール)。 そのため、このリストは最初にあなたのプロファイルドキュメントを指定し、続いて alwaysApply が true であるルールのみを、それぞれ 1 つの明示的な ~/.config/opencode/.apothem/support/rules/<name>.md パスとして指定します。 OpenCode は先頭の ~/ をあなたのホームディレクトリに展開します。 それらのルールは、agnostic-posture、authority-inquiry、context-management、session-closure、そしてルールインデックスの apothem-rule-index です。 OpenCode はどのルールもパスでスコープしないため、それ以外のすべてのルールはオンデマンドで読み込まれます。 それらは ~/.config/opencode/.apothem/support/ 配下に参照素材としてインストールされたまま残り、インデックスが各ルールとそれを必要とする状況を名指しします。 ルール、テンプレート、フックプロンプトを参照するルール、スキル、コマンドは、そこからそれを読み込みます。 コマンド、スキル、ヘルパー定義はネイティブの検出場所を使用します。

プロファイルドキュメント ~/.config/opencode/apothem/rules/00-apothem-profile.md は、共有プロファイルに由来するあなたのアイデンティティとプリファレンスを保持し、Apothem サポートファイルのセクションで終わります。 このセクションは、リポジトリ形式の各参照(rules/<name>.md、templates/...、hooks/...)が解決される先の、~/.config/opencode/.apothem/support/ 配下の絶対ディレクトリを示します。 このドキュメントは最初の instructions エントリであるため、OpenCode はすべてのセッションでこれを読み込みます。

以前のリリースが書き込んだ opencode.json には、すべてのルールを読み込む単一のグロブ ~/.config/opencode/.apothem/support/rules/*.md、または当時常時適用だった 28 のルールそれぞれの明示的なパスが記載されています。 apothem install と apothem update はどちらの形式も上記のリストに置き換え、起動時にもはや読み込まれない 24 のパスを取り除きます。apothem uninstall はそれらすべてを削除します。 あなた自身の instructions エントリは、いずれの場合も保持されます。

検証

apothem verify --harness opencode

verify コマンドは次のことを確認します。

  1. ネイティブ設定が想定されたパスに存在すること。
  2. 管理対象の各ターゲットが存在すること。管理対象のファイルは空ではなく、JSON または YAML の設定は解析できること。--profile PATH を追加すると、インストールされたファイルがそのプロファイルと一致することも確認します。
  3. アダプター固有の検証ルーチンが成功を報告すること。

更新

apothem update --harness opencode

opencode.json、ネイティブコマンド、スキル、ヘルパー定義、Apothem サポートツリーを更新します。

アンインストール

apothem uninstall --harness opencode

アダプターが ~/.config/opencode/opencode.json に追加したエントリを削除します(あなた自身のキー、MCP サーバー、instructions エントリは残り、このファイルは、Apothem が作成したものであり、かつあなたのものが何も残っていない場合にのみ削除されます)。 プロファイルドキュメント ~/.config/opencode/apothem/rules/00-apothem-profile.md から Apothem のブロックを削除し、その中の他のテキストは残します。このファイルは、その中に他に何も残っていない場合にのみ削除されます。 また、~/.config/opencode/commands/、~/.config/opencode/skills/、~/.config/opencode/agents/、~/.config/opencode/.apothem/support/ 内の Apothem のファイルも削除します。これらのフォルダー内のその他のファイルは残ります。 各ファイルは、変更または削除される前に ~/.apothem/backups/ 配下にバックアップされます。 共有プロファイルの YAML と Apothem エンジンには影響しません。

コンフォーミティゲート

python -m apothem.conformity.gate --all .

トラブルシューティング

症状対処
設定ファイルが見つからないapothem install --harness opencode を再実行する
検証が失敗したapothem update --harness opencode を実行してから、再度検証する
想定外の設定内容~/.config/apothem/profile.yaml または --profile PATH を確認してから、apothem update --harness opencode を再実行する

設定ノブ

フラグデフォルト説明
--dry-runfalseファイルを書き込まずにインストールをプレビューする。

関連項目

On this page