castor-openapi-copy

Installation
SKILL.md

Castor OpenAPI copy

通过 CLI 搜索和导出源记录,再复用登记命令创建新记录。不要编辑或覆盖源记录。

工作流

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