逐行拆解one-skill-to-rule-them-all的bash脚本ID推导、归档扫描以及你必须防住的三种静默失败【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-allone-skill-to-rule-them-alltask-observer是一个能自动构建并改进你全部技能库的自进化 meta-skill而它的数据底座就是嵌在 SKILL.md 里的两段bash 脚本会话开始时的归档扫描以及每次写入观察之前的ID 推导。这篇文章逐行拆解这两个脚本如何工作以及它们防住的三种静默失败——词法拆分、空结果误判、Shell 不匹配。1️⃣ 先看懂脚本操作的数据结构one-skill-to-rule-them-all 不用数据库用的是一个纯 Markdown 文件目录每条观察即一次技能改进机会的记录是一个独立文件NNNN-短横线标题.mdID 就是文件名的四位数字前缀。目录结构来自 references/observation-log.mdskill-observations/ observation-log/ # 观察日志就是这整个目录 0001-first-fix.md # 每条观察一个文件 0002-slug-name.md archive/ # 已解决的观察移到这里 .id-floor # 曾经发过的最大 ID计数器下限 checkpoints.log # 每次会话一行扫描自身的痕迹关键设计目录列表就是索引frontmatter每文件开头两个---之间的头就是元数据。所以两段脚本永远只读每个文件的头部从不读正文——几百条观察积累后扫描依然很便宜。脚本何时运行做什么归档扫描session-start scan每次会话开始一次只读 frontmatter 建立积压快照 自检 写一行痕迹ID 推导id derivation archival sweep每次写观察之前先归档已解决文件再推导下一个 ID 并创建新文件2️⃣ 归档扫描逐行拆解以写入结束的 frontmatter 扫描完整脚本见 SKILL.md 的会话启动协议逐步拆解用字面路径独立计数n$(find [ABSOLUTE PATH]/... -name *.md | wc -l)。注意这个计数故意不用变量$d而写死字面路径——因为后面的守卫需要两个由不同方式得出的数字互相验证。awk 解析 frontmatter统计以---开头的文件数得到parsed。YAML 嫌疑扫描suspect统计头部值里含未加引号:的文件。这种写法是无效 YAML但提取正则根本不在意——扫描报告一切正常而每个真正解析它的工具都会抛错项目实测过 292 个文件里有 27 个因此不可读。suspect计数就是这条隐疾的早期预警。守卫行全脚本的核心if [ $n -gt 0 ] [ $parsed -eq 0 ]; then echo SCAN COMMAND BROKEN — $n files present, 0 headers parsed; exit 1 fi有文件、却解析出 0 个头 → 这不是日志是空的而是命令坏了立刻exit 1。扫描以写入结束而不只是打印最后一行向 checkpoints.log 追加一行日期时间来源目录。因为加载了技能和真的执行了协议在外部看起来一模一样只有这条痕迹能证明本会话跑过扫描。枚举文件的方式也值得注意find $d -maxdepth 1 -name *.md | LC_ALLC sort | while IFS read -r f; do不用for f in $(find …)也不用 glob——为什么见下文静默失败 ①。3️⃣ ID 推导逐行拆解三方取最大、八进制陷阱与 noclobber 创建完整脚本见 SKILL.md 的 How to Log分三步第一步归档扫描sweep 寄生在 ID 推导里最反直觉的一点归档不是独立步骤而是挂在 ID 推导上——同一条命令在计算下一个 ID 之前先把已解决的文件mv进archive/。作者的理由写在 SKILL.md 的 Archival on Write挂在另一个动作前面的口头义务继承不到那个动作的任何强制力必须总是伴随写入发生的步骤要放进同一条命令里。归档条件两条同时满足status:是actioned/declined/superseded之一且resolved:日期早于今天ISO 日期可直接按字典序比较不需要日期运算parked永不归档。循环自带自计数seen——真正检查过的文件数。若find说有文件、循环却一个都没看[ $n_files -gt 0 ] [ ${seen:-0} -eq 0 ] { echo ARCHIVAL SWEEP BROKEN — $n_files files present, 0 examined; exit 1; }否则循环体从未执行和没有需要归档的输出完全相同。第二步三方取最大推导下一个 IDhi$( { ls $d $d/archive 2/dev/null | grep -oE ^[0-9]; cat $d/archive/.id-floor 2/dev/null; } \ | sed s/^0*\([0-9]\)/\1/ | sort -n | tail -1); : ${hi:0}三个输入取最大活动目录的最大数字前缀、归档目录的最大前缀、.id-floor历史最高 ID——当活动目录因全部归档而清空时计数器永远不会从 1 重新开始。两个细节sed剥零前缀是承重结构不是装饰shell 算术把带前导 0 的数当八进制$(( 0105 1 ))得到70——ID 悄悄算错且无报错含 8 或 9 的前缀如0108更是直接非法八进制报错。解释见 SKILL.md。ID COMMAND BROKEN 守卫日志非空却提取不到任何 ID →exit 1。它区分日志说零和我读不到日志。第三步noclobber 创建文件f$d/$(printf %04d $next_id)-slug.md [ -e $f ] { echo COLLISION — $f exists; re-derive the id; exit 1; } (set -C; : $f) || exit 1 # noclobber: 只创建绝不截断两个并行会话选中相同 ID且相同 slug 时会解析到同一个路径第二个写者会静默覆盖第一个。set -Cnoclobber拒绝覆盖已存在的路径——只有这次创建成功之后才允许写入正文撞了就重新推导 ID。4️⃣ 你必须防住的三种静默失败静默失败最大的代价是退出码为 0。下面三种都是项目真实踩过的坑。静默失败 ①词法拆分——路径含空格扫描静默检查 0 个文件至少一种常见安装方式的默认共享文件夹名含空格。如果你写成for f in $(find $d -name *.md); do ... done路径会在空格处被拆成两段不存在的文件错误打印到没人读的地方外层命令照常成功——扫描检查了零个文件却上报一个干净的空积压那个永远不会被质疑的答案SKILL.md 原文。修法项目脚本已内置路径全程双引号枚举用find -print0 | while IFS read -r -d f用find而非 glob 枚举zsh 默认 nomatch 下不匹配的 glob 会在第一次迭代前就中止整个循环。静默失败 ②空结果被当成日志是空的——坏命令不是空日志一个0是二义性的可能是没有数据也可能是问题根本没被问到。项目规则Every instrument gets the same guard任何产生数字或列表的命令空结果都算是对该工具本身的指控直到独立探测证明群体确实为空。落地要求Guard the read, not just the write文件计数来自字面路径而不是解析循环所用的变量断言比较的是两个以不同方式得出的数字数字不一致就exit 1——SCAN COMMAND BROKEN和ID COMMAND BROKEN是同一条规则的两个实例。真实案例一次按相关性 grep的最高命中是 ID N被当成下一个 ID 是 N1——而真正的最大值躺在 archive 里比它高 20。这就是为什么脚本要求每次写入前立即重跑而不是这次会话已经看过日志了。静默失败 ③把 bash 脚本跑在 sh 下——循环读不到东西还退出 0read -r -d 是bash 扩展dash和ash没有。在sh下运行最好情况是报 usage 错误最坏情况是循环读不到任何东西、退出码 0——和词法拆分一模一样的静默成功SKILL.md。更深的坑macOS 原装/bin/bash至今是 bash 3.2它会在第一个不配对的)处结束命令替换——所以$( … )里的case模式必须加括号写成(pattern)而不是pattern)。否则整段在解析期就报syntax error near unexpected token ;;两个 BROKEN 守卫一个都触发不了因为守卫无法报告发生在它自己存在之前的失败bash 3.2 端口性详解。规则脚本一律显式用 bash 运行移植或自写脚本时先bash -n file只解析不执行安全。速查表静默失败现象守卫手段① 空格路径词法拆分扫描/归档检查 0 个文件命令却成功上报空积压-print0read -r -d 、全程双引号、用find枚举② 空结果 坏命令非空日志上报 0 文件 / 0 头字面路径独立计数 数字不一致即exit 1③ Shell 不匹配循环读空退出 0bash 3.2 解析错误整段夭折显式 bash 运行case模式加括号5️⃣ 附赠两个小守卫suspect 计数frontmatter 里未加引号的:会让扫描一切正常、但所有真解析器抛错。项目规则是所有散文值一律双引号——实测 27/292 个文件因模板本身未加引号而不可读教训足够惨痛观察日志参考。checkpoints.log 痕迹时间区分同一天内的不同会话括号里的来源目录区分不同项目——这个文件天生是多项目、多会话共享的。6️⃣ 源码位置与完整脚本资料路径内容核心技能脚本权威副本SKILL.md会话启动扫描、ID 推导 归档扫描、八进制解释完整原理与守卫references/observation-log.mdID 脚本与守卫、bash 3.2 与 case 括号、守卫读操作一次性迁移脚本scripts/migrate-log.py3.0 之前单文件 log.md 的脚本化转换包校验脚本scripts/validate-skill-bundle.py安装前校验技能包是否完整两个阅读提示SKILL.md 里的片段是权威副本参考文档里的是供上下文中阅读的重印若有出入以核心文件为准脚本里的[ABSOLUTE PATH]是占位符实际使用时替换成你固定的工作区绝对路径——路径可能含空格务必保持双引号。写在最后归档扫描 独立计数 不一致即退出 写入留痕ID 推导 归档寄生在必经步骤里 剥零防八进制 noclobber 只创建不截断。三种静默失败有一个共同点退出码都是 0。而项目对它们的回答也一致——让工具本身在失败时大声喊出来。【免费下载链接】one-skill-to-rule-them-allThe meta-skill that builds and improves all your skills, including itself. Watches your work sessions (autonomous or human-led), captures patterns, corrections and judgement calls, and turns them into skill improvements and new skill candidates for your review. Practical application of the Augmented Expertise methodology. Open source: CC BY 4.0.项目地址: https://gitcode.com/gh_mirrors/on/one-skill-to-rule-them-all创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考