一份 Claude Code / Codex CLI 的 skill：自动生成对外可分享、脱敏的 AI-Native 开发者 README。
Readme.skill 不是一个程序，而是一份给 AI agent 的指令集（即 SKILL.md）。当你在 Claude Code 或 Codex 里说出触发词（如「生成我的 AI 档案」），AI 会按照 SKILL.md 的步骤：
- 读取本机
~/.claude/与~/.codex/的统计文件、SQLite、历史 JSONL - 调用
gh拉取你的 GitHub 公开贡献日历与 top 仓库 - 在你的工作目录里跑只读
git log，统计本地提交 - 计算 7 个维度（一览 / AI-Native / 协作风格 / 项目 / 主题 / 节奏 / 投入×产出）
- 默认匿名脱敏，输出
output/profile_YYYYMMDD.md
整个过程只读、不联网（除 gh）、不读对话正文，可放心运行并对外分享结果。
git clone https://github.com/study8677/Readme.skill.git
cd Readme.skill
# Claude Code 用户
mkdir -p ~/.claude/skills/readme-skill
ln -sf "$(pwd)/SKILL.md" ~/.claude/skills/readme-skill/SKILL.md
# Codex CLI 用户
mkdir -p ~/.codex/skills/readme-skill
ln -sf "$(pwd)/SKILL.md" ~/.codex/skills/readme-skill/SKILL.mdgit clone https://github.com/study8677/Readme.skill.git
# Claude Code
mkdir -p ~/.claude/skills/readme-skill
cp Readme.skill/SKILL.md ~/.claude/skills/readme-skill/
# Codex CLI
mkdir -p ~/.codex/skills/readme-skill
cp Readme.skill/SKILL.md ~/.codex/skills/readme-skill/# Claude Code
mkdir -p ~/.claude/skills/readme-skill && curl -fsSL https://raw.githubusercontent.com/study8677/Readme.skill/main/SKILL.md -o ~/.claude/skills/readme-skill/SKILL.md
# Codex CLI
mkdir -p ~/.codex/skills/readme-skill && curl -fsSL https://raw.githubusercontent.com/study8677/Readme.skill/main/SKILL.md -o ~/.codex/skills/readme-skill/SKILL.md安装后在 Claude Code 或 Codex 的对话里说出以下任一句即可触发：
- "生成我的 AI 档案"
- "做一份 AI-native README"
- "分析我的 Claude / Codex 使用情况"
- "build my AI usage profile"
- "summarize my Claude / Codex history"
AI 会跑完整套流程，把结果写到 output/profile_<日期>.md。
- 默认（分享版） — 项目名匿名为「项目 A/B/C」，私有仓库改为「Private Repo X」
- 私人版 — 加一句 "私人版 / 不要脱敏 / show real names"，AI 会保留真实名字（仍会脱敏 API key、邮箱）
参考 examples/example_profile.md（虚构数据，仅展示格式）。结构：
- 个人理念（来自 GitHub bio）
- 一览（关键数字 + velocity 指标）
- 🚀 Velocity & Leverage — AI 让你快了多少、广了多少（v2.0 新增）
- 🤖 AI-Native 实践（多模型编排、高级能力、prompt caching、reasoning effort）
- 🔧 AI 基础设施 — 你造了什么工具给 AI 用（v2.0 新增）
- 🛠️ AI 协作风格（slash 命令 + Session 架构分析）
- 📂 项目与领域分布（脱敏表 + 双工具编排模式）
- 🧬 Evolution 曲线 — AI 用法的成长弧线（v2.0 新增）
- 💡 兴趣主题 & 关键词
- ⏱️ 工作节奏（24h 热力图、连续活跃、峰值日）
- 💰 产出 & 投入（GitHub 贡献优先，token 表降级到参考）
- 📊 数据来源 & 隐私承诺
| 来源 | 路径 | 用途 |
|---|---|---|
| Claude Code 预聚合 | ~/.claude/stats-cache.json |
sessions / messages / tokens / hour heatmap |
| Claude 命令历史 | ~/.claude/history.jsonl |
slash 命令热度、项目归属 |
| Claude 项目 | ~/.claude/projects/<encoded>/*.jsonl |
每项目 session 计数 + 真实 cwd 还原 |
| Claude 计划 | ~/.claude/plans/*.md |
plan 标题（关键词语料） |
| Claude skills | ~/.claude/skills/ |
自研 skill 数 |
| Codex 主库 | ~/.codex/state_5.sqlite (read-only) |
threads 表的全部统计 |
| Codex 命令 | ~/.codex/history.jsonl |
prompt 文本采样 |
| GitHub | gh api graphql |
365 天 contributions、top repos、语言 |
| 本地 Git | 候选目录的 git log |
commits / additions / deletions |
缺少某个数据源？没关系。Skill 内置降级策略：没有 Codex SQLite 就跳过 Codex 章节，没有
gh就跳过 GitHub 章节，报告照样生成。
- 全部数据采集发生在本机，除
gh调用 GitHub 自身外不联网 - 永不读取
message.content等对话正文字段 - 默认对项目名、私有仓库做匿名映射；按 OWASP-style 正则清洗 API key / token / webhook / 邮箱
- skill 不会修改
~/.claude或~/.codex下任何文件（SQLite 用mode=ro&immutable=1打开）
Skill = 给 AI agent 的指令集，不是替它做事的代码。
SKILL.md 是唯一的真实交付物。任何"为什么不用一个 Python 脚本一把跑完？"的冲动都被刻意抑制——目的是让 AI 自己理解数据、自己做权衡、自己写出有温度的文字，而不是机械地填模板。
MIT