用途:把外部 CLI 项目(如 rdt-cli、twitter-cli 等 Python/Node/Go 工具)的命令批量迁移到 opencli,适用于用户提出“把 xxx-cli 的命令迁移过来”“对齐 xxx-cli 功能”或为新平台扩展 opencli 时。
主要能力:提供四阶段标准化流程。Phase 1 源项目分析:克隆源项目到 /tmp 分析命令列表、认证方式、数据源与输出字段,生成命令清单。Phase 2 功能对比矩阵:用 ls src/clis/<site>/ 与 opencli list | grep <site> 查看现有命令,标注新增/跳过/增强,筛选高价值缺失命令。Phase 3 批量实现:按决策树选择 YAML pipeline(简单 Read API)、TypeScript adapter(GraphQL/分页/签名)、Strategy.UI(Write DOM 操作)或 Strategy.COOKIE/HEADER(Write API),顺序为先 Read 后 Write、先 YAML 后 TS,并给出 YAML 与 TS 模板及 utils.ts 公共模式复用。Phase 4 验证与发布:npx tsc --noEmit 编译检查、opencli list 确认注册、实际运行命令验证(Read 用 --limit 3 -f json 或 -v,Write 需谨慎),更新 README.md 与 SKILL.md 后提交推送。
使用方式:需先熟悉 CLI-EXPLORER.md 与 SKILL.md;按阶段执行并遵循 Checklist,迁移前需用户确认迁移范围。
限制:源项目特有但 opencli 架构不支持的功能(如需持久化存储)应跳过;与现有功能完全重复的跳过;Write 命令会实际操作,需谨慎验证。实战案例包括 rdt-cli 迁移 13 个命令、twitter-cli 迁移 11 个命令。