gan-style-harness

gan-style-harness スキルの概要

gan-style-harness は、作業を Generator と厳格な Evaluator に分けるマルチエージェント型のワークフロースキルです。これにより、AIエージェントが自己満足に陥りにくく、弱点の少ない形でソフトウェアを構築・改善しやすくなります。見た目の洗練度、完成度、反復の規律を速度より重視し、ざっくりした製品アイデアをより高品質なアプリに仕上げたい人に特に向いています。

gan-style-harness は何のためのスキルか

gan-style-harness は、仕事が単なる「コードを書く」ではなく、「レビューに耐えるものを作る」場合に使います。このスキルは、フルアプリの作成、フロントエンド寄りの開発、そして一回のプロンプトではロジックの抜け、UIの粗さ、統合の詰め不足が残りやすいエージェント・オーケストレーション用途を想定しています。

通常のプロンプトと何が違うのか

一般的なプロンプトでは、1つのモデルに作成と評価の両方を担わせがちです。gan-style-harness はその役割を分ける点が、インストールする最大の理由です。実用上の利点は、より強い批評圧をかけられることです。Evaluator は、言い回しを守ったり、まず親切であろうとしたりする必要なく、弱い出力を却下できます。そのため、このワークフローは一発生成のプロンプトよりも、実運用を見据えた作業に向いています。

向いているケースと向かないケース

gan-style-harness の導入は、反復に耐えられて、ある程度規模のある構築でより強い成果を求める場合に向いています。一方で、小さな修正、厳しい予算、あるいは標準的なプロンプトや直接編集のほうが速い単純なリファクタリングには向きません。タスクが「1ファイルを変える」だけなら、このスキルは過剰です。

gan-style-harness スキルの使い方

インストールして、正しい情報源を確認する

Claude Code 環境に gan-style-harness スキルをインストールしたら、まず SKILL.md を読みます。このリポジトリには scripts/、resources/、rules/ のような補助フォルダがないため、主な案内はスキルファイル本体にまとまっています。つまり、gan-style-harness の使い始めでは、ワークフロー、制約、役割分担を SKILL.md から直接読み取る必要があります。

ハーネス用に入力を具体化する

このスキルは、「何かいいものを作って」よりも、具体的な構築対象を含むプロンプトで最もよく機能します。「より良いアプリを作って」のような曖昧な依頼ではなく、製品の種類、主要な操作、重要な制約、そして重視したい品質基準を入れてください。たとえば、「サブスクリプション分析向けのレスポンシブな管理ダッシュボードを作成し、アクセシビリティを優先し、モバイルでもグラフを見やすくし、コア指標を隠すレイアウトはEvaluatorが却下するようにしてほしい」といった具合です。こうしたブリーフなら、gan-style-harness が十分な構造を持って、意味のある作成と評価を行えます。

エージェント・オーケストレーション向けの推奨ワークフロー

gan-style-harness を Agent Orchestration で使う場合は、Generator を構築担当、Evaluator をゲートキーパーとして扱います。まず1段落の目的を示し、次に最初の実装を依頼し、そのあとで明示した要件だけをチェックする批評パスを挟み、最後に修正版を出します。これは「ベストエフォート」で頼むより効果的です。なぜなら、このスキルの価値は、出力を受け入れる前に Evaluator に欠陥をあぶり出させることにあるからです。

先に読むべきファイル

gan-style-harness ガイドが自分のスタックに合うかを判断したいなら、まず SKILL.md を読んでください。そのうえで、本文中の参照をたどり、アーキテクチャメモや使用例を確認します。このリポジトリは現時点では範囲が狭いため、重要なのは大きな支援ファイル群があるかどうかではなく、あなたのプロジェクトが敵対的な反復の恩恵を受けるかどうかです。

gan-style-harness スキルのFAQ

gan-style-harness は大規模プロジェクト専用ですか？

いいえ。大規模で重要度の高いタスクに最も有効ですが、本当の分かれ目は、速度よりレビュー品質が重要かどうかです。仕上がり感、一貫性、より厳しいチェックへの通過が必要なら、gan-style-harness は役立ちます。

通常のAIプロンプトとどう違いますか？

通常のプロンプトは、1つのモデルに生成と自己修正を任せることが多いです。gan-style-harness は、生成圧と評価圧をあえて分けて作るため、弱い前提、浅いUI判断、不完全な実装計画を見つけやすくなります。

gan-style-harness は初心者向けですか？

はい。タスクを明確に説明できるなら使いやすいです。望む成果と制約が分かっているほど、このスキルは扱いやすくなります。というのも、Evaluator が厳しくできるのは、実際に指定された内容だけだからです。初心者は、製品全体のビジョンではなく、まず1機能か1画面から始めるほうがよい結果を得やすいです。

どんなときに gan-style-harness を使わないべきですか？

すぐにパッチを当てたいとき、予算が非常に限られているとき、あるいは単純な編集だけで十分なときは避けてください。そのようなケースでは、gan-style-harness のオーバーヘッドは、直接的なプロンプトや手動変更ほどの価値を持ちません。

gan-style-harness スキルを改善する方法

Evaluator の合格基準をもっと鋭くする

品質を大きく上げるコツは、生成前に「良い」の定義を決めておくことです。gan-style-harness では、必要なページ、レスポンシブ挙動、アクセシビリティ要件、エラー状態、統合の境界など、測定可能または観察可能なチェック項目を含めてください。基準が明確であるほど、Evaluator は役に立つ存在になります。

どんな失敗を検出したいかを明示する

ハーネスに、何を却下すべきかを伝えてください。たとえば、ダミー文言、壊れたナビゲーション、コンポーネント状態の不整合、ローディング状態の欠如、見た目は洗練されているのに動かないUIなどです。gan-style-harness は、Evaluator にあなたが避けたい問題へ厳しく当たる権限があるときに最も改善効果が高まります。

最初からやり直すのではなく、批評を起点に反復する

最初のパスのあと、Evaluator の指摘を使ってコードだけでなくブリーフ自体も見直します。出力が製品スコープを外しているなら、次の gan-style-harness の反復では、「問題を直して」とだけ頼むのではなく、プロンプトと制約をより厳密にしてください。そうすることで、このスキルは同じ平凡な計画を繰り返すのではなく、改善が積み上がるようになります。