用途:在 GitHub 上管理议题层级关系,包括添加/移除原生子议题、创建子议题、标记 blocked_by/blocking 依赖、查看父议题完成进度与依赖图。适用于把议题拆成子任务、开工前检查阻塞关系等场景。
主要能力:--add/--remove 增删子议题;--create 新建并挂为子议题;--status/--list 查看完成进度与列表;--deps 展示依赖图;--blocking 列出被阻塞项;--block/--blocked-by/--unblock 管理依赖方向。议题引用支持裸数字、#N 或完整 URL,跨仓库引用会带 -R 参数。
使用方式:依赖 gh CLI,先解析仓库上下文(gh repo view --json nameWithOwner),再按操作调用 gh api 的 sub_issues、dependencies/blocked_by、dependencies/blocking 端点。依赖关系需用议题 node id(.id)而非编号;blocking 为只读反向,需在阻塞侧写入 blocked_by。
限制:子议题与依赖链接要求两端在同一仓库;仓库未启用子议题或依赖功能时会返回 404;重复或循环引用返回 422。子议题表达组成关系,依赖表达顺序关系,二者不宜混用。
适用场景:多议题特性的任务拆分、进度跟踪、开工前依赖检查。创建独立议题、实现议题、自动检测相关议题等应使用其他技能。