← ClaudeAtlas

entry-doc-governancelisted

AGENTS.md 类 Agent 入口文档的体积与信息密度治理,以及下沉的安全落地:量 token 与 gzip 密度、按阈值判定,超限后按 Keep/Point/Derive/Delete 判去留,指针化下沉时保证接收方存在、指针可达、无第二事实��、迁移报账,并把守卫装到提交点 fail-closed 强制生效。当遇到「入口文档太长、要不要精简、加这段会不会超限、怎么装门禁、文档太杂要不要拆、下沉后怕丢信息或找不到」这类问题时使用。关键词:AGENTS.md, AGENT.md, 入口文档, 上下文预算, token, 信息密度, 精简, 指针化下沉, 指针可达, 拆分, 归档, 门禁, pre-commit, fail-closed。
ranjiushu/repo-resume · ★ 1 · Code & Development · score 62
Install: claude install-skill ranjiushu/repo-resume
# 文档治理:体积预算与安全下沉 本成员管两件事:入口文档不许膨胀、腐烂成过时副本、出现第二处事实源;以及**下沉必须安全落地**——细节搬走后依然找得到、只有一处、接收方扛得住。好看与排版归 entry-card-craft,文风归 entry-deai-style,三条边界与分工秩序在聚合层 §〇;治理是那条秩序的底线:任何美化都不许用指针弹球和事实模糊来换。 管什么:入口文档与它指向的下游文档的关系。不管什么:整个仓库的通用文档生命周期。命名、层数、拆分形态由环境声明:脚本默认发现 AGENTS.md / AGENT.md,别的命名用 --names 注入。 文档分三层:策略(要什么,稳定)、机制(怎么强制,可替换)、实例(具体值,外置)。判准:一句话里若含只有本环境才成立的专名、数值或形态,它就不属于策略层。 ## 一、核心思想(比脚本更重要) 1. 门禁是一个必被执行的关口。skill 无执行保证(框架没加载、没被选中、人可绕过),不能充当门禁;关口的选法见 §四。 2. 判据用 token 不用字节(字节对中文失真约 3 倍)。体积只是可强制的代理,目标是信息不重复、可导航;越线是信号,不是结论。 3. 上限的目的不是少写,是逼出指针化下沉:信息搬家,不删关键约束。搬之前先审接收方:目标须存在、可用、且尚未持有该事实,绝不搬进失效、超限或重复的容器。 4. 阈值是策略,只有一处。权威值只写在度量实现里,任何地方不抄第二份数字。 5. 量将要生效的版本:有版本控制就量暂存版,没有就量工作区。前提缺失显式响应,不静默换个对象来量。 6. 缺依赖要响,不能静默;哑门禁比没门禁更危险(清单见 §四.1)。 7. 精简砍的是重复、背景、可派生的事实,**不砍因果与最短路径**——「为什么有这条规矩」和「最短怎么用」必须留在读者不跳出去就能明白的地方。变短从来不是合格的证据,删了必要的话反而更糟。(正面标准在 entry-card-craft §一。) ## 二、度量与判据 度量器只读、永不阻断;判据给退出码,供��口 fail-closed 调用。精确用法以脚本自述为准,本文件不复述参数。 | 指标 | 阈值语义 | 处置 | |---|---|---| | token 近似 | 过提醒线 | 提醒 | | token 近似 | 过上限 | 拒绝,先精简 | | gzip 体积 | 过冗余线 | 告警,查重复或灌水 | 数值与适用范围以 --print-policy 及度量实现自述为准,勿抄;别在任何文档里记当前数值(漂移事实),要现状现场量。 人类刻度:人感觉不到 token,感觉到的是页面。实排页数与排版开销由 entry-card-craft 的打印层给出(不阻断流程,但它是终审依据);本判据只用 token,页面归 entry-card-craft §〇 判决。 ## 三、超限了怎么办 先定去留,再动手: | 判定 | 何时适用 | 动作 | |---|---|---| | Keep 留 | 几乎所有任务都需要,稳定,无法派生 | 留在入口 | | Point 指 | 部分任务才需要,有明确归属 | 下沉加指��(下方 2) | | Derive 派 | 可从代码、配置、探针派生 | 删静态副本(下方 1) | | Delete 删 | 历史背景,已失效,无决策价值 | 删除或归档(下方 3) | 0. 先审接收方(§一.3):目标可用吗?该事实已在别处有源吗? 1. 删可由代码或探针派生的事实(计数、比例、