SuperAPI AI 工具集

plugin-parity-drift

编程与开发

查看项目

更新于 10-15 20:13

技能介绍

用途:检测 Lisa 原生重实现的精选第三方 Claude 插件是否落后于上游版本。Lisa 将部分插件重实现为原生技能,以便 Codex、agy、Copilot 等无法加载 Claude 插件的智能体也能使用;每个重实现技能通过 synced-from 标记固定到所镜像的上游插件,上游推进后重实现可能悄然滞后,本技能可确定性地发现这种漂移。

主要能力:解析形如 synced-from: <name>@<marketplace>@<version> 的固定标记,按最后一个 @ 拆分出版本(semver 不含 @),其余按 plugin-ref 再拆一次;plugin-ref 与 enabledPlugins 键及缓存路径 <marketplace>/<name>/ 字节一致。上游当前版本完全从已安装插件缓存树解析,不依赖网络、Date 或 installed_plugins.json:读取 cacheRoot/<marketplace>/<name>/<version-subdir>/.claude-plugin/plugin.json 中的 manifest version 字段,取有效 semver 的最大值。输出每技能状态:ok、stale、ahead、not-installed、unresolved、unparseable;除 ok 外均视为漂移。

使用方式:node scripts/plugin-parity-drift.mjs [--skills-root <dir>]... [--cache-root <dir>] [--json]。--skills-root 可重复,默认 <repo>/.claude/skills,递归扫描 **/SKILL.md;--cache-root 默认 $CLAUDE_PLUGIN_CACHE,否则 ~/.claude/plugins/cache;--json 输出机器可读报告,退出码一致。CI 中可添加步骤 run: node scripts/plugin-parity-drift.mjs。退出码:0 无漂移;1 发现漂移;2 操作或用法错误。CI 需存在已安装插件缓存;但仓库无重实现技能时,即使无缓存也先扫描并短路为无漂移,退出 0。发现 stale 后应运行 analyze-plugin 分析,再用 implement-plugin-parity 刷新并重新打固定标记。

限制:该技能只报告,绝不编辑技能、绝不上调版本固定、绝不触碰缓存。重新打标记须由人工或 implement-plugin-parity 显式执行。自验证依赖 parity/fixtures/drift/ 固定装置与 tests/unit/scripts/plugin-parity-drift.test.ts(bun run test:unit)。关于收费、价格、平台支持与效果等事实,资料未提供。