Skip to content

v0.2.0:拆成三条车道、修复技能不可见、补 Claude Code marketplace

Choose a tag to compare

@taxueseek taxueseek released this 27 Oct 09:23
· 16 commits to main since this release

v0.2.0 是一次结构性版本:技能从一份 271 行的单体文档,拆成主入口加三条车道子技能,同时修掉「description 超限导致整条技能在宿主里不可见」的真故障。

相对上一版的改进

  • 技能可见性修复:主描述从 1058 字符压到 332。ZCode 加载器对 description 有 1024 硬上限,超限不是截断而是整条丢弃,之前技能在列表里完全不出现。
  • 主文档瘦身:SKILL.md 从 271 行收到 103 行,只保留三车道路由、一键编排、跨车道纪律与安全边界;细节下沉到三份车道文档。
  • 自检零副作用:指南缓存根可注入,npm test 不再把合成 dist-tags 写进真实缓存;可再生的缓存与需要保留的运行台账分开存放,台账迁到 ~/.local/state,避免被清理工具整目录扫掉。
  • doctor 判定修正:扫描没有真正跑过时判 host-log-clean-scan-unknown,不再给出「无事可做」的假一致。
  • 参数顺序与路径修正:run.mjs 改用 parseArgv,插件目录写在布尔开关之后也能识别;三份车道文档统一按工具根目录执行,软链别名单独加载时不再指向不存在的 scripts/。
  • 否定缓存:上游 npm 已发版但 GitHub 标签未打时,guide-sync 记 1 小时否定缓存,dist-tags 变化即作废,省掉每次注定失败的 clone。
  • 自检 129 → 140 项:新增参数顺序、doctor 新判定、否定缓存两条、车道命令路径门禁。

新增能力

  • 三条车道:adapt 管升级适配与破坏性变更扫描,build 管五形态脚手架与体检门,diagnose 管宿主启动与环境故障。主技能按意图只读对应车道,不再一次加载全部内容。
  • 独立触发面:dsh-plugin-build 与 dsh-plugin-diagnose 可建顶层别名单独注册,不必挤在主技能一个 description 里。
  • Claude Code marketplace 清单:仓库补上 .claude-plugin/marketplace.json 与 plugin.json,README 里一直写着的 /plugin marketplace add taxueseek/plugin-fast-adapt 现在真的可用。本地实测 marketplace 添加成功、安装成功、组件清单报告 Skills (1)。
  • 同步面收缩:sync-skill 覆盖 sub-skills/**;默认不再自动盯下游兄弟仓,需要镜像时显式给 PFA_DOWNSTREAM_DIR。
  • 共用工具箱:scripts/ 刻意不随车道搬家,三条车道共用同一套扫描器、指南解析器与环境探测,避免重复实现和失效副本。

默认关闭功能的打开方式

  • 真冷启动档默认关闭,要真宿主证据时加 --real-smoke:node scripts/run.mjs <插件目录> --real-smoke
  • 上游盯梢默认不跑,需要轮询时调用:node scripts/guide-sync.mjs --check
  • 覆盖层自愈默认 dry-run,真动手才加 --apply:node scripts/env-heal.mjs --apply
  • 类型剥离默认关闭,只有 Node 22.13+ 且需要时才打开

相关依赖

  • 零外部依赖:只用 Node 内置模块加 git、npm 命令
  • Node 22.13+
  • 差异来源:DeepSeek 官方 docs/upgrade-guide/ 与 npm dist-tags,随上游自动更新
  • 自检 140 项,离线可跑,任何机器能执行

分发面

  • npm:plugin-fast-adapt@0.2.0 已发布
  • skills CLI:npx skills add taxueseek/plugin-fast-adapt
  • Claude Code marketplace:/plugin marketplace add taxueseek/plugin-fast-adapt
  • GitHub Release 附件:zip 与 tar.gz 双资产,带 plugin-fast-adapt-0.2.0/ 顶层目录

实测

  • CI 在 main 推送后通过
  • 本机自检 140 项全绿
  • Claude Code 本地 marketplace 安装后组件清单为 Skills (1),token 预估常驻约 204
  • 三份车道文档的 description 分别为 328、322、369 字符,全部低于 1024 上限