mcpField
S
skill-recap

skill-recap

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

skill-recap について

skill-recapは、エージェントのセッションを調べ、スキルが作業に役立った点や妨げた点を評価します。根拠に基づく所見と結論をまとめ、自分や他者のリポジトリにあるスキルの検証に使えます。

主な機能

  1. 01セッションとサブエージェントの記録確認
  2. 02スキルの利用状況と不足の評価
  3. 03根拠に基づく所見の整理
  4. 04結論とスキル改善案の提示

活用シーン

  1. 01完了したエージェントセッションの振り返り
  2. 02遅延や誤りにつながったスキルの特定
  3. 03反復作業に必要なスキルの不足確認

インストール

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

$npx skills add https://github.com/yahyabedirhan/skills --skill skill-recap

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

同梱ファイルagents/openai.yaml

詳細

スキルの振り返り

1つ以上のセッションを振り返り、エージェントとそのサブエージェントがスキルをどのように活用したかを整理します。スキルが役立った場面と、スキルがなかった、または不足していたためにセッションにコストが生じた場面を確認します。振り返りの最後に、トランスクリプトの証拠で裏付けられた所見と、判定を記載してください。

パラメーター

  • <skills-repo>：GitHub 上にあるユーザー自身のスキルリポジトリ。owner/repo の形式です。

1. セッションを選択する

  • デフォルトでは、現在のセッションと、そこから起動されたすべての階層のサブエージェントを対象にします。現在のセッションはコンテキスト内にあります。サブエージェントは独自のコンテキストで実行されるため、ディスク上のトランスクリプトを読み取ってください。
    • セッションの一部が圧縮されている場合： 欠落した部分のトランスクリプトを読み取ってください。
  • ユーザーが期間、プロジェクト、セッションのリストなどの範囲を指定した場合は、サブエージェントも含め、その範囲だけを対象にします。
    • **範囲の解釈が複数ある場合は、**プロジェクトと期間の対応などを読み取る前に確認してください。
トランスクリプトの保存場所

Claude Code は、以下のような構成で、1行につき1つの JSON オブジェクトを含むファイルとしてトランスクリプトを保存します。バージョンによって構成が変わることがあるため、パスが見つからない場合は ~/.claude/projects/ でセッション ID を検索してください。

~/.claude/projects/<project>/                 <project>: the session's working directory, with / and . turned into -
  <session-id>.jsonl                          the main session
  <session-id>/subagents/agent-<id>.jsonl     each sub-agent, nested ones included
  <session-id>/subagents/agent-<id>.meta.json its type, task description and spawn depth

現在のセッション ID は、環境変数 CLAUDE_CODE_SESSION_ID にあります。スキルの読み込みは、tool_use ブロックでは Skill という名前で現れ、そのブロックの input > skill にスキル名が含まれます。また、ユーザーメッセージ内の <command-name>/<name></command-name> としても現れます。

  • 別のハーネスの場合： セッションの保存場所と、スキルの読み込みがどのように記録されるかを確認してください。Codex のセッションは ~/.codex/sessions/ に保存されます。スキルは skills/<name>/SKILL.md を読み取ることで読み込まれるため、そのファイルを読んだことが読み込みの記録になります。セッションでスキルを編集する場合も同じファイルを読み取るため、編集のための読み取りとスキルの読み込みを区別してください。

2. 監査する

トランスクリプトは長くなるため、スキルの読み込み、エラー、再試行、1つの問題に対する長時間のツール呼び出し、ユーザーからの修正など、監査に必要な情報を検索し、それぞれの該当箇所の前後を読んでください。全体を通読する必要はありません。

対象範囲内で読み込まれたすべてのスキルと、スキルが不足していたすべての場面を評価してください。スキルが作業に役立った、または支障をきたした事柄があれば、振り返りに含めます。たとえば、次のような点です。

  • スキルがあれば節約できた、またはスキルによって発生したトークンや時間
  • スキルが引き起こした、または防げなかった行き詰まり
  • スキルに記載された誤った情報や古い情報
  • 実際の状況がスキルの想定と異なっていたことなど、予想外のこと
  • 適用されるべきだったのに適用されなかったスキル、または適用すべきでないときに適用されたスキル
  • スキルには記載されていないものの、ユーザーがチャットで提示したルール
  • スキルが対象とすべき問題に対して、エージェントが考案した回避策

これらは例であり、チェックリストではありません。ユーザー自身のものだけでなく、他者のリポジトリにあるスキルも同様に監査してください。

各所見には、以下を含めます。

  • スキル：スキル名と提供元のリポジトリ。該当するスキルがない場合は「スキルなし」
  • 証拠：どのセッションまたはサブエージェントで何が起きたか。引用するか、内容を忠実に言い換えてください。
  • コスト：トークン、時間、誤った出力、ユーザーの注意など、発生したコストやリスク
  • 改善案：問題を解決するためにスキルに加える変更

スキルの変更で対処できない理由で起きたことは含めないでください。所見は、スキルに加える変更を示すものでなければなりません。

3. レポート

調査結果を示し、その後に結論を述べます。

  • 該当するものがない場合は、**「スキルの変更は不要です。」**とします。これは良い結果であり、振り返りに失敗したわけではありません。
  • 該当するものがある場合は、対象となるスキル名を挙げて、**「件の改善機会」**とします。

改善機会がある場合は、次のステップを最後に示します。ユーザーが別のリポジトリを指定しない限り、ユーザーは /to-tickets を実行して、改善機会を <skills-repo> のイシューとして登録します。/to-tickets は会話の内容をもとに動作するため、記載した調査結果がその入力となります。

<skills-repo> が公開リポジトリの場合は、ユーザーの指示にある公開リポジトリの記述ルールに従って、各調査結果を記載します。そのルールはエージェント向けの指示にあるため、そこを確認してください。

  • 他の人のスキルに関する調査結果の場合： <skills-repo> に登録するか、スキルをフォークするか、スキル本体のリポジトリに持ち込むかは、ユーザーが判断します。

レポートの後はそこで終了し、イシューの作成、コメント、スキルの編集はユーザーに任せます。どの調査結果に対応するかは、ユーザーが決めるためです。

コメント

Markdown 対応