castor-openapi-sync
Installation
SKILL.md
Castor OpenAPI sync
只通过 CLI 同步单条已发布记录。把同步目标与登录 Profile 分开理解:来源 Profile 固定为 feature,目标来自 Castor 的同步环境列表。
工作流
- 运行
castor-cli auth status --profile feature,核对来源环境和账号。 - 目标名称不明确时运行
castor-cli openapi sync-targets --profile feature,使用目标数字代码、页面精确名称或 CLI 支持的稳定别名,不做模糊匹配。 - 运行
castor-cli openapi sync --profile feature --id <id> --target <target> --dry-run。 - 核对输出中的 ID、名称、应用、URL、版本、
record.status=2、目标名称和目标代码,向用户展示后取得明确确认。 - 运行同一条命令并把
--dry-run改为--confirm。 - 只有输出同时包含
executed=true、acknowledged=true、verified=true、verification.castor_acknowledged_target=true和verification.source_record_readback=true时报告同步调用成功。 - 同时说明
verification.independent_target_readback:为false时,表示 Castor 已同步等待目标服务成功且源记录回读一致,但没有独立查询目标库。