用途:当 issue 超出单个任务的承载范围时,在开始工作前将其拆解为若干相互关联的子 issue,使每个子 issue 都能在一次专注会话内完成。适合需求边界模糊、验收标准繁多、涉及多处代码或存在复杂内部依赖的场景。
主要能力:提供判断是否拆分的关键指标:验收标准超过5条、涉及超过3个不相关代码区域、预估工作量超过一个上下文窗口、包含多个独立交付物、依赖关系复杂。遇到不确定时应倾向于拆分。拆分流程包括:通读父 issue 并识别独立工作单元、依赖关系、自然边界与验收标准分组;制定拆分计划;为每个子 issue 创建标题与正文;使用标签标记子 issue 和父 issue;在父 issue 中列出所有子 issue;将子 issue 加入项目并设置状态;最后在记忆/知识图谱中记录拆分结果。
使用方式:以 GitHub CLI 为主要工具。创建子 issue 的命令形式为 gh issue create --title "[Type] [Parent Title] - [Sub-Task Title]" --body "...";加标签使用 gh issue edit [SUB_ISSUE_NUMBER] --add-label "sub-issue",父 issue 加 parent 标签;加入项目使用 gh project item-add [PROJECT_NUMBER] --owner @me --url [SUB_ISSUE_URL]。每个子 issue 应包含自身验收标准、验证步骤、依赖说明及对父 issue 的引用。无依赖的子 issue 状态设为 Ready,被阻塞的设为 Backlog,阻塞其他子 issue 的优先处理。
适用场景与限制:适用于需要按依赖顺序推进的多步骤开发任务,例如将用户认证需求拆分为数据库 schema、注册、登录、登出、受保护路由中间件与 UI 集成等子 issue。限制方面:资料未提供除 GitHub 项目与 CLI 之外的平台支持;未提供自动执行或与其它工具集成的细节;拆分质量依赖人工判断,过度拆分会增加管理开销。完成后应回到 issue-driven-development 的第一步,从第一个子 issue 开始按依赖顺序推进,全部完成后关闭父 issue。