ultraqa について
ultraqaは、テスト、ビルド、lint、型チェック、レビューの通過を目指す開発者向けのQAスキルです。失敗の証拠を保全し、小さな修正を加えて最大5回検証を繰り返します。
主な機能
- 01依頼を主要なQA目標に分類
- 02検証を実行し失敗の証拠を保全
- 03原因を診断して小さく修正
- 04最大5サイクルまで再検証
- 05必要に応じて関連スキルへ引き継ぎ
活用シーン
- 01失敗したテストスイートの修正
- 02ビルド、lint、型チェックの通過
- 03正確性、セキュリティ、性能、UIのレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ akillness/ jeo-skills --skill ultraqaインストール後、Claude Code で/ultraqaを入力して読み込まれたか確認します。
同梱ファイルevals/evals.jsonSKILL.toon
詳細
UltraQA
$ultraqa には、この正確な名前のスキルを使用します。ユーザーが $ultaqa と入力した場合は、$ultraqa の誤入力として扱い、同じ QA 契約を適用して続行します。
このスキルを使用する場合
- ユーザーが
$ultraqa、$ultaqa、またはultraqaを明示的に呼び出した場合。 - テスト、ビルド、Lint、型チェック、またはレビューのゲートを通過させるタスクの場合。
- ユーザーが、診断、修正、再実行を繰り返す品質改善ループを求めている場合。
指示
QA の目標を 1 つ解析し、該当する検証を実行して、失敗の証拠を保持し、最小限の修正を適用して、成功するかブロッカーに達するまで繰り返します。
目標の解析
リクエストを、次の主要な QA 目標のいずれかに対応付けます。
tests:テストスイートが成功するbuild:ビルドが正常に終了するlint:Lint が正常に終了するtypecheck:型チェッカーが正常に終了するreview:正確性、セキュリティ、パフォーマンス、または UI に関する並列レビューcustom:ユーザーが指定した成功条件
サイクル
最大 5 サイクルまで繰り返します。
- 該当する検証コマンドを実行します。
- 成功した場合は、停止して成功したコマンドを報告します。
- 失敗した場合は、失敗の証拠を保持します。
- 根本原因として考えられるものを診断します。
- 最小限の修正を適用します。
- 検証を再実行します。
新たな証拠がないまま同じ失敗が 3 回繰り返された場合は、早めに停止します。
コマンドの確認
package.json、Makefile、プロジェクトのドキュメント、CI 設定、または既存のスクリプトにある、リポジトリ標準のコマンドを優先します。リポジトリに明確なコマンドがある場合は、テストコマンドを独自に作らないでください。
他のスキルへの振り分け
- 主な作業が独立した実装レーンの場合は、
ultraworkを使用します。 - ランタイムワーカーの連携には、
teamを使用します。 - 編集を伴わないレビュー結果だけが必要な場合は、
code-reviewを使用します。
例
$ultraqa --tests$ultaqa make lint and typecheck pass
ベストプラクティス
- リポジトリ標準の検証コマンドを使用します。
- 新たな証拠がないまま同じ失敗が 3 回続いたら停止します。
- 最後に成功したコマンドを正確に報告します。
参考資料
- ゲート設計に関するポリシーレベルの指針については、
testing-strategiesを参照してください。 - レビューのみを行う場合は、
code-reviewを参照してください。
コメント
Markdown 対応