castor-openapi-copy
Installation
SKILL.md
Castor OpenAPI copy
通过 CLI 搜索和导出源记录,再复用登记命令创建新记录。不要编辑或覆盖源记录。
工作流
- 确认目标 Profile,运行
castor-cli auth status --profile <profile>。 - 用户未提供源 ID 时,运行
castor-cli openapi registration search --help查看筛选能力,再按用户描述搜索。名称是包含查询;结果不唯一时展示候选的 ID、名称、应用、URL、版本、分类和状态,让用户选择,不按相似度自动选择。 - 运行
castor-cli openapi registration detail --profile <profile> --id <id>核对完整源记录。 - 运行
castor-cli openapi registration export --profile <profile> --id <id>获取data.manifest。导出结果已经去除源 ID、状态和审计字段,将分类树转为完整路径,并将fieldConfig转为customFields。 - 复制
data.manifest到临时 JSON 或 YAML 文件,只修改用户明确指定的字段,并生成源记录到新 manifest 的字段差异:- 用户提供许可展示名称时,删除原
licenses,写入licenseNames,交给 resolve 精确解析。 - 用户要求“最新版本”时查询
openapi versions,按最大publishDate选择并展示明确版本号。 - 应用或 URL 变化时重新查询 URL 和 CustomFields;不要沿用可能不兼容的原字段配置。
- 未要求修改的分类、描述、变动类型和 CustomFields 保持不变。
- 用户提供许可展示名称时,删除原
- 比较
applicationName + connectUrl + apiVersion。若与源业务键完全相同,先提示可能重复并让用户确认要修改的版本或接口信息,不直接写入。 - 依次运行
registration plan、registration resolve和registration create --dry-run,展示源 ID、新业务键和完整差异。 - 取得针对当前 dry-run 的明确确认后运行
registration create --confirm。只有executed=true、verified=true且返回新 ID 时报告创建成功。