SuperAPI AI 工具集

repo-harmonization

通用与其它

查看项目

更新于 10-16 07:56

技能介绍

用途:对一组相互依赖的 Git 仓库做一致性审计,重点两类工作。一是对齐:发现漂移、过时交叉引用、重复内容与相互竞争的同类工作流;二是转移:把某个仓库用得好、另一个仓库可能受益的 Agent 指南、工作流和依赖迁移过去,并按接收方约定改写。

用法:参数为以空格分隔的仓库路径列表,允许波浪号展开,至少两个且各自是独立仓库根。先运行清单脚本:bun run "<skill-dir>/scripts/inventory.ts" <repo-path> <repo-path> [more-repos...];当存在模板仓库关系时,先运行 bun run "<skill-dir>/scripts/inventory.ts" --drift <template-root> <project-root> 看漂移表。若调用方式已把说明加入对话,则不要再次通过 skill 工具调用。

主要能力:清单输出 JSON(schemaVersion: 1),含仓库元数据、依赖缺口矩阵、任务缺口和汇总;漂移表覆盖 package.json 脚本与 devDependencies、lint/format 配置、tsconfig*.json、justfile recipe、git hooks 和 CI 工作流文件,状态为 same、missing-in-project、missing-in-template 或 differs。审计要求只读研究先行,每条发现需 diff、内容哈希、再生成往返或符号链接解析等机械验证并附 file:line 证据;每个转移候选需记录捐赠方证据、接收方缺口搜索命令与需求;发现被归入确认漂移、单一来源候选、推荐转移、判断题、有意不改等类别。

限制:不推断未列出的仓库;不把已有脏状态作为审计或转移对象;转移需适配接收方语言、运行时、包管理器、任务运行器和命名;不得携带机密、凭据或个人标识;实施阶段由编排者按仓库提交,实现代理不得提交或推送;判断类事项须经用户批准,缺失事实暂未提供。