mcpField
C
ccbox

ccbox

github.com/diskd-aiエージェントワークフロー39121 回インストール35 週間前に更新
リポジトリ

ccbox について

ccbox は、ローカルのエージェントセッションログを調べる CLI です。プロジェクトやセッションを確認し、記録された操作と出力を根拠にレポートをまとめられます。

主な機能

  1. 01ローカルプロジェクトの検出
  2. 02プロジェクトセッションの一覧表示
  3. 03セッションログ全体の確認
  4. 04ツール呼び出しと出力の確認
  5. 05インサイトレポートの作成

活用シーン

  1. 01プロジェクトの最新セッションの振り返り
  2. 02エージェントの操作手順の要約
  3. 03ログ内のエラーやリスクの発見

インストール

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

$npx skills add https://github.com/diskd-ai/ccbox --skill ccbox

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
agents/
openai.yaml
references/
cli.md
insights.md

詳細

ccbox

ccbox CLI を使ってローカルのエージェントセッションログを調査し、根拠に基づく簡潔な分析情報を作成します。

クイックスタート

  • 検出されたプロジェクトを一覧表示します。
ccbox projects
  • 現在のフォルダーのセッションを一覧表示します（プロジェクトを自動検出します）。
ccbox sessions
ccbox sessions --limit 50 --offset 0 --size
  • 現在のフォルダーの最新セッションを調査します。
ccbox history
ccbox history --full
ccbox history --limit 200 --offset 0 --full --size
  • 特定のプロジェクトまたはログファイルを調査します。
ccbox sessions "/abs/path/to/project"
ccbox history "/abs/path/to/project" --full
ccbox history "/abs/path/to/session.jsonl" --full

ワークフロー（推奨）

  1. ccbox が利用可能で、最新の状態であることを確認します。
    • ccbox --help
    • ccbox update（up-to-date: または updated: を出力します。macOS/Linux ではセルフアップデートに対応しています）
  2. まず事実を集めます（推測しないでください）。
    • ccbox sessions を使って現在のフォルダーの最新セッションを選択するか、ccbox sessions "/abs/project/path" を使ってプロジェクトを明示的に指定します。
    • 1 行目から log_path をコピーします。
    • ccbox history "/abs/log.jsonl" --full を実行して、根拠（ツール呼び出し、ツール出力、エラー）を記録します。
  3. 分析レポートを作成します。
    • ユーザーが求めていたこと（最初の USER プロンプト）。
    • エージェントが行ったこと（ツール呼び出しの順序と主な出力）。
    • 変更内容（ツール出力に表示されたファイルやコマンド）。
    • 失敗したこと、またはリスクがあること（警告、途中で切れたタイムライン、出力内のパニックやエラー）。
    • 次のステップ（具体的な検証コマンドとフォローアップ）。

参考資料

  • CLI コマンドと出力形式：references/cli.md
  • 分析チェックリストとレポートのテンプレート：references/insights.md

コメント

Markdown 対応