SuperAPI AI 工具集

update-issue-tree

编程与开发

查看项目

更新于 10-15 21:40

技能介绍

用途:对既有 GitHub Issue 树做盘点与更新,使结构保持可被 implement-issue-tree 以 post-order DFS 消化的状态。调用方式为传入根跟踪 issue 编号:update-issue-tree 42,可用 --granularity 4h 指定粒度(正整数+h,优先级为参数 > 根 issue 正文中的 <!-- granularity: Nh --> 标记 > 默认 2h)。

主要能力:从根 issue 递归调用 sub_issues API(per_page=100,处理分页)获取全树;识别 closed 父下的残留 open issue、无父孤儿子 issue、phase 标签与父不一致、超出粒度需拆分、新任务需新建 Phase 等情况;经用户确认后执行同仓库内的父级重挂(旧父 DELETE → 新父 POST)、孤儿再配置与标签同步;最后更新根 issue 的管理块,保留手写正文。

使用方式与脚本契约:需 gh CLI 已安装并认证(gh auth status),且对目标仓库有 Issue 写权限。重挂逻辑集中在 scripts/reassign-sub-issue.sh,共享处理在 scripts/reassign-lib.sh,支持源码、npx skills add 内置、.claude/skills/ 符号链接三种布局解析。输出末行为 result=<state> issue=<n> new_parent=<n> old_parent=<n>,并给出 0、1–8、10、11 等终态(含 already-attached、posted-only、restored 等),调用侧按是否需人工确认决定中断或继续。

适用场景与限制:适用于单仓库内已有 Issue 树的维护与整理。跨仓库 sub-issue 不在支持范围(stderr 输出 reason=cross-repository-parent,脚本返回 9),需由父仓库侧拆除父链接后才能处理;根正文获取失败不会回退默认粒度而是中止。资料未提供收费、性能与除本技能外的使用示例。