mcpField
H
honey-superpowers

honey-superpowers

github.com/green-ptエージェントワークフロー34437 回インストール1 週間前に更新
リポジトリ

honey-superpowers について

honey-superpowersは、Superpowersのワークフローで、隔離されたサブエージェントへの指示にHoneyのルールを加えるためのスキルです。作業担当者とレビュアーで指示を分け、検証やエラー処理、レビュー判断を省略しないよう定めています。

主な機能

  1. 01サブエージェントへの指示追加
  2. 02作業担当者とレビュアーのルール分離
  3. 03Claude Codeフックによる自動挿入に対応
  4. 04所見を抑えず簡潔な報告を指示
  5. 05検証や安全面の例外事項を明示

活用シーン

  1. 01Superpowersのワークフローで実装タスクを割り当てる
  2. 02複数領域の作業を並行委任する
  3. 03差分レビューや修正を依頼する

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/green-pt/honey-for-devs --skill honey-superpowers

インストール後、Claude Code で/honey-superpowersを入力して読み込まれたか確認します。

詳細

Honey × Superpowers

Honey はセッションの SessionStart フックによって有効になります。このフックはあなた(オーケストレーター)のコンテキスト内にあります。Superpowers はコンテキストが分離された新しいサブエージェントをディスパッチしますが、サブエージェントがこのフックを引き継ぐことはありません。そのため、すべての実装担当者、レビュアー、修正担当者はHoney が無効な状態で実行されます。つまり、コードはフルサイズ(レバー 1 が無効)、レポートは冗長(レバー 2 が無効)となり、それがディスパッチごとに発生します。これが漏れの原因です。ディスパッチプロンプト自体に指示を貼り付けて防ぎましょう。

この 2 つのスキルは、タスクごとに安価なモデルを使い、テキストの貼り付けではなくファイルで引き継ぎ、説明を 1 行にするという点で、すでに Honey と同じ方向にコストを削減します。これらに逆らわず、その上に積み重ねましょう。 Honey は、これらのスキルにないものを補います。ワーカーのコードを減らし、双方のレポートを簡潔にします。

起動するタイミング

Superpowers 形式のワークフローでサブエージェントをディスパッチする直前に、いつでも実行します。

  • subagent-driven-development — タスクごとの実装担当者/タスクレビュアー/修正担当者
  • dispatching-parallel-agents — 独立したドメインごとに 1 つのエージェント
  • executing-plans — 並列セッションでの実行
  • その他、コンテキストが分離されたオーケストレーターからワーカーへの引き継ぎ

注入する内容

Honey プラグインを使用する Claude Code では、貼り付けは不要です。プラグインの SubagentStart フック(hooks/honey-subagent.js) が、生成されたすべてのサブエージェントに該当する指示を自動的に注入します (レビュアー向けのエージェントタイプには、レビュアー用の指示が注入されます)。以下のブロックは、 他のハーネスを使用する場合、またはフックがインストールされていない場合に使います。

該当するブロックをディスパッチプロンプトの本文に貼り付けます。スキルの呼び出しではなく、インラインテキストとして貼り付けてください(呼び出しには 1 往復かかりますが、サブエージェントに必要なのはルールだけです)。

ワーカー/実装担当者/修正担当者/並列ドメイン担当エージェント:

Apply Honey: write the minimum code that needs to exist — YAGNI, stdlib/native
before custom; no speculative params, branches, or single-caller abstractions.
Never cut validation, error handling, auth, or anything the task asked for.
Keep code, identifiers, paths, and the brief's exact spec values verbatim.
Report terse: status, commits, one-line test summary, concerns. No narration.

レビュアー:

Report findings tersely: id · severity · file:line · one-line fix. Don't narrate
or restate the diff. Honey governs your prose only — never your verdict or
severity. Flag everything you normally would; raise false positives for the
controller to adjudicate. Do not suppress or downgrade a finding to save words.

レビュアー用の指示が異なる理由

レバー 1(コードを減らす)とレバー 2(文章を減らす)は、ワーカーが出力する内容を圧縮します。一方、レビュアーが出すのは判断です。文章は圧縮しても、判定は決して圧縮しません。これは、Superpowers の厳格なルール(「レビュアーに、何を指摘しないようにとは決して伝えない」)と、Honey 自身の安全性に関する例外規定(要求された内容は正確に保持し、認証/金銭/マイグレーション/削除は明確に記述する)に合致します。レビューを簡潔にするのは問題ありませんが、レビューの質を落とすのは後退です。

例外事項(Honey の規定を引き継ぐ)

どのバリアントでも、次の内容を決して省略しないでください。信頼境界での入力検証、データ損失を防ぐエラー処理、認証/エスケープ処理/シークレット、アクセシビリティの基本事項、そしてタスクまたは計画で明示的に必須とされた内容です。仕様値(数値、マジックストリング、シグネチャ、テストケース)はそのまま保持します。これはレバー 2 の「正確に保持する」という規則であり、ブリーフが唯一の信頼できる情報源であることも示しています。

Honey でもここでは削減できないもの

Superpowers がコンテキストに読み込むスキルのプロンプトは、すでにコストを支払っている入力トークンです。Honey でも、それをさらに圧縮することはできません。これらのスキルは必要に応じて読み込まれるため、起動されたスキルだけがコストになります。実際に大きな節約になるのは、タスクごとに安価なモデルを使うルール(これは Superpowers 自身のルールです。省略しないでください)と、ディスパッチされるすべてのサブエージェントに Honey を適用することです。

コメント