Repository navigation
v0.2.0:拆成三条车道、修复技能不可见、补 Claude Code marketplace
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/与 npmdist-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 上限