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

Qwen Code

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

ベンダー: Alibaba Cloud インストール名: qwen-code ステータス: ベータ版 ネイティブ設定: ~/.qwen/

インストール

apothem install --harness qwen-code

アダプターは Qwen Code の設定を書き込み、QWEN.md コンテキストアンカーをインストールし、Apothem のフックディスパッチャーを登録し、Apothem のコマンドを Qwen の Markdown コマンドファイルに変換し、スキルを SKILL.md ディレクトリとしてインストールし、ヘルパー定義を Qwen のサブエージェントとして適合させます。

書き込まれるファイル:

~/.qwen/settings.json
~/.qwen/QWEN.md
~/.qwen/apothem/rules/00-apothem-profile.md
~/.qwen/commands/
~/.qwen/skills/
~/.qwen/agents/
~/.qwen/.apothem/support/{rules,templates,hooks}/

ファイル ~/.qwen/apothem/rules/00-apothem-profile.md はプロファイルドキュメントです。 共有プロファイルに由来するあなたのアイデンティティとプリファレンスを保持します。

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

アダプターは、コンテキストとフック向けに文書化された settings.json のキーをレンダリングし、QWEN.md を書き込み、Apothem のコマンド、スキル、ヘルパー定義を Qwen Code のネイティブな検出ディレクトリに組み込みます。 ルール、テンプレート、フックのソース素材は、~/.qwen/.apothem/support/ 配下のサポート素材として残ります。

互換性に関する注意

~/.qwen/.apothem/support/ は、QWEN.md と設定のフックコマンドから参照されるサポート素材であり、ベンダー所有の検出名前空間ではありません。 QWEN.md 内の Apothem ブロックは Apothem サポートファイルのセクションで終わります。 このセクションは、リポジトリ形式の各参照(rules/<name>.md、templates/...、hooks/...)が解決される先の、~/.qwen/.apothem/support/ 配下の絶対ディレクトリを示します。

スキルのツールリスト。 Qwen Code は、スキルのツール許可リストをキャメルケースの allowedTools フロントマターキーから読み取り、その値は YAML のリストでなければなりません。 他のエージェント向けに書き込まれるハイフン付きの allowed-tools キーは無視します。 そのため、インストールされたスキルは、ソースコーパスのカンマ区切りの allowed-tools 文字列の代わりに、1 行に 1 エントリーのリストとして allowedTools を持ちます。 各エントリーは、Bash(git status *) のようなパターンも含め、ソースの綴りを保ちます。 スキルの他のすべてのキーとスキル本文は、変更されずにインストールされます。

スキルフォルダー。 アダプターはスキルを ~/.qwen/skills/ に書き込みます。 Qwen Code は ~/.agents/skills/ も読み、プロジェクト内では .qwen/skills/ と .agents/skills/ も読みます。 2 つのフォルダーが同じ名前のスキルを保持している場合は .qwen 配下のものが優先されるため、~/.qwen/skills/ 内の Apothem のスキルは、別のアダプターが ~/.agents/skills/ に書き込んだ同名のスキルより優先されます。

フックイベント。 アダプターは SessionStart、PreToolUse、PreCompact、PostCompact、Stop を接続します。 Qwen Code は 22 のフックイベントを定義しており、これら 5 つはいずれもその 1 つです。 22 のうち 3 つ(SessionDelete、TodoCreated、TodoCompleted)には同じ名前の Claude Code のイベントがありません(Claude Code は todo イベントを TaskCreated と TaskCompleted と名付けています)。アダプターはそれらのいずれも接続しません。

検証

apothem verify --harness qwen-code

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

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

更新

apothem update --harness qwen-code

settings.json、QWEN.md、ネイティブコマンド、スキル、サブエージェント、Apothem サポートツリーを更新します。

アンインストール

apothem uninstall --harness qwen-code

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

コンフォーミティゲート

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

トラブルシューティング

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

設定ノブ

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

関連項目

On this page