
diagnosing-superpowersでセッションの作業ログを分析する
cccskills 編集部読了 約 10 分
この記事の結論
- こんな人に
- superpowersを使っていて、エージェントの作業の重複や計画逸脱、時間やトークンの使いすぎの原因を確かめたい人
- 入れると
- 「なぜ時間がかかったか」と頼むと、根拠の行番号付きで経緯をまとめた報告書が届く
- 作業の重複や計画逸脱、スキルが使われたかを、記憶ではなく記録で確かめられる
- superpowersへの不具合報告の文面を、似たissueの確認と承認を経て準備できる
- 向かない人
- superpowersを使っていない人や、スキルの欠陥の特定や修正案まで求めたい場面
superpowersを使っていて、作業の重複や計画からの逸脱、時間やトークンの使いすぎが気になった人に向けたスキルがdiagnosing-superpowersです。セッションの記録を、行番号付きの報告書にまとめられます。この記事では、調べられる7つの観点とインストール方法、依頼文の例を紹介します。不具合報告に使うときの注意点も、あわせて取り上げました。
目次
使うとこうなる
diagnosing-superpowersを入れると、superpowersを使ったセッションの経緯を報告書で受け取れます。報告書には、記録ファイルの行番号が付く仕組みです。たとえば、次のように頼みます。
さっきのセッションで、同じテストを何度も実行し直していた理由を記録から調べてください
エージェントはすぐには分析を始めず、質問を1つずつ返してきます。確かめるのは、対象のセッション、期待していた結果、実際に起きたこと、気にしている指標の4点。指標とは、経過時間やトークン、繰り返された操作などのことです。
問題が定まると、エージェントはセッションの記録ファイルを絶対パスで特定します。過去のセッションなら、最初の依頼文とタイムスタンプを引用して対象を確認します。候補から外したものも、理由を添えて示す決まりです。
続いて作業用のフォルダを作り、そのパスを伝えてきます。
~/.superpowers/diagnosing-superpowers/<セッションID>/
分析は7つの観点に分かれ、それぞれをサブエージェント(並行して動く補助のエージェント)が担当する仕組みです。報告書はこのフォルダに書き出され、画面にも表示されます。指摘にはすべて「ファイルのパス:行番号」が付き、根拠の行がない指摘は報告から外されます。
diagnosing-superpowersでできること
このスキルを使うと、うまくいかなかったセッションを7つの観点で洗い出し、何が起きたかを証拠付きで確かめられます。観点と調べる中身は次のとおりです。
| 観点 | 調べる中身 |
|---|---|
| スキルの使用状況 | どのスキルがいつ使われたか、使われなかったか |
| 計画への従い方 | 作成した計画どおりに作業が進んだか |
| 作業の重複 | 同じ作業を繰り返していないか |
| つまずき | 作業がつまずいた箇所 |
| 品質と根拠 | 結果の品質と、それを裏付ける記録 |
| 依頼との衝突 | 利用者の依頼と食い違う動き |
| 時間と消費量 | 経過時間とトークンの消費 |
7つの分析は、毎回すべて実行されます。不満の言い方によって変わるのは、エージェントが最初に自分で読む箇所と、結論で先に示す観点です。
| 不満の例 | 先に示す観点 |
|---|---|
| 時間がかかりすぎた | 時間と消費量、つまずき |
| なぜ余計な作業をしたのか | 作業の重複、計画への従い方 |
| なぜこんなに高くつくのか | 時間と消費量 |
| 実行中で何をしているか分からない | スキルの使用状況(実行中である旨も記載) |
| 計画を無視された | 計画への従い方(会話の圧縮が起きた行から確認) |
| 特定のスキルが動かなかった | スキルの使用状況 |
数字の扱いが厳密な点も特徴です。トークン数や時間は、すべて記録か、エージェントが実行したコマンドの結果から取ります。記憶や一般的な単価で補うことはありません。
分析の対象は、現在のセッションに限りません。IDやパスで指定した過去のセッションや、サブエージェントの記録も対象になります。
インストール方法
インストールは、コマンドで入れる方法とエージェントに頼む方法の2通りです。コマンドの場合は、次を実行してください。入れる先のエージェントは、実行後にClaude CodeやCodexなどから選べます。
npx skills add https://github.com/obra/superpowers --skill diagnosing-superpowers
エージェントに頼む場合は、次の文面をそのまま送ってください。中身の確認を先に済ませてから配置する流れです。
次の Agent Skill をインストールしてください。
https://github.com/obra/superpowers/tree/main/skills/diagnosing-superpowers
まず SKILL.md と付属ファイルの中身を確認し、不審な処理(外部への送信、認証情報の読み取りなど)がないことを確かめてから、Claude Code なら ~/.claude/skills/diagnosing-superpowers/、Codex なら ~/.agents/skills/diagnosing-superpowers/ に配置してください。
置き場所は次の表のとおり。すべてのプロジェクトで使うならユーザー単位に、特定のプロジェクトだけならプロジェクト単位に置きます。
| エージェント | ユーザー単位 | プロジェクト単位 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | .claude/skills/ |
| Codex | ~/.agents/skills/ | .agents/skills/ |
配布元はobra/superpowersです。このスキルが読むのはsuperpowersを使ったセッションの記録だけなので、分析したいセッションでsuperpowersを使っていたことが前提になります。
使い方の例
依頼は、対象のセッションと気になっている点をはっきり書くほど早く進みます。対象と調べる中身が決まっている依頼は、それ自体が問題の説明として扱われるためです。
昨日のセッション(ID: ○○)が想定より長くかかった理由を、時間とトークン消費を中心に調べてください
返ってくるのは、時間と消費量、つまずきの指摘を先頭に置いた報告書です。時間やトークンの数字には、記録のどの行から取ったかが添えられます。
このセッションでbrainstormingスキルが使われなかった経緯を、記録に基づいて報告してください
この場合の報告書は、スキルの使用状況が中心。どの時点でどのスキルが使われたかの経過が、行番号付きで示されます。
報告書をもとに、superpowersのGitHub issueの文案を作ってください
エージェントはまず、公開中と終了済みのissueから似た症状を探します。近いものがあればそのissueへの追記を提案し、なければ文面を作って全文を見せます。投稿するのは承認を得てからです。
不具合報告用に、セッションの記録をまとめた共有用データ(バンドル)も作れます。バンドルが作られるのは、頼んだときだけです。含める範囲は次の3段階から選べます。
| 段階 | 含まれる内容 |
|---|---|
| skeleton | ツール実行結果の本文を含まない |
| evidence | 報告で引用した箇所だけ本文を含む |
| full | すべて含む |
注意点
いちばん大切なのは、このスキルが原因を断定せず、修正案も出さない点です。報告書が述べるのは、superpowersが関わっていたかどうかまで。スキルの欠陥を名指ししたり、変更を提案したりはしません。修正を強く求めても、この線引きは変わらない決まりです。
ほかに確認しておきたい点は次のとおりです。
- セッションの記録ファイルは読むだけで、変更・移動・削除はしません。
- 分析を始める前に必ず質問が来ます。席を外していると、質問を書き出したところで止まります。
- 分析には複数のサブエージェントを並行して使います。
- issueの投稿にはGitHubのコマンドラインツール
ghを使います。ghではファイルを添付できないため、バンドルはブラウザから自分で添付します。 - バンドルは、機密情報の除去(スクラブ)と点検を繰り返して作られます。アーカイブを作るのは承認を得てからです。
スクラブを通しても、消し漏れは起こりえます。**共有する前には、バンドルのすべてのファイルを自分で確認してください。**報告書についても、行番号を手がかりに元の記録を開き、引用された内容を自分で確かめると確実です。
ライセンスはMITです。入れる前には、SKILL.mdと付属ファイルに外部への送信などの不審な処理がないかを確認してください。
関連スキル
同じobra/superpowersのスキルのうち、分析の対象になる作業そのものを担うものを紹介します。
executing-plansは、作成済みの実装計画を同じセッションでタスクごとに実行するスキルです。計画から外れたと感じたら、このスキルで進めたセッションをdiagnosing-superpowersで振り返る流れになります。
subagent-driven-developmentは、計画のタスクを別のエージェントに任せて進めるスキルです。サブエージェントの記録も分析の対象になるので、作業の重複や時間の使い方を確かめるときに組み合わせられます。
まとめ
diagnosing-superpowersは、superpowersを使ったセッションの経緯を、行番号付きの報告書にまとめるスキルです。作業の重複や計画からの逸脱、時間やトークンの消費を記録から確かめられ、不具合報告の準備にも使えます。ただし、投稿と共有用データの作成は承認を挟んで進む仕組みです。詳しい情報はcccskillsのページで確認できます。
よくある質問
- superpowersを使っていないセッションも分析できますか
- このスキルは、superpowersを使ったセッションがうまくいかなかったときのためのものです。報告書も、superpowersの関わりを述べる構成になっています。superpowersと関係のない作業の振り返りには向きません。
- 元のセッション記録が書き換えられることはありますか
- ありません。記録ファイルは読むだけで、変更・移動・削除はしない決まりです。報告書などの成果物は、専用の作業フォルダに書き出されます。
- issueは自動で投稿されますか
- 自動では投稿されません。エージェントがissueの全文を見せ、承認を得てから作成します。プレースホルダーが残ったままの文面で投稿することもありません。
- 不具合の原因や直し方まで教えてくれますか
- 教えてくれません。報告するのは記録から確かめられた出来事までで、スキルの欠陥の特定や変更の提案は範囲外です。superpowersを変えるかどうかは、issueやバンドルを受け取って仕分けする側が判断します。
このスキルを試す
diagnosing-superpowers の入れ方とインストールコマンドは、cccskills のスキルページにまとめてあります。
この記事は、公開されている SKILL.md と cccskills の紹介文をもとに AI(Claude)が下書きし、cccskills 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。
他の記事

OpenClawでチャットや課題一覧を差分取り込み knowledge-source-ingest
OpenClawでチャットや課題一覧をKnowledgeへ定期的に取り込む人向けのスキルを紹介します。取得範囲とスナップショットを記録し、前回との差分から追加・変更・削除を確かめて反映する手順と導入方法をまとめました。
knowledge-source-ingestopenclaw

NodeからBunへの移行をbun-runtimeスキルでエージェントに任せる
bun-runtimeスキルを入れると、Claude CodeやCodexがBunで実行・依存管理・ビルド・bun testを進めます。Nodeからの移行手順、Vercelの設定、インストール方法、依頼文の例、互換性の注意点を紹介します。
bun-runtimeaffaan-m

逆コンパイルとバイナリ解析にreverse-engineer-anything
reverse-engineer-anythingは、REAで配布済みアプリやバイナリ、ASAR、APK、ファームウェアを解析するスキルです。機能の仕組みや版ごとの違いを、根拠と不明点に分けて説明してもらえます。導入手順と注意点も紹介します。
reverse-engineer-anythingmorluto