skill-arbiter は何をしますか?
Codexスキルを承認または隔離し、rg.exeの過剰なCPU使用(チャーン)を検出して大規模リポジトリでのCPUスラッシュを防止します。
概要
このスキルは、Codexエージェントの実行中にrg.exeプロセスが異常にCPUリソースを消費する状況(チャーン)を検出します。大規模なリポジトリでは、ripgrepなどの検索ツールが繰り返し実行されることでCPUスラッシュが発生し、システム全体のパフォーマンスが低下することがあります。本スキルはそのような問題を未然に防ぐために設計されています。
動作の仕組み
- 監視: Codexエージェントがスキルを実行する際、
rg.exeのCPU使用率を継続的に監視します。 - 検出: 一定のしきい値を超えるCPU使用率が一定時間継続した場合、それを「チャーン」として検出します。
- 隔離: 問題のあるスキルを一時的に隔離(無効化)し、それ以上リソースを消費しないようにします。
- 承認: 問題が解決したと判断された場合、スキルを再度承認(有効化)します。
対応プラットフォーム
- Codex: Codexエージェント上で動作し、
rg.exeのプロセス監視とスキルの管理を行います。
インストール
# 例: Codex CLIでスキルを追加する場合
codex skills add grtninja/skill-arbiter
設定
環境変数または設定ファイルで以下のパラメータを調整できます。
ARBITER_CPU_THRESHOLD: CPU使用率のしきい値(デフォルト: 80%)ARBITER_DURATION: チャーンと判定するための継続時間(秒)(デフォルト: 30)ARBITER_LOG_LEVEL: ログレベル(info, warn, debugなど)
使用方法
スキルがインストールされると、自動的に監視が開始されます。手動で操作する必要はありません。
# 隔離されたスキルの一覧を表示
codex arbiter list
# 特定のスキルを手動で承認
codex arbiter approve <skill-name>
# 特定のスキルを手動で隔離
codex arbiter quarantine <skill-name>
注意事項
- このスキルは、
rg.exeプロセスが実行されている環境でのみ効果を発揮します。 - CPUスラッシュが発生する原因は必ずしも
rg.exeだけではないため、他のプロセスにも注意が必要です。 - 隔離されたスキルは、手動で承認するまで自動的には再有効化されません。
ライセンス
このスキルはMITライセンスの下で提供されます。