Prepare v2.4.0 release

Author: study8677

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "readme-skill",
   "description": "Generate an AI-Native developer profile from local Claude Code + Codex data, GitHub contributions, and git log. Local-only, read-only, anonymized by default.",
-  "version": "2.0.0",
+  "version": "2.4.0",
   "author": {
     "name": "JingWen Fan",
     "url": "https://github.com/study8677"

.gitignore

@@ -1,2 +1,2 @@
-output/*.md
+output/*
 !output/.gitkeep

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 JingWen Fan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.en.md

@@ -25,7 +25,7 @@ Readme.skill is not a program — it's an instruction set for an AI agent (i.e.
 2. Call `gh` to pull your GitHub public contribution calendar and top repos
 3. Run read-only `git log` in your working directories to count local commits
 4. Compute 10 dimensions (overview / AI-Native / collaboration style / projects / topics / rhythm / output × input / velocity / evolution / token economics)
-5. Anonymize and redact by default; write to `output/profile_YYYYMMDD.md`
+5. Anonymize and redact by default; write in the requested language to `output/profile_YYYYMMDD.md` or `output/profile_YYYYMMDD_en.md`
 
 The whole flow is **read-only and fully local (except `gh`)** — safe to run, safe to share. Conversation text may be read for keyword and collaboration-style signal, but never copied verbatim into the report.
 
@@ -91,7 +91,7 @@ After installing, say one of these in Claude Code or Codex:
 - "generate my AI profile" / "生成我的 AI 档案"
 - "analyze my Claude usage"
 
-The AI runs the full pipeline and writes to `output/profile_<date>.md`.
+The AI runs the full pipeline and writes to `output/profile_<date>_en.md` for English requests, or `output/profile_<date>.md` for Chinese/default requests.
 
 ### Private vs shareable
 
@@ -177,7 +177,7 @@ Design principles (from the v2.4 brief): identity readable in 3 seconds + 6 evid
 
 ## License
 
-MIT
+[MIT](./LICENSE)
 
 ## Friends
 

README.md

@@ -24,8 +24,8 @@ Readme.skill 不是一个程序，而是一份给 AI agent 的指令集（即 [`
 1. 读取本机 `~/.claude/` 与 `~/.codex/` 的统计文件、SQLite、历史 JSONL
 2. 调用 `gh` 拉取你的 GitHub 公开贡献日历与 top 仓库
 3. 在你的工作目录里跑只读 `git log`，统计本地提交
-4. 计算 7 个维度（一览 / AI-Native / 协作风格 / 项目 / 主题 / 节奏 / 投入×产出）
-5. 默认匿名脱敏，输出 `output/profile_YYYYMMDD.md`
+4. 计算 10 个维度（一览 / AI-Native / 基础设施 / 协作风格 / 项目 / 主题 / 节奏 / Token 经济学 / 投入×产出 / 进化曲线）
+5. 默认匿名脱敏，按提问语言输出 `output/profile_YYYYMMDD.md` 或 `output/profile_YYYYMMDD_en.md`
 
 整个过程**只读、不联网（除 `gh`）**，可放心运行并对外分享结果。对话正文可被读取以提取关键词和协作风格信号，但原文不会写进报告。
 
@@ -91,7 +91,7 @@ mkdir -p ~/.codex/skills/readme-skill && curl -fsSL https://raw.githubuserconten
 - "build my AI usage profile"
 - "summarize my Claude / Codex history"
 
-AI 会跑完整套流程，把结果写到 `output/profile_<日期>.md`。
+AI 会跑完整套流程，把结果写到 `output/profile_<日期>.md`。如果你用英文提问或明确要求英文版，会写到 `output/profile_<日期>_en.md`。
 
 ### 私人版 vs 分享版
 
@@ -177,7 +177,7 @@ chromium --headless --screenshot=poster.png --window-size=1080,1920 output/poste
 
 ## 协议
 
-MIT
+[MIT](./LICENSE)
 
 ## 友链
 

skills/readme-skill/SKILL.md

@@ -14,10 +14,11 @@ license: MIT
 # Readme.skill — AI-Native 开发者档案生成器
 
 You (the AI agent invoking this skill) will read local Claude Code + Codex data,
-compute a fixed set of dimensions, and render a Chinese Markdown profile under
-`./output/`. **You do all of the work** — read the files with `Read`, query
-sqlite via `Bash`, and synthesize the prose yourself. Do **not** write helper
-scripts; the skill is the recipe.
+compute a fixed set of dimensions, and render a Markdown profile under
+`./output/` in the user's requested language (Chinese by default; English when
+the user asks in English or explicitly requests English). **You do all of the
+work** — read the files with `Read`, query sqlite via `Bash`, and synthesize the
+prose yourself. Do **not** write helper scripts; the skill is the recipe.
 
 > 默认行为：**对外分享版** —— 项目名匿名、敏感信息脱敏。
 > 如果用户明确说"私人版 / 不要脱敏 / show real names"，跳过匿名步骤。
@@ -511,9 +512,15 @@ If user said "show real names" / "私人版":
 
 ## Step 8 — 渲染最终 Markdown
 
-Write to `output/profile_<YYYYMMDD>.md` using **exactly** this structure
-(中文叙事 + 表格；技术词保留英文；**讲故事优先于堆数据**；
-展示「因为 AI 而不同」，而不仅仅是「用了很多 AI」)：
+Choose the profile language before writing:
+- 用户用中文问或未指定语言 → `output/profile_<YYYYMMDD>.md`，使用中文叙事
+- 用户用英文问或明确要求 English / EN → `output/profile_<YYYYMMDD>_en.md`，使用英文叙事
+- 用户要求 both / bilingual / 两个都要 → 两份都生成
+
+Use **exactly** this structure. For English output, translate headings and prose
+to English following `examples/profile_20260508_en.md`; for Chinese output, use
+the structure below. Technical terms stay in English in both versions. **讲故事优先于堆数据**；
+展示「因为 AI 而不同」，而不仅仅是「用了很多 AI」：
 
 ```markdown
 # <name or github_login> · AI-Native Developer Profile
@@ -709,7 +716,7 @@ xhigh **<n>**（**<%>**）· high **<n>** · medium **<n>** · low **<n>**
 
 ## Step 8b — 海报渲染（v2.4 新增 · 可选）
 
-如果用户说"生成海报" / "AI 海报" / "social card" / "可分享图" / "make poster"，或默认就把它当一份附加交付物，在 markdown profile 完成后再渲染一份 SVG 海报到 `output/poster_<YYYYMMDD>.svg`。
+如果用户说"生成海报" / "AI 海报" / "social card" / "可分享图" / "make poster"，或默认就把它当一份附加交付物，在 markdown profile 完成后再渲染 SVG 海报到 `output/poster_<YYYYMMDD>_<lang>.svg`（例如 `_zh.svg` / `_en.svg`）。
 
 ### 设计原则（来自 v2.4 brief，由 Codex 审校）
 
@@ -873,16 +880,16 @@ xhigh **<n>**（**<%>**）· high **<n>** · medium **<n>** · low **<n>**
 
 ## Step 9 — 输出与交接
 
-把 Markdown 写入 `output/profile_<YYYYMMDD>.md`，
+把 Markdown 写入对应语言的 `output/profile_<YYYYMMDD>.md` 或 `output/profile_<YYYYMMDD>_en.md`，
 然后给用户**一句话**总结：
 
 ```
-✅ Profile generated: output/profile_<YYYYMMDD>.md
-🎨 Poster:    output/poster_<YYYYMMDD>.svg  (如果生成了)
+✅ Profile generated: output/profile_<YYYYMMDD>.md  (或 output/profile_<YYYYMMDD>_en.md)
+🎨 Poster:    output/poster_<YYYYMMDD>_<lang>.svg  (如果生成了)
 关键数字：<sessions> sessions / <tokens> tokens / <github_commits> commits
-预览：head -40 output/profile_<YYYYMMDD>.md
-预览海报：open output/poster_<YYYYMMDD>.svg
-转 PNG：rsvg-convert -h 1920 output/poster_<YYYYMMDD>.svg > poster.png
+预览：head -40 <profile_path>
+预览海报：open output/poster_<YYYYMMDD>_<lang>.svg
+转 PNG：rsvg-convert -h 1920 output/poster_<YYYYMMDD>_<lang>.svg > poster.png
        (或 chromium --headless --screenshot=poster.png poster.svg)
 ```