1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Readme.skill |
| 作者/维护者 | study8677（LICENSE 署名 JingWen Fan） |
| 来源链接 | https://github.com/study8677/Readme.skill |
| 许可证 | MIT（来自 GitHub API，明确） |
| GitHub Stars | 157（来自 GitHub API） |
| Forks | 10（来自 GitHub API） |
| 最新版本 | v2.5.3（2026-06-07，来自 CHANGELOG 与仓库版本徽章） |
| 安装方式 | Claude Code 插件市场两行命令，或 clone + 软链 / curl 手动安装 |
2. 功能介绍与亮点
读取本地 Claude Code、Codex、Kiro、Trae、Gemini Antigravity、Cursor 六款工具的真实使用记录，聚合 session、token、cache 命中等数据，产出 10 维度 Markdown 长报告与一张 1080×1920 竖屏 SVG 海报（核心数字 + AI 自评金句 + 身份徽章），支持按月份或时间窗生成阶段报告并对比变化。
亮点：全程本地只读，默认对项目名、私有仓库名、API key/邮箱做脱敏清洗；已被阮一峰《科技爱好者周刊》第 395 期收录；2026-04～06 连续发布 4 个小版本，其中一项特性来自外部社区 PR。
3. 适用场景
固定分类：元技能与 Agent 增强。
面向求职者在 GitHub 主页展示可信的 AI 协作数据画像、AI-Native 实践者量化 cache leverage 与多模型编排能力，或需周期性复盘 AI 编码效果又不想手翻原始日志的个人与 Tech Lead。
4. 跨 Agent 兼容性
- Claude Code：原生支持 ✅——README 明确列为 Full support，SKILL.md 直接读取
~/.claude/下的 stats-cache 与 history.jsonl。 - Codex：原生支持 ✅——README 同样标注 Full support，并提供 Codex 专用 clone + 软链安装步骤。
- OpenClaw：未验证——README 未提及该平台。
- Hermes Agent：未验证——README 未提及该平台。
5. 推荐理由
把本地零散的 AI 协作日志转成可直接分享的量化画像，覆盖 6 款主流工具而非单一厂商生态；本地只读、默认脱敏，两行命令即可安装，填补“对外展示”而非“内部诊断”这一空白。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 157★/10 fork 规模不大，但有 ≥3 个独立信号佐证活跃度：阮一峰《科技爱好者周刊》第 395 期编辑精选收录、两名外部用户（JaneYork、Tlinky）issue 提需求被采纳、外部贡献者（@BaekElk19）PR 被合并 |
| 可用性 | 9 | 两行命令即装；SKILL.md 与中英双语文档详尽含示例；4 个月内连发 4 个小版本，2026-06-10 仍有提交；无付费依赖 |
| 安全性 | 8 | 逐项见下 |
安全检查清单：①仅用只读模式（mode=ro&immutable=1）读取本机日志 + gh api 读取用户自己公开数据，无越权；②除 gh api 外无其他联网；③复用本地已有 gh 登录态，不额外收集凭据；④无可疑指令，反内置正则清洗 API key/邮箱/webhook；⑤个人开发者，代码公开可审计，无刷星迹象；⑥MIT 明确；⑦2026-06-10 仍有提交，迭代密集。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| session-report（Anthropic 官方） | 面向 Claude Code 团队复盘 token/cache 开销的本地 HTML 报告工具 | 只覆盖 Claude Code 单一工具，聚焦内部成本诊断；不做匿名化，也不面向对外分享 |
| ccusage | 社区公认的 Claude Code 用量分析 CLI，输出终端表格/JSON 成本报表 | 需单独 npm 安装命令行工具，只产出原始数字表，不生成可分享的画像海报，也不聚合多款 AI 工具 |
差异化在于同时覆盖 6 款主流工具、默认脱敏，并直接产出可分享的报告 + 海报，是“对外展示名片”而非“内部诊断报表”。
8. 用户评价
- 阮一峰《科技爱好者周刊》编辑组｜来源：
ruanyf/weekly第 395 期｜收录本技能并简述其统计 Claude Code/Codex 活动的功能。 - GitHub 用户 JaneYork｜来源：仓库 Issue #2｜请求增加 Kiro、Trae.ai 移植版本，后续版本已实现。
- GitHub 用户 Tlinky｜来源：仓库 Issue #3｜询问能否按月份分析，v2.5.2 已实现。
9. 其他补充
提供中英双语文档；v2.5.0 的 Gemini Antigravity 支持由外部贡献者 @BaekElk19 通过社区 PR 加入。
10. 安装使用方式
- Claude Code 插件市场（推荐）：
/plugin marketplace add study8677/Readme.skill，再/plugin install readme-skill@study8677。 - 手动安装（Codex 等）：clone 后将
skills/readme-skill/SKILL.md软链到~/.claude/skills/readme-skill/（Codex 用~/.codex/），或一行curl直接下载。 - 安装后：无需重启，说“生成我的 AI 档案”或指定月份即可触发；默认生成脱敏“分享版”，需真实名可说明“私人版”。
11. 注意事项
- 依赖
ghCLI 且需已登录 GitHub 账号，否则该维度数据自动降级跳过。 - 报告与海报默认脱敏，但仍可能含项目数量、活跃时段等间接信息，对外分享前建议自查。
- Trae、Gemini Antigravity 等工具的 token 数据为本地估算，非官方计费口径。