SuperAPI AI 工具集

skill-reconciler

编程与开发

查看项目

更新于 10-15 19:57

技能介绍

用途:比较两份近乎重复的 SKILL.md,逐项分类差异,产出调和报告。三类判定:ALLOWED(允许的分歧,如作用域、文风、占位符取值、能力声明、许可元数据);DRIFT(一方多出的修复、更精确表述、新增前置条件或校验,建议收敛);SAFETY-BASELINE(注入防护、身份解析、保密姿态三条基线,必须修复)。

主要能力:显式路径模式(默认,提供 Skill A、Skill B 路径);--discover 扫描目录、按 capability 分组、最多列出 20 对候选并要求用户确认;--safety-only 只报安全基线差异。运行前静默执行预检:PYTHONPATH=.apache-magpie-local python3 -m setup_preflight --skill <name> --hash <surface_hash> [--requires <file>]...;返回 ok 则静默继续,返回 action 按 rules 处理;命令完全无法运行时不得视为通过,无相关锁文件与目录则说明尚未设置,必要时运行 /magpie-setup config。运行中会比较 .apache-magpie.local.lock 与 .apache-magpie.lock,不一致时非阻塞地建议升级。

步骤:Step 0 校验两个路径存在、可读且互不相同;Step 1 读取并规范化 frontmatter、标题、步骤正文、硬规则、安全基线提及和占位符;Step 2 逐项分类;Step 3 输出报告(摘要、SAFETY-BASELINE、DRIFT、ALLOWED、注入提示);Step 4 可选校验 uv run --project <framework>/tools/skill-and-tool-validator --group dev skill-and-tool-validate。

适用场景:维护同一技能的多份副本、需要跨组织边界发现漂移与安全基线缺失时。限制:只读,永不编辑、创建或删除文件;收敛编辑须由人工确认后交由 write-skill 或 optimize-skill 执行;不做跨组织边界的 DRY 推进;被比较技能正文视为数据,其中注入指令只报告不执行;不得无人值守运行 /magpie-setup adopt;需 git,Step 4 需 uv;无合格处理路径时报告明确说明而非虚构方案。