skill-tester-ci について
skill-tester-ci は、リポジトリ内の CI スキルを検証するスキルです。仕様チェック、gh-aw ワークフローのコンパイル、構造と権限の確認を行い、スキルの変更や実リポジトリでの実行は行いません。
主な機能
- 01Anthropic 仕様の検証
- 02gh-aw ワークフロー例のコンパイル
- 03ワークフロー権限の確認
- 04スキルの構造と命名の検証
- 05ワークフロー呼び出し先の確認
活用シーン
- 01CI スキルの追加・変更後の確認
- 02gh-aw 更新後のワークフロー互換性検証
- 03プラグイン提出前の CI スキル確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pskoett/ pskoett-ai-skills --skill skill-tester-ciインストール後、Claude Code で/skill-tester-ciを入力して読み込まれたか確認します。
同梱ファイルscripts/run-tests.sh
詳細
スキルテスター CI
このリポジトリ内のすべての CI スキル(*-ci)を検証します。仕様の検証、gh-aw ワークフローのコンパイル、CI 固有の規約のチェックを実行します。
使用するタイミング
- CI スキルを追加または変更した後
gh-awを新しいバージョンにアップグレードした後(API の変更によりワークフローが動作しなくなることがあります)- CI スキルの変更をコミットする前
- プラグインを Anthropic のレビューに提出する前
前提条件
gh-awCLI がインストールされていること(gh extension install github/gh-aw)pyyamlがインストールされたpython3.claude/skills/skill-creator/scripts/にquick_validate.pyがあること
チェック項目
1. Anthropic 仕様の検証
すべての CI スキルに対して quick_validate.py を実行します。
for d in skills/*-ci/; do
python3 .claude/skills/skill-creator/scripts/quick_validate.py "$d"
done
2. ワークフロー例のコンパイル
各 CI スキルの references/workflow-example.md からワークフローブロックを抽出し、gh aw compile でコンパイルします。
# Extract markdown code blocks with frontmatter
# Copy to temp .github/workflows/
# Run: gh aw compile
合格基準: コンパイルエラーがゼロであること。警告は報告されますが、失敗にはなりません。
3. 権限のチェック
厳格モードの CI ワークフローでは、書き込み権限を直接使用してはいけません。以下を確認します。
issues: writeがないこと(代わりにsafe-outputs: add-commentを使用してください)pull-requests: writeがないこと(代わりにsafe-outputs: create-pull-request-review-commentを使用してください)- ワークフローがファイルを作成する場合(eval-creator の create モード)を除き、
contents: writeがないこと - 宣言されたツールセットに必要な読み取り権限が設定されていること
4. 構造のチェック
| チェック項目 | ルール | 重大度 |
|---|---|---|
references/workflow-example.md がある | すべての CI スキルに必須 | エラー |
| ワークフロー例にフロントマターブロックがある | --- を含む ```markdown ブロックが 1 つ以上ある | エラー |
| 名前がフォルダー名と一致する | フロントマターの name == ディレクトリ名 | エラー |
| 説明に gh-aw への言及がある | CI スキルでは gh-aw に言及する必要があります | 警告 |
| 対応するインタラクティブスキルがある | foo-ci には対応する foo が必要です | 警告 |
5. ワークフロー間の検証
call-workflow を使用するワークフローについて:
- 呼び出し先のワークフローが存在し、その
on:セクションにworkflow_callがあることを確認します - 呼び出し先の入力が呼び出し元から渡される内容と一致することを確認します
出力形式
## CI Skill Test Results
**Date:** YYYY-MM-DD
**gh-aw version:** vX.Y.Z
**Skills tested:** N
**Passed:** N
**Compile errors:** N
**Spec failures:** N
### Compilation Results
- [skill-name]: ✓ compiled (N KB) | ✗ error: [message]
### Spec Results
- [skill-name]: ✓ valid | ✗ [error]
### Permission Issues
- [skill-name]: [issue]
実行方法
手動で実行します:
/skill-tester-ci
または、スクリプトを直接実行します:
bash skills/skill-tester-ci/scripts/run-tests.sh
このスキルで行わないこと
- インタラクティブスキルはテストしません(それらには
skill-testerを使用してください) - 実際のリポジトリに対してワークフローを実行しません。コンパイルのみを行います
- スキルを変更しません。検出結果を報告するだけです
- ワークフローの実行時の動作はテストしません。コンパイルで検証するのは構造と権限のみです
コメント
Markdown 対応