症状：Agent SkillsとSuperpowersのどちらを採用すべきか迷っている。
最短解：技能を持ち運ぶための形式が必要ならAgent Skills、開発工程まで整えたいならSuperpowersを選びます。両方が必要な場合は併用し、使うハーネスごとに読み込みとツール実行を検証してください。
複数のAIコーディングツール間で技能を移したい開発者は、形式の互換性と導入境界を確認できます。
チームの開発手順をそろえたい責任者は、技能の入れ物と工程の実装を切り分けて選べます。
長時間動かす開発環境も検討中なら、プロジェクトの分離や環境維持の条件まで判断できます。
最終更新：2026年9月25日。確認対象はAgent Skillsの仕様、Superpowersの公式リポジトリ、公式の移植資料です。互換性はハーネスごとの公式案内で確かめ、特定環境での動作を全環境へ一般化しないでください。
Superpowers vs Agent Skillsを役割の違いから整理する
Agent Skillsは、再利用可能な指示や関連リソースを技能としてまとめる形式です。仕様では技能の入口となるSKILL.mdと、必須メタデータのname、descriptionが定められています。スクリプトや参照資料などを含められますが、この形式自体が開発工程を実行するわけではありません。仕様の必須項目と構成を確認すると、まず「技能をどう記述し、配置するか」の規約だと分かります。
一方、Superpowersはソフトウェア開発に向けた技能群と進行方法をまとめた実装です。公式説明では、アイデアの整理から計画、実装、レビューへと作業を進める流れが示されています。公式ワークフローの説明やリポジトリを根拠に、Agent Skillsと同じ「形式の候補」としてではなく、形式を利用する「開発手順の候補」として評価してください。
- Agent Skillsの利点： 指示と補助資料をまとめて再利用しやすく、技能単位で管理できます。
- Agent Skillsの注意点： 形式が読めても、ハーネスが技能を発見するか、必要なツールを実行できるかは別問題です。
- Superpowersの利点： 要件の検討や計画、テスト、レビューを開発の流れとして組み込みやすくなります。
- Superpowersの注意点： 提供された手順があっても、各工程の実行可否はエージェントやハーネスの機能に依存します。
移植性はファイル形式だけで判断しない
技能のディレクトリにSKILL.mdがあることは、技能の構造を確認する手掛かりになります。しかし、配置先、発見の仕組み、メタデータの扱い、スクリプトの実行権限は、ハーネスごとに確認が必要です。仕様に沿ったファイルがあるというだけで、すべてのツールが自動的に読み込むと考えないでください。
Superpowersの公式資料には、別のハーネスへの移植を扱う移植ガイドがあります。ここから分かるのは、移植時に環境固有の対応を検討する必要があることです。特定のハーネスで動作した記録は、その組み合わせでの確認結果として扱い、未確認の環境まで「互換」とは結論づけないでください。
運用上は、技能本体に加えて、参照ファイルやスクリプトの依存関係、利用するツール権限も確認します。ファイルが検出されても、スクリプトの実行が制限されていたり、参照資料が想定した場所に存在しなかったりすれば、手順は途中で止まる可能性があります。これは仕様上の互換性と、実行環境での動作確認を別々に扱うべき理由です。
注意：技能の読み込み表示だけで完了と判断しないでください。指示が応答に反映され、必要なツールが呼び出され、成果物まで作られるかを個別に確かめます。
開発工程のカバー範囲を公式手順で比べる
Agent Skillsは、特定の技能に必要な説明や資料を運ぶための枠組みです。チーム独自の規約を技能にまとめることはできますが、仕様だけから要件整理、テスト、レビューの順序が保証されるとは言えません。ワークフローの定義は、技能の作成者と、それを実行するエージェント側に委ねられます。
Superpowersでは、たとえばブレインストーミング技能が実装前の設計検討を扱い、計画技能が作業計画を扱います。テスト駆動開発の説明で使われる「失敗するテストを書く、通る実装を行う、整理する」という流れは、三段階の反復として確認できます。公式のワークフロー説明を読み、チームが必要とする工程が含まれているかを照合してください。
ただし、工程の指示と実行能力は別です。エージェントがリポジトリを読めてもテストを実行できないなら、テスト駆動の手順を最後まで完了できません。子エージェントへの作業分担やコードレビューも、利用環境のツール、権限、実行結果を確認して初めて運用可能と判断できます。
チーム導入では更新と権限を先に管理する
チームで使う場合は、技能の出所と変更内容を記録し、更新前に差分を確認してください。Superpowersの公式リリース履歴を参照し、更新後は対象ハーネスで代表的な作業を再実行します。バージョンを固定するか、更新を自動で取り込むかは、変更を検査できる体制とリスク許容度で決めます。
技能が指示するコマンドやスクリプトは、内容を確認してから権限を与えます。特に、ファイル変更、外部サービスへの接続、認証情報へのアクセスが必要な作業では、技能の出所を確認し、必要最小限の権限に限定してください。公式仕様への準拠は、技能の提供元が信頼できることや、実行内容が安全であることの保証ではありません。
個人開発なら、既存のハーネスで技能の配置と実行が確認でき、独自の工程を追加したい場合はAgent Skillsから始められます。チームで設計からレビューまでを一定の手順にそろえたいなら、Superpowersの工程を小さな対象プロジェクトで評価します。複数ハーネスを使う場合は、共有する技能と環境固有の導入手順を分けて管理してください。
条件分岐で採用方法を決める
次の項目を上から確認し、該当する選択肢を採用してください。
- [ ] 技能の指示や参照資料を複数の環境で再利用したい場合は、Agent Skillsを選び、ハーネスごとの読み込み手順を確認します。
- [ ] 要件整理、計画、テスト、レビューの手順まで整えたい場合は、Superpowersを評価し、各工程で必要なツールが使えるかを確かめます。
- [ ] 共通の技能形式と一貫した開発手順の両方が必要な場合は、併用します。ただし、技能の読み込みとワークフローの完了は別々に検証します。
- [ ] 使うハーネスの公式な導入方法が確認できない、または必要なツール権限が得られない場合は、全社展開を保留し、確認済みの環境に限定します。
小さな作業で読み込みと実行を確かめる
本番のリポジトリに広げる前に、変更範囲を限定した検証用プロジェクトで次の手順を進めます。
- 対象のハーネスを決め、公式の技能読み込み方法とSuperpowersの移植案内を照合します。未対応と明記された経路や独自作業が必要な箇所は、展開対象から分けます。
- 技能の配置先、
SKILL.mdのメタデータ、参照ファイル、スクリプトの依存関係を確認します。技能の取得元と更新方法も記録します。 - 技能固有の判断手順を使う、小規模で安全な開発依頼を用意します。単に技能名を答えさせるのではなく、指示内容が実際の作業に反映される依頼にします。
- 実行ログや成果物を確認し、技能が発見されたか、必要なツールが呼び出されたかを確かめます。テストを指示する場合は、テスト結果そのものも確認します。
- 変更内容とレビュー結果を人が点検します。読み込みだけ成功しても、テスト未実行やレビュー省略があれば、ワークフローが成立したとは判定しません。
- 同じ確認を使うハーネスごとに行い、検証済みの組み合わせだけをチームの対応範囲として記録します。
この確認方法は、公式資料にある対応範囲の主張ではなく、導入時の実務上の検証手順です。結果は「どのハーネスで、どの技能が、どの権限で、どこまで動いたか」に分けて残すと、後日の更新時にも再確認しやすくなります。
開発環境も含めて選ぶ
ローカル環境だけで十分な小規模作業なら、まず手元のハーネスで検証するのが合理的です。一方、環境構築の繰り返し、プロジェクト間の依存関係の混在、長時間作業後の状態管理が負担になるなら、ローカル運用だけでは分離や保守に手間がかかります。クラウド環境にも、接続設定や権限管理、利用環境の維持という確認事項があります。
AIプログラミング環境をMac上で分けて運用する選択肢を調べる場合は、Macstripeの案内で利用環境を確認し、導入前にヘルプセンターで運用上の疑問を整理してください。短期間の検証や、チームで使う前の隔離環境が必要ならMacstripeのレンタルMacも比較対象になりますが、長期にわたり常時稼働する負荷や物理接続が必要な作業では、自社所有のMacのほうが適する場合があります。環境を選ぶ前に、採用するハーネスの対応状況とプロジェクト分離の要件を照合してください。
