SuperAPI AI 工具集

candid-ship

通用与其它

查看项目

更新于 10-16 03:37

技能介绍

用途:candid-ship 用于编排从代码审查到创建 PR 的完整交付流程,并可选执行问题跟踪器更新与自动合并。默认执行所有已配置步骤,用户通过 --skip-* 标志退出某一步骤。

主要能力:按顺序执行预检、加载配置、分类 diff 风险、展示计划、审查(candid-loop)、安装依赖、构建、测试、PR 前置信度门禁、创建 PR、更新问题跟踪器、自动合并、合并后命令与总结。创建 PR 前的任何失败都会立即中止;PR 创建后的步骤失败只警告不中止。

使用方式:在 .candid/config.json 中配置 ship 字段,如 buildCommand、testCommand、installCommand、targetBranch、autoMerge、additionalPrompt、postMergeCommand 及 issueTracker 子树。常用命令包括 /candid-ship、/candid-ship --auto-merge、/candid-ship --skip-review、/candid-ship --skip-install、/candid-ship --dry-run,以及仅创建 PR 的 /candid-ship --skip-review --skip-install --skip-build --skip-tests。若同时提供 --auto-merge 与 --no-auto-merge,后者优先。

适用场景:需要将审查、构建、测试与 PR 创建串联为一次可重复流程的项目,尤其适合希望按配置自动合并或联动 Linear 等跟踪器的团队。

限制:issueTracker 为可选集成,省略时该步骤静默跳过;默认 teamPrefixes 对应特定 Linear 工作区,需按实际团队键修改。自定义提示必须保留“single issue”与“no fallback search”不变,否则预调用检查会拒绝。建议设置 installCommand(如 npm ci),使构建/测试失败反映真实代码问题。其他跟踪器支持需在指定仓库提 issue。部分细节(如具体默认值、验证规则)以项目内 CONFIG.md 与 WORKFLOW.md 为准,资料未完整提供。