SuperAPI AI 工具集

issue-plan

编程与开发

查看项目

更新于 10-16 09:32

技能介绍

issue-plan 用于把设计目标转换为按依赖顺序排列、可直接执行的 GitHub issue 集合。

用途:当用户提出功能想法、架构调整或重构需求,并希望获得可执行的任务拆解时使用。

主要能力与工作流程:

  1. 理解目标。先明确要构建或修改什么、解决什么问题、有哪些约束,并阅读代码库了解现有架构;使用 gh、find、grep 和读取工具查看项目结构、约定、现有代码、测试模式和 CI 设置,必要时提出澄清问题并挑战假设。
  2. 设计讨论。以交互方式比较方案取舍,区分核心与可插拔部分,梳理依赖关系,标记范围蔓延,在写 issue 前先确认关键决策。
  3. 拓扑拆解。按依赖把工作划分为阶段(如基础、核心实现、集成),同阶段内可并行,阶段间按依赖顺序排列,并显式展示依赖图,创建 issue 前先让用户确认。
  4. 创建 GitHub 标签。为各阶段和功能创建标签,例如 gh label create "phase-1" --description "Foundation" --color "0e8a16"。
  5. 创建 issue。每个 issue 应包含摘要、具体代码实现、文件位置、依赖引用、错误处理、集成点、可测试的验收标准,并使用 gh issue create 命令创建。标题格式为“<阶段>.<编号> <标题>”。
  6. 验证。创建后使用 gh issue list --label <feature> --state open 核对,并输出汇总表。

适用场景:需要把设计目标拆成可执行、有依赖顺序的 GitHub issue 时。

前置条件与限制:需安装 GitHub CLI 并登录,项目需有 GitHub 远程仓库;规划前应阅读代码库并做设计讨论;资料未提供安装步骤、价格或平台限制等更多信息。