Communitygithub.com

MrBinnacle/skill-harness

LLMスキル向けの句アブレーション差分テスト。スキルアーティファクトの各句が測定可能な方向性効果を生み出すかどうかを測定します。プリアルファ版。

skill-harness とは?

MrBinnacle/skill-harnessは、LLMエージェント向けスキルの各構成句(クローズ)が、スキルの出力に与える影響を測定するための差分テストツールです。アブレーション(除去)手法を用いて、スキルの各句を個別に除去した場合に、出力に統計的に有意な方向性の変化が生じるかを検証します。これにより、スキルデベロッパーは「どの句が実際に効果を発揮しているか」をデータドリブンに特定でき、不要な句の削除や重要な句の強化が可能になります。主にClaude CodeやCortex、ClineなどのLLMエージェントプラットフォームで使用されるスキルを対象としており、プリアルファ版ですが、スキルの品質管理や最適化に役立つ革新的なアプローチを提供します。動作にはスキルファイルのパスと評価用のテストケースが必要です。

対応~Claude Code~Codex CLI~Cursor
npx skills add MrBinnacle/skill-harness

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

skill-harness は何をしますか?

LLMスキル向けの句アブレーション差分テスト。スキルアーティファクトの各句が測定可能な方向性効果を生み出すかどうかを測定します。プリアルファ版。

概要

このツールは、スキルファイル内の各句(クローズ)を順次除去し、それぞれの除去がスキルの出力に統計的に有意な変化をもたらすかどうかをテストします。これにより、スキルの各構成要素が実際に機能しているかどうかを評価できます。

使用方法

python harness.py --skill <path_to_skill.md> --tests <path_to_test_cases.json>

引数

  • --skill: テスト対象のスキルファイル(Markdown形式)へのパス
  • --tests: テストケースを定義したJSONファイルへのパス

テストケース形式

テストケースはJSONファイルで指定します。各テストケースには、入力プロンプトと期待される出力の方向(positive/negative)を含める必要があります。

[
  {
    "prompt": "example prompt",
    "expected_direction": "positive"
  },
  {
    "prompt": "another prompt",
    "expected_direction": "negative"
  }
]

出力

各句のアブレーション結果が表示されます。結果には、句が除去された場合のスキルの出力変化と、その統計的有意性が含まれます。

注意事項

  • このツールはプリアルファ版です。機能は予告なく変更される可能性があります。
  • スキルファイル内のすべての句がテストされるわけではありません。一部の句(例えば、コードブロック内のコメント)は除外される場合があります。

ライセンス

MIT

関連スキル