MMCPMarkets
SR

study8677/readme.skill

Developer tools
158 stars Quality 40 Trend 40
Repository Install

读取本地 Claude Code / Codex CLI / Kiro / Trae / Gemini Antigravity / Cursor 的真实使用数据，自动生成**的 AI-Native 开发者画像 —— 一份长报告 + 一张竖屏海报。

Overview

读取本地 Claude Code / Codex CLI / Kiro / Trae / Gemini Antigravity / Cursor 的真实使用数据，自动生成**的 AI-Native 开发者画像 —— 一份长报告 + 一张竖屏海报。

README

↑ v2.5.1 在作者电脑上跑出的最新真实输出（148 天 · 22.21B token · 23.8× cache leverage · 2,217★ · 4 个 AI 工具并用）。 点击图片查看完整 中文 Markdown profile · English profile。

✨ 它能给你什么

  • 一份长报告（示例）— 10 个维度叙事：AI-native 实践 / Cache leverage / Session 架构 / Token 经济学 / Evolution 曲线 / 项目领域 …
  • 月度 / 阶段报告 — 可以指定 2026-05、2026-03 到 2026-05、最近30天，看某个阶段 AI 编码带来的效果和变化。
  • 一张竖屏海报（示例 SVG）— 1080×1920，6 个英雄数字 + AI 自评金句 + 身份徽章 + 一键安装 CTA，社媒直发不丢人。
  • 完全本地完成：除调用 gh 拉你自己的 GitHub 公开贡献外，0 联网、0 上传、0 写盘到 ~/.claude。
  • 默认匿名：项目名变 「项目 A/B/C」，私有仓变 Private Repo X，API key / token / 邮箱按 OWASP 正则清洗。
  • 一句话触发：装好后只要说「生成我的 AI 档案」，AI 自动跑完 9 个 Step。

🎯 谁会想用

你是 你能用它做什么
正在求职的开发者 在 GitHub profile 顶部放一张你跟 AI 协作的真实画像，比简历的 “熟练使用 AI 工具” 强 100 倍
AI-Native 实践派 量化展示你的 cache leverage、多模型编排、自建 skill 数 —— 这些数字用面试讲不出来
年终复盘 / 月报 / 周报困难户 跑一次，得到全量或指定月份的活跃热力图 + Evolution 曲线，复盘材料一键齐
小红书 / 推特 / 微信 创作者 海报内置传播 3 件套（金句 + 徽章 + 安装 CTA），转发链路天然形成
团队 Tech Lead 让团队每人跑一份，了解大家的 AI 协作深度，找 best practice 而不是 best worker

⚡ 30 秒装上

方式零：Claude Code Plugin（推荐 —— 两行命令）

在 Claude Code 里：

/plugin marketplace add study8677/Readme.skill
/plugin install readme-skill@study8677

Claude Code 自动发现 skills/readme-skill/SKILL.md 并挂载，无需手动 symlink。

方式一：Clone + 软链（Codex CLI 或不想用 plugin 的用户）

git clone https://github.com/study8677/Readme.skill.git
cd Readme.skill

# Claude Code 用户
mkdir -p ~/.claude/skills/readme-skill
ln -sf "$(pwd)/skills/readme-skill/SKILL.md" ~/.claude/skills/readme-skill/SKILL.md

# Codex CLI 用户
mkdir -p ~/.codex/skills/readme-skill
ln -sf "$(pwd)/skills/readme-skill/SKILL.md" ~/.codex/skills/readme-skill/SKILL.md

🎬 怎么用

安装后在 Claude Code 或 Codex 的对话里说出以下任一句即可触发：

  • 「生成我的 AI 档案」
  • 「做一份 AI-native README」
  • 「分析我的 Claude / Codex 使用情况」
  • 「生成 2026-05 的 AI 月度报告」
  • 「分析 2026-03 到 2026-05 AI 编码变化」
  • “build my AI usage profile”
  • “build my AI usage profile for May 2026”
  • “summarize my Claude / Codex history”

AI 会跑完整套流程，把结果写到 output/profile_.md + output/poster__.svg，并在结束前校验 SVG 能被浏览器正常解析。除非你明确说「不要海报 / 只要 markdown」，否则默认会生成海报。如果指定月份 / 时间范围，文件名会带上窗口后缀，例如 output/profile_202605_.md 和 output/poster_202605__.svg。中文提问出中文版，英文提问出英文版。

私人版 vs 分享版

  • 默认（分享版） — 项目名匿名为「项目 A/B/C」，私有仓库改为「Private Repo X」。
  • 私人版 — 加一句「私人版 / 不要脱敏 / show real names」，AI 会保留真实名字（仍会脱敏 API key、邮箱）。

🌐 支持的 AI 编程工具

工具 状态 数据源
Claude Code ✅ 完整支持 ~/.claude/stats-cache.json + history.jsonl + projects/*/*.jsonl + plans + skills + settings
Codex CLI ✅ 完整支持 ~/.codex/state_5.sqlite (read-only) + history.jsonl + skills + automations + rules
Kiro (AWS) ✅ v2.5 新增 ~/.kiro/sessions/cli/*.{json,jsonl} + ~/.local/share/kiro-cli/data.sqlite3 + ~/.kiro/{agents,skills,steering,prompts,settings}
Trae (ByteDance) ⚠️ v2.5 部分支持 ~/Library/Application Support/Trae/User/{workspaceStorage,globalStorage}/state.vscdb（chat 元数据，read-only）+ 项目 .trae/{rules,skills}。token 用量走云端 API，本 skill 不联网，默认缺失
Gemini Antigravity (Google) ✅ v2.5 新增（社区 PR #1 贡献） ~/.gemini/antigravity/brain//：每个 task/session 的 *.metadata.json + task.md / implementation_plan.md / walkthrough.md。token 不可得，按 task/artifact 计数 + text-scale 估算（非计费）
Cursor (Anysphere) ✅ v2.5.3 增强 ~/Library/Application Support/Cursor/User/{workspaceStorage,globalStorage}/state.vscdb 的 composer.composerHeaders（标题 / subtitle / workspace / 时间 / 变更行数元数据）+ composer.* / aiService.* keys + 项目 .cursor/{rules,mcp.json} / .cursorrules。token 权威在云端 dashboard，本地不混算
GitHub ✅ 公开贡献 gh api graphql —— 默认 365 天；指定时间范围时按窗口统计 contributions / top repos，语言和 stars 作为当前仓库属性展示
本地 Git ✅ 完整支持 项目内只读 git log，默认过去一年；指定时间范围时按窗口统计 commit / ± 行数

用别的 AI IDE？欢迎提 Issue 告诉我数据路径，我会按同样模式接入。

📊 它长什么样

两份产物：

1. Markdown profile —— 长报告

10 个维度叙事，参考完整示例：examples/profile_20260515.md

2. SVG 海报 —— 一张图传播

1080×1920 竖屏，v2.4 链式传播版自带 3 件套：

  • A. AI 自评金句（双行大字，根据数据画像写出有人格的评价 —— 把 token 量换算成「等于 N 万遍《红楼梦》」）
  • B. 身份徽章（顶部 4 胶囊：TWO-ENGINE / CACHE MASTER / SKILL BUILDER / POLYGLOT / TOKEN WHALE 等，自动判定）
  • C. 30 秒安装 CTA（底部 install 命令 + 仓库 URL，让看到的人能立刻生成自己的）
  • 6 个英雄数字 + Evolution 时间线 + Cache leverage 排行 + Top slash 命令
  • 自动按提问语言选中/英：中文版 · English
  • 生成后会做 SVG XML 解析校验，避免裸 & / < 等动态文本导致浏览器打开时报错

海报转 PNG（用于发社媒）

# 方式 1: rsvg-convert （需要 brew install librsvg）
rsvg-convert -h 1920 output/poster_*.svg > poster.png

# 方式 2: 用 Chrome / 浏览器
open output/poster_*.svg     # macOS 默认打开 → 右键另存为 PNG / 截图

# 方式 3: chromium headless
chromium --headless --screenshot=poster.png --window-size=1080,1920 output/poster_*.svg

🆚 跟同类项目有啥不同

项目 数据来源 输出 隐私 重点
Readme.skill 本地 Claude/Codex 对话 + GitHub + git log 长报告 + 海报 全本地 / 默认脱敏 AI 协作深度
WakaTime IDE 插件实时上报 网页 dashboard 上传服务器 编程时长
github-readme-stats GitHub API profile 卡片 公开数据 贡献量
GitHub Skyline GitHub 贡献日历 3D 模型 公开数据 视觉炫

简单说：别的工具看你"写了多少代码"，Readme.skill 看你"怎么和 AI 一起写代码"。

🛡️ 隐私承诺

  • 全部数据采集发生在本机，除 gh 调用 GitHub 自身外不联网
  • 对话正文（message.content）可被读取以增强关键词、协作风格、Session 架构分析，但原文不会写进报告
  • 默认对项目名、私有仓库做匿名映射；按 OWASP-style 正则清洗 API key / token / webhook / 邮箱
  • skill 不会修改 ~/.claude 或 ~/.codex 下任何文件（SQLite 用 mode=ro&immutable=1 打开）
  • 报告生成后写到当前目录的 ./output/，你随时可以 rm 或全文搜查

🗺️ Roadmap

  • v2.5.2（已发布） — ✅ 月度 / 时间范围报告（#3）：支持 2026-05、日期区间、最近 N 天，所有可过滤数据按统一窗口统计。
  • v2.5（已发布） — ✅ Kiro (AWS) / Trae (ByteDance) / Antigravity 适配（#2），后续 v2.5.1 加入 Cursor，现已支持 6 个 AI 编程工具；Weekly Recap 模式与首页 Community Gallery 持续迭代
  • v2.6 — --diff 跟上次生成的报告做快照对比；里程碑徽章（BILLION CLUB / 10K STARS）
  • v3.0 — 让 skill 自己学：根据用户反馈调整叙事 tone

想看哪个先做？去 Issue 投票 或者 开 Discussion。

🤝 想贡献？

  • 跑出有趣画像 → 截图发 Discussions › Show your profile，会被收入主页 Gallery
  • 支持别的 AI 工具 → 提 Issue 告诉我数据路径，照 SKILL.md Step 2/3 的范式 PR
  • 改进金句 / 徽章逻辑 → 直接改 SKILL.md Step 8b 里的 Tone A-F 或徽章触发条件
  • 翻译成你的语言 → 目前有中英文，欢迎日 / 韩 / 葡 / 西 PR

❓ FAQ

💌 致谢 & 友链

⭐ Star history

📜 协议

MIT —— 拿去随便用，记得改成自己仓库名。

View this README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add study8677/readme.skill