SuperAPI AI 工具集

incubate

通用与其它

查看项目

更新于 10-16 08:34

技能介绍

用途:incubate 是 /learn 的配套技能,负责“写下一章”——把仓库克隆或创建到本地,建立分支、修改、推送 PR,进入活跃开发状态。

主要能力:支持按 URL、slug 或仓库名孵化;--flash 走“Issue→分支→修复→PR→自动卸载”的完整闭环;--contribute 在需要时 fork,按功能建分支并提 PR;--status 列出所有活跃孵化项及 git 状态;--offload 移除符号链接但保留 ghq 克隆,--purge 同时从 .origins 清单删除;--init 在克隆后恢复所有 origin。

并行开发:--wt 为每个 agent 创建独立 git worktree(分支 incubate/<slug>),共享母克隆对象库,母克隆只 fetch 不 pull;worktree 认领通过 git worktree add -b 原子完成,多个 agent 竞争同一 slug 时只有一个成功。worktree 根目录默认在 XDG state 目录,可用 INCUBATE_WT_ROOT 重定位,且必须位于 ghq root 之外,否则 ghq list 会出现幻影仓库。

目录结构:ψ/incubate/ 下保存 .origins 清单与各仓库的 REPO.md 中心文件,origin 为指向母克隆的符号链接(gitignore)。worktree 元数据(谁、何时、为何)记录在 worktree lock reason 中,读取注册表需用 --porcelain -z 配合 tr '\0' '\n',要求 git ≥ 2.36。

限制:依赖 ghq、gh 与 git;worktree 仅限本机,其他机器上的 body 只报告不自动创建;.origins 采用受保护的追加写入,可能产生重复行,读取方需去重。具体安装与完整命令示例以官方资料为准,此处未提供。