助手

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

核心理念

"找到最小的高信号 token 集合,最大化期望结果的可能性。" — Anthropic 目标是最大化信息效率、可读性、可维护性。 本 skill 自身遵守渐进式披露:新方法论以"精炼规则 + 触发条件"留在 SKILL.md,深度战例 / 引文沉到 references/。SKILL.md 行数由信息密度决定、不设为硬目标(约 500 行量级;新增高价值规则可略超,但深度永远沉 references)——skill 自己示范它教别人的事:行数不是 KPI,自洽地不拿"≤N 行"约束自己。

铁律:行数禁作 KPI,可作诊断症状

禁作优化目标 / 成功指标(不可削弱——案例 7/8/9 的防线就是这条): 行数少不代表更好,行数多不代表更差 评判标准是:单一信息源(同一信息不在多处维护)、认知相关性(当前任务不需要的信息不干扰注意力)、维护一致性(改一处不需要同步另一处)——不是行数 禁止在优化方案 / 总结中出现"从 X 行精简到 Y 行"、"减少 Z%"作为成果 禁止把"减少行数"作为移动 / 删除某内容的理由

但「两层」只是文件层——先选载体,再选层级

渐进式披露不是一个文件内部的事,它在多个层同时发生:MCP 懒加载工具、RAG 按需取知识、 Skills 描述常驻正文按需、以及 Claude Code 的动态工具选择(工具索引层的渐进式披露)。 只在 CLAUDE.md 内部搬 L1↔L2,等于把下表四种载体里的两种(常驻 L1 / reference)当成全部。 先问载体,再问层级。 判据一句话:模型能不能在违规之前就知道自己需要这条规则? 违规可恢复 · 违规不可恢复

多入口原则(重要!)

同一 Level 2 资源可以有多个入口,服务于不同查找路径: 入口 · 位置 · 触发场景 · 用户心态 Reference 索引 · 开头 · 遇到错误/问题 · "出 bug 了,查哪个文档?" 修改代码前必读 · 中间 · 准备改代码 · "我要改 X,要注意什么?" Reference 触发索引 · 末尾 · 长对话定位 · "刚才说的那个文档是哪个?"

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@daymade · 未声明许可证
上下文用量评级
中等消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux
运行环境要求
Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
  • 读取环境变量
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
Step 2: 内容分类

分三阶段。先测量,再分诊,再分层——跳过测量会把力气花在小头上,跳过分诊会把噪音忠实搬进 Level 2,把 reference 变垃圾场。 2.0 热点测量(先于一切提案——性能优化的第一课) 先量化,后动手;按贡献度排序,先打最大的。 优化提案落在 3% 的小头上、而 70% 的热点在旁边没人动,是本 skill 实战里被用户当场打断的真实失败(案例 19:一份 168KB 的全局 CLAUDE.md 占每 session 启动上下文 69%,执行者却先端出一盘扩展清理——用户原话「你没有先去管热点,而是先找了一堆很小很小的东西」)。测量四步(`scripts/profile_claude_md.py` 产出第 2/3 步;第 1 步是会话内命令、第 4 步手查各消费方配置): 全局占比:`/context` 看这份文件在整个启动上下文里占多大——确认它是不是热点,还是别的类别才是 分节字节表:按 heading 统计每节 bytes/lines 并降序——工作顺序 = 这张表的降序(⚠️ 父节字节含全部子节:降序在同层之间比较,容器节跳过看它最大的子节);提案端出去前自问:这是当前最大贡献者吗?不是的话,最大的那个为什么不在最前面?

02
Step 3: 创建 Reference 文件

命名:`docs/references/{主题}-sop.md` 铁律:原样移动,禁止压缩 移动内容到 Level 2 时,必须完整保留原始内容。不要在移动的同时"顺便精简"。 为什么:压缩 = 变相删除。你认为"不重要"而删掉的内容,可能是某个未来 debug session 的关键线索。优化的目标是改变信息的位置(Level 1 → Level 2),不是改变信息的存在。 怎么做:

03
Step 4: 更新 Level 1

在开头添加「信息记录原则」(项目概述之后,Reference 索引之前) 添加 Reference 索引(紧随信息记录原则之后) 用触发条件格式替换详细内容 保留代码模式和错误诊断 添加「修改代码前必读」表格(按"要改什么"索引)

04
Step 5: 验证(三项全部通过才算完成)

5.0 先标定判据本身 —— 验证器会骗你,而且两个方向都会 下面 5a/5b 全建立在 `grep`/`find` 上。一个错的判据会和对的判据一样自信地报告结果, 而这一步的产物(「这段已经下沉了」「这个指针是真的」)会被当成事实写进交付。 所以:先在一个你已知答案的样本上跑一遍判据,确认它真的会命中,再用它去查你不知道答案的。 这一行成本,把「我查过了」变成「我用标定过的判据查过了」。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。