evaluator-optimizer について
evaluator-optimizer は、既存のコード、ドキュメント、設計を反復的に改善するスキルです。評価スコアに基づく確認と修正を繰り返し、定められた条件で成果をまとめます。
主な機能
- 015つの品質基準による評価
- 02スコアに応じた停止・修正判断
- 03指摘に沿った修正と変更概要
- 04各改善を確認する反復ループ
活用シーン
- 01コードの草案の仕上げ
- 02ドキュメントの明瞭さと正確性の向上
- 03設計やアーキテクチャ提案の改善
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ nickcrew/ claude-cortex --skill evaluator-optimizerインストール後、Claude Code で/evaluator-optimizerを入力して読み込まれたか確認します。
同梱ファイルreferences/evaluation-criteria.md
詳細
Evaluator-Optimizer
既存のコード、ドキュメント、設計を、厳密な評価と改善のサイクルを通じて洗練し、本番品質の基準を満たすまで磨き上げる反復型ワークフローです。
このスキルを使用する場面
- コードの粗い初稿を本番品質に仕上げる場合
- 明確さ、完全性、正確性を高めるためにドキュメントを磨く場合
- 設計やアーキテクチャの提案を反復的に改善する場合
- 「これで十分」では済ませられない、体系的な品質向上が必要な場合
- 構造化された反復を通じて高品質な成果に到達したい場合
クイックリファレンス
| タスク | 参照資料を読み込む |
|---|---|
| 評価基準と品質評価基準 | skills/evaluator-optimizer/references/evaluation-criteria.md |
ワークフロー:ループ
任意の成果物(コード、テキスト、設計)について、次の手順に従います。
- 受け取る:成果物の現在のバージョンを受け取ります。
- 評価する:厳しい批評家として評価します。正確性、明確さ、効率性、スタイル、安全性を採点し、100 点満点でスコアを付けます。
- 判断する:
- スコア >= 90:停止し、結果を提示します。
- スコア < 90:改善します。
- 改善する:手順 2 の批評に具体的に対処するよう、成果物を書き直します。変更点とその理由を列挙します。
- 繰り返す:新しいバージョンで手順 2 に戻ります。
動作ルール
- 妥協しない:「これで十分」では不十分です。成果物を磨き上げることが目的です。
- 具体的にする:評価時には、具体的な欠点を列挙します。「関数
process_dataは O(n^2) ですが、O(n) にできます。」 - 作業内容を示す:各反復での変更内容を要約します。
- 自己修正する:改善によって何かが壊れた場合は、元に戻して別の方法を試します。
- 収束させる:各反復でスコアを向上させる必要があります。連続する 2 回の反復でスコアが向上しなかった場合は停止し、最良のバージョンを提示します。
反復出力テンプレート
## Iteration [N] Evaluation
| Criterion | Score (1-10) | Notes |
|-----------|-------------|-------|
| Correctness | | |
| Clarity | | |
| Efficiency | | |
| Style | | |
| Safety | | |
| **Total** | **/50** | **[x100/50]** |
### Issues Found
1. [Specific issue with location]
2. [Specific issue with location]
### Refinements Applied
- [Change 1 and rationale]
- [Change 2 and rationale]
やり取りの例
入力:「この Python スクリプトを改善してください。」
反復 1 の評価:
- 機能:良好
- 効率性:不十分 - 照合に入れ子のループを使用しています
- スタイル:変数名
aとbが分かりにくいです - スコア:60/100
適用した改善:
- セットによる検索を使ってループをフラット化しました(O(n))
aをusersに、bをactive_idsに変更しました- 型ヒントを追加しました
反復 2 の評価:
- 機能:良好
- 効率性:優秀
- スタイル:良好
- スコア:95/100
結果:改善したスクリプトを提示します。
コメント
Markdown 対応