Repo Resume — Git skill for Claude Code

repo-resume

**Your repo's resume, kept hireable for humans and agents.**

[](LICENSE) [](#运行环境) [](#运行环境)

repo-resume 是一个 Agent 技能：把 `AGENTS.md`、`CLAUDE.md` 这类入口文档写成仓库的简历。接手的人读它，agent 每次会话开头也整份读它，而且读得比人勤。项目长大以后简历膨胀成百科，每次开工得先重读一遍。

**把它当简历来写：常驻的那份短到能一口气读完，超载就拦。** 判据落在两处：

• 常驻上下文保持短，超出预算的知识下沉成指针。
• 简历要给人读：排成 A4 通读一遍，再交付。
• 超限在提交点拦下，fail-closed，不留侥幸。
• 兼容 AGENTS.md / CLAUDE.md / SKILL.md，自定义命名用 --names 注入。

判决看页面

人感觉不到 token 和字节，感觉到的是页数。所以本技能的主线是打印：把入口文档排成 PDF，拿它当终审的依据。

为什么多这一步

Markdown 本来就能读，再排一遍看着多余。理由是页面比源码诚实：编辑器里一行超长的表格只是一坨，排到页面上才看得出它散架。多排这一遍，买的是「通读」这个动作：人读得进去，才会读、才会改、才会把自己的判断放进来；没人维护的入口文档会烂掉，Agent 开工拿到的上下文跟着一起错。代价是 1–2 秒加一次浏览器渲染，换不来内容，也管不了机器侧的预算（那是守卫的事）。理由写全在 [entry-card-craft/references/philosophy.md](entry-card-craft/references/philosophy.md)。

bash entry-card-craft/scripts/print-entry-doc.sh SKILL.md entry-*/SKILL.md

📄 SKILL-20260917-114423.pdf（工作区版）实排 2 页｜算术 1.2 页｜排版开销 +0.8 页
📄 entry-card-craft-SKILL-20260917-114426.pdf（工作区版）实排 2 页｜算术 1.6 页｜排版开销 +0.4 页
📄 entry-deai-style-SKILL-20260917-114428.pdf（工作区版）实排 1 页｜算术 0.6 页｜排版开销 +0.4 页
📄 entry-doc-governance-SKILL-20260917-114430.pdf（工作区版）实排 3 页｜算术 1.9 页｜排版开销 +1.1 页

这行结果里有两样东西。实排页数是给人看的刻度；算术页数的差是**排版开销**，表格、短行、项目符号的留白都记在它头上。末页只剩一点点时脚本会自动紧排一次，真少一页才采用，产出标「末页合并」。简历不给人留一行空白页。

正文用衬线体（Georgia 加思源宋体，标题黑体），对标 Typora 的输出质量。产出默认落在仓库的 `.git/` 下，用 `--out`、`--archive` 指定集中位置。

打印不阻断流程：单份要 1 到 2 秒，还依赖无头浏览器（设 `CHROME_PATH` 或自动探测），所以挂 post-commit，永不返回非零。这不是说它次要：**守卫管有没有失控，页面管读不读得下去。**缺浏览器时脚本会明说这次没排成，终审据此标注「未经页面终审」，不装作看过。

快速开始

量一次，只读不阻断；阈值不抄进文档，问度量器要权威值：

python3 entry-doc-governance/scripts/measure.py AGENTS.md
python3 entry-doc-governance/scripts/measure.py --print-policy

装到提交点（`--check` 校验安装状态）：

bash entry-doc-governance/scripts/install-hook