Claude Code 使用回执
从本地会话与 Git 记录生成可分享的 Claude Code 影响报告。
技能明确限定读取本机 ~/.claude/projects 会话记录和本地 git,声明不联网、不额外调用 API,并披露最终模型仅接收小型聚合摘要;还提示项目名可能包含敏感信息并默认不发布。扣分原因是读取范围较宽、会把姓名、统计数据和仓库名发送给最终模型,未说明逐次确认、敏感字段脱敏、输出覆盖/回滚或权限隔离。
文档与脚本显示了参数解析、无效日期报错、重复 UUID 去重、失败工具调用排除、路径规范化、git 超时处理和本地 HTML 生成等诊断与稳定性措施。扣分原因是本次仅静态阅读,未见针对关键路径的提交测试套件,且提供的脚本证据在末尾不完整;按静态上限保守评分。
触发词、命令入口、周期参数、项目筛选、输出格式和非发布边界描述清楚,适用于需要本机 Claude Code 使用/影响报告的开发者。扣分原因是仅适配 Claude Code 本地会话结构,未明确支持范围外的日志格式、非本地环境或缺失目录场景;文档没有中文使用说明,虽然核心计算离线、不依赖海外网络。
SKILL.md 具有较完整的分步结构、输入映射、JSON schema、字段语义、报告模板、隐私提示和安装/运行说明;仓库 README、Apache-2.0 许可证及 Anthropic 维护背景提供了基本治理线索。扣分原因是未见该技能自身的版本号、变更日志、FAQ、明确维护负责人或升级路径,且依赖版本策略说明有限。
目标是从本机记录生成可直接使用的 Markdown 报告和自包含 HTML 收据,包含项目、活动、提交和 PR 等聚合信息,并避免虚构金额或节省时间,核心产出设计较明确。扣分原因是没有静态可验证的代表性输出或执行结果,最终报告仍需人工核对和补充具体成果;按静态上限不超过7分。
脚本源代码对数据来源、计算规则、排除逻辑、项目归属和相对成本权重进行了较详细说明,具备一定审计性。扣分原因是没有看到覆盖关键路径的测试结果、第三方复核或可复现实例,仓库 CI 文件也未证明本技能被实际执行验证;静态评估最高不超过5分。
- 运行会扫描本机 ~/.claude/projects 下的会话记录,并可能将姓名、仓库名和聚合统计发送给最终模型;在共享、敏感或合规环境中应先确认数据边界。
- 报告中的项目目录名可能泄露客户、内部项目或机密代号;应使用 --repo 筛选并在分享前人工检查 Markdown 和 HTML。
- 本次未执行脚本,也未验证实际输出、跨平台行为或长历史性能;异常日志格式、权限不足和缺失依赖仍需现场验证。
它能做什么 & 适用场景
Receipts 会扫描本机的 Claude Code 会话转录,并按项目汇总使用情况与影响指标。它结合本地 Git 历史,生成 Markdown 报告和自包含 HTML 回执。挖掘过程只使用本地文件与 Git,不进行额外 API 调用;仅最终写作用一次模型调用。该技能适合需要复盘 Claude Code 工作、向经理说明使用情况,或检查近期开发活动的用户。
读取 ~/.claude/projects/**/*.jsonl 中指定时间范围的本地会话转录;运行随技能提供的 mine-transcripts.mjs 脚本,统计会话、提示、活跃天数、触及文件、近似行数和通过 Claude Code 发起的 PR 命令;按会话触及的项目归属工作,并按项目交叉核对本地 git log;将汇总结果写成 Markdown 报告,同时生成带项目表格和 CSV 导出按钮的自包含 HTML 回执。
- 开发者想向经理说明某个周期内 Claude Code 参与了哪些项目和交付工作。
- 开发者进行月度或季度自我复盘,需要查看会话、文件变更和提交关联情况。
- 用户想回答“我最近都用 Claude Code 做了什么”,并按项目查看结果。
- 用户需要一份可粘贴到文档或聊天中的 Markdown 报告,以及便于打开或附加的 HTML 版本。
优缺点一览
- 完全基于本机已有的 Claude Code 会话和 Git 数据,适合内部复盘。
- 同时生成 Markdown 与自包含 HTML,HTML 支持离线查看和 CSV 导出。
- 按项目归属工作,并区分文件、会话、活跃天数和提交等指标的统计口径。
- 不会把本地 token 数换算成未经验证的美元成本。
- 依赖本机可读的 ~/.claude/projects 会话转录和本地 Git 环境,无法覆盖机器之外的活动。
- 输出聚焦 Claude Code 使用与项目关联指标,不提供可靠的节省工时或创造美元价值估算。
- 技能包含 `$ARGUMENTS`、`/receipts` 和 Claude Code 专用行为,迁移到其他客户端需要调整。
- 提交统计可能为 null;这可能表示没有携带相关工作的提交,也可能表示 Git 未配置或读取失败,需结合 gitUnavailable 判读。
如何安装
在 Claude Code 中从该官方插件市场安装:/plugin install {plugin-name}@claude-plugins-official,或运行 /plugin → Discover 浏览并选择对应插件。源码仓库没有在提供的材料中明确 receipts 的 marketplace 插件名,因此不要自行猜测该名称。
如何使用
安装后运行 /receipts,或输入“生成我的 Claude Code 使用影响报告”。可在参数中指定 week、month、quarter、year、天数,或项目名称/子字符串;例如 /receipts month 或 /receipts 90。输出文件名和确切保存路径由脚本根据实际日期决定,材料未提供额外的手动安装或运行命令。