mcpField
C
ccbox

ccbox

github.com/diskd-aiAgent 工作流39121 次安装35 周前更新
代码仓库

关于 ccbox

ccbox 是用于检查本地 Agent 会话日志的命令行工具，可按项目和会话查看记录，并据此整理有证据支持的洞察报告。

主要功能

  1. 01发现本地项目
  2. 02列出项目会话
  3. 03查看完整会话日志
  4. 04检查工具调用与输出
  5. 05生成洞察报告

适用场景

  1. 01回顾当前项目的最新会话
  2. 02梳理 Agent 执行过的步骤
  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 检查本地 Agent 会话日志，并生成快速、基于证据的见解。

快速开始

  • 列出已发现的项目：
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" 指定项目。
    • 从第一行复制 log_path。
    • 运行 ccbox history "/abs/log.jsonl" --full 以收集证据（工具调用、工具输出、错误）。
  3. 生成见解报告：
    • 用户想要什么（第一条 USER 提示）。
    • Agent 做了什么（工具调用顺序和关键输出）。
    • 有哪些变更（工具输出中可见的文件/命令）。
    • 有哪些失败或风险（警告、时间线截断、输出中的崩溃/错误）。
    • 后续步骤（具体的验证命令和跟进事项）。

参考资料

  • CLI 命令和输出格式：references/cli.md
  • 见解检查清单和报告模板：references/insights.md

评论

支持 Markdown