SuperAPI AI 工具集

fork

编程与开发

查看项目

更新于 10-16 01:59

技能介绍

用途

该技能用于创建或配置基于 git-town 的 fork 工作流,适用于需要 fork 他人仓库参与贡献、修复已有 fork 的远程配置错误,或仅验证当前 fork 配置是否正确等场景。

工作流原则

技能明确要求以 git-town 作为分支操作的标准工具,禁止使用原生 git 命令进行分支操作(提交、暂存、查看日志和 diff 除外)。对应关系为:创建分支使用 git town hack(不用 git checkout -b)、更新分支使用 git town sync(不用 git pull / git merge)、创建 PR 使用 git town propose、合并 PR 使用 git town ship、切换分支使用 git town switch。

主要阶段与能力

阶段 0(预检):检测 git-town 安装、GitHub CLI 安装与认证、当前仓库上下文、已有远程地址、GitHub 账号。若缺少依赖会通过询问用户决定是否安装(如通过 Homebrew 安装 git-town 和 gh)。

阶段 1(闸门):汇总检测结果并展示,要求用户明确确认。需要选择工作流类型(新建 fork、修复已有 fork、仅验证),确认上游仓库 URL、fork 目标账号,并进行最终确认。

阶段 2(执行):如 fork 不存在则通过 gh repo fork 创建;配置 origin 指向 fork、upstream 指向原始仓库;初始化 git-town(git town config setup、启用 sync-upstream、设置 dev-remote 为 origin)。

阶段 3(验证):验证远程配置与 git-town 配置是否正确,可选运行 git town sync(支持 --dry-run)进行测试,并始终展示命令速查表。

使用方式

技能支持可选参数:[upstream-url] 指定要 fork 的仓库 URL;--check 仅运行验证不做更改;--fix 自动修复检测到的问题。示例包括:直接 fork 指定仓库、检查现有 fork 配置、自动修复错误配置的远程地址。

错误处理

针对 fork 创建失败、远程配置失败等情况,技能会提供询问选项或手动修复命令,并列出了常见问题(如 gh fork 失败、权限拒绝、远程已存在、未检测到 fork、上游同步失败、"Not a fork" 错误)及其原因与解决方案。

限制

必须安装 git-town 与 GitHub CLI 并完成认证。技能为规定性的分步工作流,每步需预检、确认与验证。技能会自我演进,鼓励在实际使用中根据可复现问题修正文件。

价格、收费等商业信息暂未提供。