诊断与手法库
何时读我:进行到工作流 Step 1(需要诊断清单)或 Step 2(需要选择手法)时读取;平时不读。 本文件是方法参考,读完用方法,不把本文件内容写回目标技能。
A. token 浪费诊断清单
| 症状 | 诊断 | 处置 |
|---|---|---|
| SKILL.md 超 300 行 | 必读体积过大 | 分层加载,拆出 references |
| 同一文件在任务中被 Read ≥ 2 次 | 重复读取 | 查根因:是忘记还是上下文被压缩 |
| 任务中途 AI 反复读同一文档 | 压缩-重读循环 | 把关键信息固化成薄接口卡 |
| 文档里混着坐标/数字/长参数 | 数据误入文档 | 数据移到存储或脚本,文档只留方法 |
| 每次任务都全量读一份大 references | 路由不清 | 拆分小文档 + 加路由表 |
| 更新日志/经验库无限增长 | 文档膨胀 | 滚动保留最近 N 条,旧记录归档 |
| 两个技能重复讲同一理论 | 重复内容 | 一方引用另一方,不重复写 |
B. 优化手法详表
B1 分层加载(核心)
把 SKILL.md 拆为「核心卡 + 路由表」,细节移入 references。判断标准:
- 必读:触发词、铁律、模板索引表、路由表 —— 留 SKILL.md;
- 按需:启动排障、技法细节、配色库、标定流程、沉淀 SOP —— 移 references;
- 可删:已被子文档接口卡覆盖的旧说明、过程记录、旧日志。
B2 路由表(拆分的前提)
拆完必须加路由表,否则 AI 不知道读哪份:读少→缺信息返工,读多→全读不省。
格式:| 场景 | 读什么 |,场景按「任务环节/触发条件」写,如「仅换机型时」「仅画细线时」。
B3 接口卡(切断重读循环)
每份沉淀产物配一张 ≤30 行的接口卡,写清:执行命令、参数表、回执字段怎么读。AI 只读接口卡即可执行,不必读大脚本。
B4 数据代码分离
一切运行期数据(坐标、数值、路径)进存储或脚本;文档只写「去哪读」,不写「值是多少」。防止文档随数据膨胀,也防止 AI 误用陈旧值。
B5 引用复用
方法论、理论、通用流程若已有技能覆盖,直接引用其技能名,不重复撰写。例:控制论理论底座引用 cybernetic-thinking-yashu,本技能只在 SKILL.md 写三条引用原则。
C. 案例拆解(qiu-skin-draw-yashu,2026-09)
症状:SKILL.md 340 行每次会话全量加载;其中约 60% 内容只在特定环节需要。
拆分前 → 后:
| 内容 | 拆分前 | 拆分后 |
|---|---|---|
| SKILL.md 必读 | 340 行 | ~100 行(核心铁律+模板表+路由表) |
| 前置服务启动 | 正文 | references/启动与排障.md(仅异常时读) |
| 画曲线经验 | 正文 | references/画曲线经验.md(作画规划时读) |
| 标定 SOP | 正文 | references/标定SOP.md(仅换机型时读) |
| 沉淀 SOP | 正文 | references/沉淀SOP.md(仅沉淀时读) |
| 配色库 | 正文 | references/配色库.md(画对应题材时读) |
收益估算:常规作画任务 340→~130 行(省约 60%);换机型标定 340→~170 行(省约 50%)。
关键教训:拆分前先列路由表;每份子文档顶部自带「何时读我」说明;不删铁律只删细节。