本文へ移動
cccskills
diagnosing-superpowers開発

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 編集部の方針に沿って推敲・公開しています。正確な仕様はスキルのページで原文を確認してください。

他の記事