← ClaudeAtlas

repo-resumelisted

把 AGENTS.md / CLAUDE.md 这类 Agent 入口文档写成仓库的「简历」,并把它排成 A4 页面做终审:判准落在人的阅读体验上,按 token 预算精简,超出部分安全下沉成指针,最后在提交点装守卫拦截超限。当「入口文档太长 / 要不要精简 / 写得好不好 / 想看看排出来什么样 / 要不要装门禁」时使用。关键词:AGENTS.md, CLAUDE.md, 入口文档, 仓库简历, 上下文预算, token, 精简, 指针化下沉, 打印 PDF, 页面终审, 排版, 门禁, pre-commit。
ranjiushu/repo-resume · ★ 1 · Code & Development · score 62
Install: claude install-skill ranjiushu/repo-resume
# repo-resume(仓库的简历 · 技能聚合) 入口文档是仓库的简历。要接手的人看它,agent 也看它,而且 agent 通常是第一读者:每次会话开头,这份文件被整份注入。本技能管三件事:写成简历、排成页面看一遍、在提交点守住底线;同时对机器友好:不无限膨胀(不挤爆上下文)、不腐烂成过时副本、不出现第二处事实源、不为了好看牺牲精度。 判断的落点是页面。token 与字节人感觉不到,页数能,所以主线动作是**打印**:把入口文档排成 A4 PDF,通读实排结果(entry-card-craft);体积与阈值是机器侧的代理指标(entry-doc-governance);文风归 entry-deai-style。打印不阻断流程,但它是终审的依据,缺了页面就等于判决没有依据。 这套做法压着一条假设:协作里人仍占主导,人会累也会绕开负担重的东西。人读得进去,才愿意读、愿意改;没人维护的入口文档会烂掉,Agent 拿到的上下文跟着一起错。所以目标是降低人的阅读负担。 组织原则:聚合层只做索引、分工与跨成员约束,不复制成员内容;成员只做策略(不变量)加机制(可替换实现),策略层不写环境专名。 ## 〇、三条边界(约束所有成员,不随「好看」让步) **安全与不可逆约束**(敏感资产、关键路径、fail-closed 关口)照原样写死,不因可读性软化。**精度**不牺牲:事实、路径、命令、判断照准写,不为了顺口变模糊——文档的可信度就是它的功能。**上下文**不破坏:卡片不能长到挤爆 Agent 的默认上下文,超限走下沉(把细节搬走),不走删真相。 ## 分工秩序 三个成员各司其职,但有序:简历式优化是主线(写作加打印终审),治理是底线(体积、下沉与提交点),去味修文风。治理约束不该被好看挤掉;排版挣来的「愿意看」,也不许用指针弹球和事实模糊来换。写文档、改文档、终审文档的场景都可触发去味。 ## 一、关键词速查 | 你说的场景 | 跳到 | |---|---| | 入口文档太长 / 要不要精简 / 加内容会不会超限 | entry-doc-governance | | 量一下当前入口文档的体积与密度 | entry-doc-governance(度量���) | | 下沉后怕找不到、怕丢信息、怕出第二事实源 | entry-doc-governance(安全下沉) | | 给仓库装文档门禁(关键路径上的关口) | entry-doc-governance(安装器) | | 把门禁搬到别的框架 / 别的运行环境 | entry-doc-governance(可移植性) | | 卡片读起来累 / 不好看 / 结构与排版 | entry-card-craft | | 给新项目、新仓库写一张入口卡(简历) | entry-card-craft | | 简历与 README 怎么分工 | entry-card-craft(代价结构与三测试) | | 想看看排出来几页 / 末页是不是只剩一行 | entry-card-craft(打印层) | | 终审要过一遍页面 / 拿不准写得好不好 | entry-card-craft(页面终审) | | 这段文字像 AI 写的 / 去味 / 文风生硬 | entry-deai-style(上游 humanizer-zh) | | 想知道为什么这么定 / 要改判据本身 | entry-card-craft/references/philosophy.md | ## 二、成员 | 子技能 | 用途 |