跳到主要内容

审查 tu-jie-skill-ai-ti-xiao — 2026-08-27

结论: PASS(附 2 条交卷前待办,见问题清单 1、2;均不涉拆解正文,一条命令可修)

门禁实跑(末行原样):

book-verify: 1 本有拆解、共 695 处出处、0 处对不上        (另: 695 出处 + 2 处书架锚,0 处对不上)
book-jargon: 1 本,共 0 处专业词没解释就用了               (70 个专业词首次出现处都有解释)
生面孔配额: 段级超额 0 处(上限 1)、节级超额 0 处(上限 5)   (--quota)
book-dodged: 1 本,共 0 个词被躲开(阈值:原书出现 ≥15 次)

另跑:book-review → 「2 处书架锚 — 需复核 0 · 没记 commit 2 · 没写「事实=」0 · 指不到 0」; docs-lint → 48 处(宽松期只报不拦;反引号 16 处全是脚注地址,按守则豁免)。

审查记录(按收尾自检表)​

  • 完整性:前言+7 章+结语 9/9 全覆盖。8 个拆解章的 sourceChapters 与 library/.../chapters.json 一一对上(前言+第1章→01;第2章按新词密度拆成 02/03;第36章→0407;第7章+结语→08)。 切分理由写进了 notes/01-outline.md 且「进来/出去」格式齐全。
  • 抽 6 条脚注回核原文(超出要求的 5 条,全部属实): 02-ch01.txt:572「只扫描每个技能的名片」、03-ch02.txt:9「撑爆」、05-ch04.txt:142「第十次」、 06-ch05.txt:239「触发者是你」、07-ch06.txt:483「3000 字…1800 字」、08-ch07.txt:485-486 「2.27 简单平均 / 2.17 加权」——原文都说了拆解声称的事,搜「…」短语均为原文真实存在的字。 另抽 3 条原文地图地址(06-ch05.txt:918 posts、08-ch07.txt:860-861 日期判据、07-ch06.txt:191 六维度)逐一命中。
  • 红线二(主走查落位):01§3 周报两遍、02§3 查天气五步(带 JSON 字串)、03§4 三层加载五步、 04§2+§4 数据分析报告拆类与分工表、05§2 四步循环(带「老兵→从业者」前后对照)+§3 十一行转录稿 (§3 标注为另起一处——约束/模板/流程三种机制落不到同一条走查上,守则允许「一章最多另起两处」)、 06§4 三版草稿派单现场、07§5 记分表走查(3000/1800 字、60% 超线)、08§3 V1 对 V2(r=-0.79、 #27 行亏损投放)。全部落在正文,带具体的数、字串或状态;书外编的数已标「演示编的」 (02§3 第④步天气值),书内数核实确系原书(07§5 的 80/85/30/90 出自 07-ch06.txt:467)。
  • 红线三(生词):四条机检全绿之外人查了重点词:LLM、提示词、智能体、token(1 汉字 0.5~2 词元、 全书按 1.3 折算)、渐进式披露、系统提示词、幻觉、gotchas、YAGNI、Eval、hook、ROI/GMV——均就地解释, 「出门会撞见」的名字(top-p 类比不过,但 description、pandas、ffmpeg、.claude/skills 等)都留了名。
  • 台阶抽查:01§3、03§3、03§6 把每段首句抄成一列连读,不跳(03§6:「欠下的原理 → 底层事实注入 系统提示词 → 所以首要读者是 AI → 怎么判断 → 由此推出白写 → 两种代价 → 被冤枉的惰性 → 怎么写 → 两个陷阱 → 反向触发词」)。
  • 判断块:全书共 5 处(02§4 ×1、index §5 ×3,另 05§7/07§7/08§7 的「书里的判断」均按证据/断言分档), 每处都带「如果错,会错在」,可证伪条件具体(如「如果这些数字在大样本下确实稳…判据是可复现的对比实验」)。
  • 总纲:六节齐全;§2 主线十步是一条因果链(硬约束→三层→唯一开关→拆任务→三种写法→组合→工程化→ 实战→收束),只留效果句,机制细节留章层,海拔合格;许诺兑现表 18 行,抽查 8 行(①③④⑤⑨、 01§3/§7、03§3、05§7)全部兑现且兑现的是许诺的那件事。
  • 书卡:readState=read、readChapters 9/9、claims 5 条、notCovered 4 条、summary、soWhat 全填, 与拆解实际覆盖一致(notCovered 的「效率数字是体感」「平台快照会过期」在 01§6/08§7 均有对应交代)。
  • 台账泄漏:零。正文无格式/许可/清洗统计;03§4 提到 license 是 SKILL.md 字段本身,属内容。
  • 诚实(三个声音/利益相关):index §1 如实交代——宝玉 2026 年春、实践者写自己每天在用的方法论、 自带 baoyu-skills(1.7 万 Star)与「示例默认 Claude Code(发源地)」的平台偏好,并声明「这是一本快书」; 书卡「利益相关明摆着」+ index §5 第三判断块对效率叙事打折,分层清楚。书里的坦白(写书技能失败、 注意力稀释无量化研究)均照实保留。
  • 规范互补关系(重点核):index §5 判断块「规范给格式与约束(6 字段、1024 字符上限、三层 token 预算), 本书给动机与用法」——与 ../ai-protocol-reference/docs/agent-skills-spec/01-spec-format.md 逐条吻合: §1.3 六字段表(name ≤64、description ≤1024、2 必填)、§1.5 三层 token 预算表(元数据 ~100/个启动全载、 正文 <5000 激活时、资源按需)、§1.6「相对路径且一层深」。2 处书架锚(01[^34]、03[^24])的「事实=」 均与该文件对应内容一致。
  • 「图解风险不存在」独立验证(抽 2 章):逐一检查第 2 章 15 张图(图 2-1~2-15)与第 4 章前 5 张图 的图注前文——每张图前一段已用文字把该图内容说完整(「如图 X 所示」只是指认,无「仅见图」的信息); 表 2-3 等表格在清洗文本中以文字形式完整存在。194 页/12.6 万字符、无大片乱码,写手判断成立。
  • chapterAddressable 状况(任务书前提与库内记录不符,以库内记录为准):任务书称「无书签书 chapterAddressable=false」,但 chapters.json 与书卡均记 chapterAddressable: true(转码器经回退 启发式切出 9 章、9 个正文文件,book-validate 未对此书报不一致)。全部 695 处出处一律「文件+段号」式 (text/xx.txt:N + 搜「短语」),无页码式、无章节名式,格式完全一致——无论书签有无,锚是可回核的, 实测 695/695 通过。书卡已如实标注该状况。

问题清单​

  1. [01-from-prompt-to-skill.md[^34]、03-progressive-disclosure.md[^24]] 两处书架锚缺 @<commit> — 违反 BOOK-TEARDOWN ② 类脚注格式(依据: shelf=<库>/<源>#<章> @<commit> 事实=…;book-review 亦提示 「新写的锚要当场记,不许靠 --stamp 补」)——锚内容本身核过无误,但没记 commit 就查不出将来上游重写导致的腐烂 — 修:node scripts/book-review.mjs tu-jie-skill-ai-ti-xiao --stamp 补上当前 sourceCommit(交卷前待办)。
  2. [仓库层] 生成物漂移:docs/index.md、aiRef/INDEX.md、aiRef/index.json 停在 09:11, 本拆解(17:08–17:15 写成)尚未收进生成索引,book-validate 因此报「生成物漂移」 — 违反状态真相契约「改动的同一轮重新生成索引」(批量模式下多书在飞,属共同状态,不单是本书的错) — 修:本批全部书交卷后统一跑 node scripts/book-build.mjs 再提交。 (book-validate 另一条 ERROR 是 tu-jie-ji-qi-xue-xi-suan-fa 的行号漂移,属别的书,不计入本书。)
  3. [01-from-prompt-to-skill.md §5,低危] 三步排查写成通用的「智能体在启动时扫描技能」,而原书 同时讲了 OpenClaw 的例外(修改 SKILL.md 免重启,文件监听自动刷新,02-ch01.txt:158-160), 该例外目前只留在 notes/reading-notes.md — 「读完就不必看原书」丢了一个平台例外 — 修:第二步后补半句「(OpenClaw 例外:文件监听自动刷新,改完即生效)」。
  4. [index.md §2,低危·advisory] 主线 ④⑤⑥⑧⑨ 五步为 5 行块引,docs-lint 记「段落墙」 (行文十三条第 5 条:一段不超过三四行;样板书 index 零命中)— 不拦 PASS — 修:润色时把 5 行的步骤折成 3-4 行或改为分点。

通过判定​

收尾自检表逐项过(完整性/生词/台阶/走查/句子/数字/许诺/总纲/出处/分层/诚实/来源/干净/版权/锚没腐烂), 四条门禁全绿,6 条抽查出处全部属实 → PASS。问题 1、2 为交卷前待办,3、4 供润色参考; 「主人认可」一项归 book-verdict,不在本次审查范围。