skill-eval-scaffolder について
skill-eval-scaffolder は、リポジトリ内のスキル向けにスキーマ準拠の最小評価マニフェストを作成します。スキルテストを準備するメンテナー向けで、未承認の上書きやライブ評価の実行を防ぐルールがあります。
主な機能
- 01評価マニフェストの雛形作成
- 02既存マニフェストの検証
- 03プレビューと適用モード
- 04明示的呼び出しケースの必須化
活用シーン
- 01スキル評価マニフェストの初稿作成
- 02既存の評価ファイルの検証
- 03書き込み前の雛形プレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ wyattowalsh/ agents --skill skill-eval-scaffolderインストール後、Claude Code で/skill-eval-scaffolderを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
evals/evals.jsonscripts/check.pyscaffold_evals.pyscripts/asset_toolkit/validate_hooks.py詳細
Skill Eval Scaffolder
リポジトリのスキル用に、最小限でスキーマに準拠した評価マニフェストを作成します。
対象範囲: 評価の足場作りのみです。メンテナーが明示的に承認しない限り、実際の動作評価は実行しないでください。
ディスパッチ
| $ARGUMENTS | アクション |
|---|---|
<name> | skills/<name>/evals/evals.json の足場をプレビューします |
<name> --apply | ファイルが存在しない場合、またはユーザーが上書きを承認した場合に足場を書き込みます |
check <name> | 既存の評価マニフェストを検証します |
| 空 | 使用例ギャラリーとマニフェストのスキーマ概要を表示します |
ワークフロー
skills/<name>/SKILL.mdが存在することを確認します。- 同梱の足場作成スクリプトを実行します。
uv run python skills/skill-eval-scaffolder/scripts/scaffold_evals.py <name>
- 十分なカバレッジがあると主張する前に、明示的ケース、暗黙的ケース、ネガティブコントロールケースを追加します。
- 同梱のチェック用スクリプトで検証します。
マニフェストの形式
各 evals/evals.json には、以下を使用します。
skill_name— ディレクトリ名(ケバブケース)evals—id、prompt、expected_outputと、任意のfiles、assertionsを含む空でないケースのリスト
検証の要件
uv run python skills/skill-eval-scaffolder/scripts/check.py
重要なルール
- ユーザーの明示的な承認なしに、既存の評価マニフェストを上書きしないでください。
- 新しい足場には、少なくとも1つの明示的な呼び出しケースを含めてください。
- 足場の完成を宣言する前に、
validate_evals.pyを実行してください。 - 実際の評価の実行は、skill-creator の
evalモードまたはメンテナーの CI ワークフローに委ねてください。 - プロンプトは、スキルのディスパッチテーブルと「対象外」の境界に沿った内容にしてください。
コメント
Markdown 対応