SuperAPI AI 工具集

linear-repo-reconcile

智能体与模型

查看项目

更新于 10-16 00:01

技能介绍

用途:当仓库中积累了大量与 Linear 问题关联的分支、工作树、提交、PR 或未完成的智能体工作时,用此技能把仓库和 Linear 问题恢复到干净、真实、可继续的状态。它是对账与清理技能,任何删除、合并、变基、关闭或移动问题之前必须先用证据证明状态。

主要能力:发现带问题标签的工作(本地/远程分支、工作树、提交、PR 标题与正文、Linear 评论与状态、旧智能体会话数据);收集 git、PR、Linear、旧会话与时间证据;诊断 CI 失败类型(如 base drift、冲突、测试失败、环境失败等);分别对仓库状态(main_equivalent、unmerged_complete、active_dirty、conflicted、stale、unknown)和 Linear 状态(done_correct、should_be_done、should_be_review、should_be_active、should_be_blocked、state_conflict)分类;生成包含风险与验证的对账计划;在确认后执行安全操作。

使用方式:可传入明确的问题 ID、分支/工作树/PR/提交范围,或按团队/项目/标签查询;未给范围时先检查本地分支、工作树和开放 PR 形成候选清单。常用证据命令包括 git status、git worktree list、git log --all --grep <ISSUE-ID>、git branch --contains、git merge-base --is-ancestor、git cherry、git patch-id 等。执行顺序为:发现关联工作、收集证据、诊断流水线失败、分类、制定计划、确认高风险操作、执行安全操作、验证、报告剩余风险。

适用场景与限制:适合多智能体协作后需要清理仓库与 Linear 状态的场景。核心规则是不能只信任单一来源(Linear 状态、PR 状态、分支名、时间戳、标签或智能体评论均不可单独采信)。删除工作树只能使用 git worktree remove,绝不使用 rm -rf,也不删除当前工作目录。删除未推送提交、远程分支、强制推送、关闭 PR、改写共享分支、将含糊问题移为 Done 等操作需要明确确认。官方文档未提供具体版本或收费信息。