1 概览

• 自 3 月起本频道持续追踪 huangwb8/skills，从 v2.10.0 一路走到 v4.1.2，本次衔接上一篇的 auto-draw-plot，聚焦最近一周的两个新版本 v4.1.3 与 v4.2.0
• v4.2.0 是近几个月影响面最大的一次底层变更：所有 skill 的中间产物目录统一收敛到 .bensz-api/skills/<技能>/{input,output,log}，散落各处的隐藏工作区第一次有了一个共同的"家"
• 同步引入目录唯一分配机制，同一分钟多次运行自动追加 -02/-03 后缀，告别"后一次覆盖前一次"的糟心体验
• v4.1.3 让 parallel-vibe 默认进入"智能模式"，用宿主原生 subagent 在独立上下文里真正并行思考，主 agent 统一汇总
• 配套的 init-project .gitignore、install-bensz-skills 的 legacy 清理、双安装器同步约束一并跟进，让这次"大搬家"落得干净利落

2 前言

自 3 月上旬本频道第一次报道 huangwb8/skills 以来，这条版本叙事线我们已经断断续续追了三个月、九篇文章。把这条线拉直了看，脉络其实一以贯之：v2.x 时代是技能数量的扩张和安装机制的反复打磨；v3.0.0 引入 bensz-collect-bugs，让"发现问题—记录—反馈"第一次形成质量闭环；v4.0.0 用纯 Python 安装器统一了全平台体验，并给子代理立下安全规矩；v4.0.1 到 v4.0.4 让 awesome-code 完成从"脚本替 AI 做决策"到"AI 自主规划"的架构重构，auto-test-code 顺势上线；v4.1.0、v4.1.1 把 BAC 贡献追踪扶正为默认基础设施，又补上期待已久的 --skill 精准安装；上一篇我们聊了 v4.1.2 的 auto-draw-plot，让技能库第一次长出"画图"能力。上次发文停在 6 月中旬的 v4.1.2，距今正好一周。

这一周里仓库连发了两个版本：v4.1.3（2026-06-14）和 v4.2.0（2026-06-21）。前者把 parallel-vibe 默认切到了"智能模式"，后者乍看只是个小小的 Patch 号，实际却是近几个月动静最大的一次底层重构——它没有新增任何技能，却动了几乎所有技能的"地基"：把过去散落在项目各处的隐藏工作区目录，统一收敛到一个叫 .bensz-api 的命名空间里。如果你一直在用这套 skills，升级之后第一眼能感知到的变化，大概率就来自这里。这次咱们先把这个"大搬家"讲透，再回头看 parallel-vibe 的智能模式。

3 v4.2.0：工作区秩序重塑，所有产物收进 .bensz-api

3.1 散落的工作区：从"各占山头"说起

如果你平时就在用 skills 这套生态，大概率已经在自己的项目根目录里见过一堆神秘的隐藏文件夹了：跑过 auto-draw-plot，会冒出一个 .draw-plot/；用过 git-pr-review，会留下 .git-pr-review/；awesome-code 会生成 .awesome-code/，镜像优化会丢一个 .mirror/，auto-test-code 甚至直接把中间产物扔进 tmp/ 和 tests/。每个技能各自为政，命名风格五花八门，有的带点号、有的不带，有的用技能全名、有的用缩写。技能少的时候还好，技能一多，git status 里就是一片乱糟糟的"杂物间"——你既分不清哪个目录是哪个技能的产物，也搞不明白能不能删。更要命的是命名冲突和产物覆盖：同一分钟里某个技能跑两次，后一次的产物就把前一次冲掉了，想回溯都找不到证据。v4.2.0 要解决的，正是这个积累了很久的"脏乱差"。它的思路很直接：与其让每个技能继续圈自己的地，不如统一规划一个安置区，所有技能的中间产物都搬进去，按统一的层级组织好。

3.2 统一的命名空间：input / output / log 三段式

新的安置区长这样：.bensz-api/skills/<技能名>/，每个技能在自己名下再分三个固定子目录——input（放输入和原料）、output（放最终产物）、log（放运行日志和留痕）。于是迁移之后，.draw-plot/ 变成了 .bensz-api/skills/auto-draw-plot/，.git-pr-review/ 变成了 .bensz-api/skills/git-pr-review/，.awesome-code/ 下那些 reports、benchmarks、logs、cache 整体搬进了 .bensz-api/skills/awesome-code/，连镜像优化的 .mirror/ 都归拢到了 .bensz-api/skills/mirror-optimizer/output/；auto-test-code 原来散在 tmp/ 和 tests/ 的东西，统一进了 .bensz-api/skills/auto-test-code/<时间戳>/output/tests/。这个变化的好处是实打实的：往后再看到 .bensz-api/ 这个名字，你就知道这是 skills 生态的"自留地"，进到里面按技能名一找，输入、产物、日志各归各位，清清爽爽；想整个忽略掉，也只需在 .gitignore 里写一行 .bensz-api/ 就够了，再也不用挨个技能去收集它的隐藏目录名。

3.3 目录唯一分配：同一分钟跑两次，不再互相覆盖

光搬个家还不够，v4.2.0 还顺手解决了一个更隐蔽的痛点。像 auto-draw-plot、compact-bensz-skills、git-pr-review 这类技能，时间戳目录名是按"分钟"打的，可要是你在同一分钟里连着跑了两次，第二次的产物就会把第一次的目录整个盖掉，等你回头想看第一次的结果，早就没了。这次新增的"目录唯一分配机制"就是冲着这个来的：检测到同一分钟的目录已经存在时，它会自动追加 -02、-03 这样的后缀，让每一次运行都有自己独立的落脚点。配合 git-pr-review 报告文件名和 manifest 里新加的 run_id 字段，意味着每一次运行都是可单独指认、可回溯的，"后浪覆盖前浪"的憋屈事儿基本可以翻篇了。

3.4 时间戳可读化与配套治理

还有一些细节上的打磨，单独提一句都不起眼，合在一起就让整套工作区舒服不少。目录名里的时间戳统一成了 %Y-%m-%d-%H-%M 这种人眼好读的格式，原来夹在中间的 run_prefix 被收敛成空，目录名看着更干净；parallel-vibe 的默认目录也从 .parallel_vibe 统一成了 .parallel-vibe（连字符规整），下游 git-pr-review 的路径契约同步跟上。配套层面，init-project 的 .gitignore 模板新增了 .bensz-api/、/.bensz-api/、.parallel-vibe/ 的忽略规则，新建项目时这些目录会被自动忽略；install-bensz-skills 则新加了 nsfc-roadmap、nsfc-schematic 这类已废弃技能的 legacy 清理，装新版时顺手把系统里残留的旧目录扫干净。值得一提的还有，AGENTS.md 里明确写下了"双安装器业务逻辑同步"的约束——也就是说 install-bensz-skills/scripts/install.py 和 @install/install.py 这两个安装入口，往后必须保持行为一致，不会再出现"用 A 装和用 B 装结果不一样"的尴尬。唯一一个小修复也和这次搬家有关：迁移过程中全局替换误伤了 mirror-optimizer 里 Dockerfile.mirror 的文件名，这个版本顺手改了回来。

4 v4.1.3：parallel-vibe 默认进入"智能模式"

在 v4.2.0 这个"大搬家"之前，v4.1.3 给 parallel-vibe 带来了一次定位上的升级。熟悉的小伙伴应该知道，parallel-vibe 一直是 skills 里负责"多路线并行尝试"的技能——同一个问题，开几条线分头去试，再汇总出最优解。但它过去的"并行"更像是"跑脚本"，依赖一个 CLI runner 去调度，启动成本不低，每条线的分析也谈不上真正的独立思考。v4.1.3 把默认模式切成了"智能模式"：不再硬跑 CLI runner，而是直接用宿主原生的 subagent，让每条线在各自独立的上下文里分析，最后由主 agent 统一汇总。说白了，就是从"跑脚本"升级成了"真正的并行思考"。贴心的是，智能模式和保留下来的代码模式共享同一套 .parallel-vibe/<project_id>/ 目录契约，plan.json、workspace/、RESULT.md、runner.log 的结构完全一致，两种模式之间切换几乎零迁移成本；新增的 references/smart-mode-protocol.md 也把 thread 输出 schema、汇总 schema、串行/并行策略，以及"独立上下文不等于文件系统隔离"这条边界说得很清楚，避免大家误以为智能模式下各线程就互不干扰了。

5 小结

如果说 v4.1.2 的 auto-draw-plot 拓宽了 skills 能"做什么"，那 v4.2.0 这次的工作区大一统，补上的就是 skills "做完之后留下的痕迹该怎么管"。从 .draw-plot、.git-pr-review、.awesome-code、tmp/ 这些各占山头的隐藏目录，统一收敛到 .bensz-api/skills/<技能>/{input,output,log} 的三段式结构，再加上目录唯一分配、时间戳可读化、.gitignore 与 legacy 清理的同步跟进，对每一个日常使用 skills 的开发者来说，都是一次能直接感知到的"清爽化"升级。夹在中间的 v4.1.3，则用 parallel-vibe 的智能模式默认化，让多路线并行从"跑脚本"走向"真并行思考"。技能越加越多、产物越来越杂的当下，这种主动给"地基"做整理的版本，反而比新功能更让人踏实 (～￣▽￣)～

项目地址：https://github.com/huangwb8/skills