SuperAPI AI 工具集

issue-todo

编程与开发

查看项目

更新于 10-15 22:09

技能介绍

用途:将 issue 追踪器中的开放、关闭 issue 作为节点,把正文里的依赖引用作为边,构建依赖图,用于梳理剩余 issue、按优先级排序并决定下一步做什么。

主要能力:sync 阶段从追踪器拉取开放与关闭 issue 刷新节点,并自动从正文识别 "depends on #N" 之类的引用生成边,若输出的 CYCLE= 非空说明存在循环;link 阶段可手动补挂自动检测不到的依赖,需给出来源与理由,会拒绝造成环的边,错误边可用 unlink 拆除;plan 阶段按拓扑排序、ready-frontier 与优先级把 issue 分为可开始、进行中、受阻、完成,支持 --json 机器输出;next 阶段从 ready-frontier 中选优先级与编号最靠前的 issue,建议执行 /issue-start #N;validate 阶段检查循环(存在则退出码 2)、悬空边与 close 不一致。

用法:脚本按以下顺序查找技能路径:.claude/skills/issue-todo、.codex/skills/issue-todo、~/.claude/skills/issue-todo、~/.codex/skills/issue-todo,取第一个存在的目录作为 <skill>。先运行 git rev-parse --show-toplevel 确认仓库;追踪器认证经 issue-tracker.mjs 校验,GitHub 认证失败需先用 gh-setup 处理。随后依次执行 node <skill>/scripts/issue-todo.mjs sync、可选 link <from> <to> --type depends-on --why "<理由>"、plan、next、validate;不带参数直接调用 issue-todo 等同于 plan。

适用场景:需要梳理剩余 issue、整理依赖关系、生成 todo 图、回答“接下来先做什么”时。详细 DAG 操作见 references/dag-ops.md。

限制:依赖自动检测仅基于正文引用,可能漏检,需手动 link 补充;存在循环时需先修正;资料未提供支持的追踪器平台细节、安装方式、收费与权限要求。