
元記事: diagnosing-superpowersでセッションの作業ログを分析する(cccskills)
スキルのページ: diagnosing-superpowers
この記事の結論
superpowersを使っていて、作業の重複や計画からの逸脱、時間やトークンの使いすぎが気になった人に向けたスキルがdiagnosing-superpowersです。
セッションの記録を、行番号付きの報告書にまとめられます。
この記事では、調べられる7つの観点とインストール方法、依頼文の例を紹介します。
不具合報告に使うときの注意点も、あわせて取り上げました。
diagnosing-superpowersを入れると、superpowersを使ったセッションの経緯を報告書で受け取れます。
報告書には、記録ファイルの行番号が付く仕組みです。
たとえば、次のように頼みます。
さっきのセッションで、同じテストを何度も実行し直していた理由を記録から調べてください
エージェントはすぐには分析を始めず、質問を1つずつ返してきます。
確かめるのは、対象のセッション、期待していた結果、実際に起きたこと、気にしている指標の4点。
指標とは、経過時間やトークン、繰り返された操作などのことです。
問題が定まると、エージェントはセッションの記録ファイルを絶対パスで特定します。
過去のセッションなら、最初の依頼文とタイムスタンプを引用して対象を確認します。
候補から外したものも、理由を添えて示す決まりです。
続いて作業用のフォルダを作り、そのパスを伝えてきます。
~/.superpowers/diagnosing-superpowers/<セッションID>/
分析は7つの観点に分かれ、それぞれをサブエージェント(並行して動く補助のエージェント)が担当する仕組みです。
報告書はこのフォルダに書き出され、画面にも表示されます。
**指摘にはすべて「ファイルのパス:行番号」が付き、根拠の行がない指摘は報告から外されます。
**
このスキルを使うと、うまくいかなかったセッションを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が関わっていたかどうかまで。
スキルの欠陥を名指ししたり、変更を提案したりはしません。
修正を強く求めても、この線引きは変わらない決まりです。
ほかに確認しておきたい点は次のとおりです。
スクラブを通しても、消し漏れは起こりえます。
**共有する前には、バンドルのすべてのファイルを自分で確認してください。
**報告書についても、行番号を手がかりに元の記録を開き、引用された内容を自分で確かめると確実です。
ライセンスはMITです。
入れる前には、SKILL.mdと付属ファイルに外部への送信などの不審な処理がないかを確認してください。
同じobra/superpowersのスキルのうち、分析の対象になる作業そのものを担うものを紹介します。
executing-plansは、作成済みの実装計画を同じセッションでタスクごとに実行するスキルです。
計画から外れたと感じたら、このスキルで進めたセッションをdiagnosing-superpowersで振り返る流れになります。
subagent-driven-developmentは、計画のタスクを別のエージェントに任せて進めるスキルです。
サブエージェントの記録も分析の対象になるので、作業の重複や時間の使い方を確かめるときに組み合わせられます。
このスキルは、superpowersを使ったセッションがうまくいかなかったときのためのものです。
報告書も、superpowersの関わりを述べる構成になっています。
superpowersと関係のない作業の振り返りには向きません。
ありません。
記録ファイルは読むだけで、変更・移動・削除はしない決まりです。
報告書などの成果物は、専用の作業フォルダに書き出されます。
自動では投稿されません。
エージェントがissueの全文を見せ、承認を得てから作成します。
プレースホルダーが残ったままの文面で投稿することもありません。
教えてくれません。
報告するのは記録から確かめられた出来事までで、スキルの欠陥の特定や変更の提案は範囲外です。
superpowersを変えるかどうかは、issueやバンドルを受け取って仕分けする側が判断します。
diagnosing-superpowersは、superpowersを使ったセッションの経緯を、行番号付きの報告書にまとめるスキルです。
作業の重複や計画からの逸脱、時間やトークンの消費を記録から確かめられ、不具合報告の準備にも使えます。
ただし、投稿と共有用データの作成は承認を挟んで進む仕組みです。
詳しい情報はcccskillsのページで確認できます。
この記事は cccskills の読みもの「diagnosing-superpowersでセッションの作業ログを分析する」の転載です。
スキルの詳細とインストール方法は cccskills の diagnosing-superpowers のページ にあります。