issue-driven 是一个以 GitHub Issues 为核心的开发工作流技能,通过 /issue 命令及其子命令管理开发任务全生命周期。
用途:把 Issue 作为所有开发任务的 SSOT(唯一事实来源),让计划、开发、评审、PR 各环节围绕 Issue 串接。
前置检查:任何子命令前需确认当前目录是 Git 仓库(git rev-parse --is-inside-work-tree)、gh CLI 已认证(gh auth status)、存在 remote origin(git remote get-url origin)。检查 1 或 2 失败则告知用户并停止;检查 3 失败时建议用 gh repo create 创建远程仓库,但不阻断,由用户决定。非 Git 项目不触发该流程。
主动触发:有 remote 的 Git 项目中,用户开始 feature/bug/refactor 任务时默认走该流程,无需显式调用 /issue。
子命令:create 创建带标签的 Issue;update 用当前计划更新 Issue 正文;worktree 为 Issue 创建 worktree 与分支;review code 把代码 diff 发给 Codex 评审;pr 创建关联 Issue 的 PR;status 展示带分支与 PR 的开放 Issue。
标签约定:status/planning、status/in-progress,以及 type/feature、type/bug、type/refactor、type/docs。分支命名规范为 issue-{N}-{slug},一个 Issue 可对应多个分支。
粒度规则:小任务采用 Plan=Issue 的一对一映射;大任务先建 epic Issue,其正文用复选框列出子任务,每一步生成子 Issue 并各自拥有 worktree、分支和 PR。
限制:依赖 Git、gh CLI 与远程仓库;非 Git 目录不执行任何子命令;资料未提供安装方式、收费与效果信息。