关于 do-issue
do-issue 是一款从 GitHub、GitLab 或 Bitbucket 获取 issue,并通过任务规划和子 Agent 协调实现工作的 Skill。它可并行处理相互独立的任务,设置审查关卡,并将多个 issue 汇总到一个 PR。
主要功能
- 01自动检测 git 平台
- 02接受 issue 编号、URL 或列表
- 03规划任务及依赖关系
- 04并行执行独立任务
- 05在任务批次间进行审查
- 06将多个 issue 汇总为一个 PR
适用场景
- 01一起实现多个相关 issue
- 02将独立工作分配给子 Agent
- 03协调多个 git 平台上的 issue 修复
- 04通过审查关卡准备汇总 PR
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ athola/ claude-night-market --skill do-issue安装后在 Claude Code 中输入/do-issue确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
modules/completion.mdissue-discovery.mdparallel-execution.mdquality-gates.mdtask-planning.mdtroubleshooting.md详细介绍
不适用场景
- 可以直接完成的单文件修复
- 工作完成后准备 PR(使用
sanctum:pr-prep)
修复问题
从检测到的 Git 平台(GitHub、GitLab 或 Bitbucket)获取问题内容,并使用 subagent-driven-development 系统地处理需求;在依赖关系允许的情况下并行执行任务。
平台会自动检测,由 leyline:git-platform SessionStart hook 完成。检查会话上下文中的 git_platform:,以确定要使用哪个 CLI。
主要功能
- 跨平台:自动检测 GitHub/GitLab/Bitbucket,并使用相应的 CLI
- 灵活输入:单个问题编号、平台 URL 或以空格分隔的列表
- 并行执行:通过子 Agent 并发运行互不依赖的任务
- 一个 PR:所有问题都汇总到一个 PR 中(绝不为每个问题单独创建 PR)
- 质量关卡:任务组之间进行代码审查
- 全新上下文:每个子 Agent 都从干净的上下文开始,专注处理工作
工作流概览
| 阶段 | 说明 | 模块 |
|---|---|---|
| 1. 发现 | 解析输入、获取问题、提取需求 | issue-discovery |
| 2. 规划 | 分析依赖关系、创建任务拆分 | task-planning |
| 3. 执行 | 为互不依赖的任务分派并行子 Agent | parallel-execution |
| 4. 质量 | 任务批次之间的代码审查关卡 | quality-gates |
| 5-6. 完成 | 顺序执行任务、最终审查、更新问题 | completion |
必需的进度项
do-issue:discovery-completedo-issue:tasks-planneddo-issue:parallel-batch-completedo-issue:review-passeddo-issue:sequential-completedo-issue:issues-updated
Forge CLI 命令
使用会话上下文中检测到的平台(git_platform:)。完整映射请参阅 Skill(leyline:git-platform)。
| 操作 | GitHub(gh) | GitLab(glab) |
|---|---|---|
| 获取问题 | gh issue view <N> --json title,body,labels,comments | glab issue view <N> |
| 评论 | gh issue comment <N> --body "msg" | glab issue note <N> --message "msg" |
| 关闭 | gh issue close <N> --comment "reason" | glab issue close <N> |
| 搜索 | gh issue list --search "query" | glab issue list --search "query" |
**验证:**运行命令并添加 --help 标志,以确认命令是否可用。
Agent Teams(默认执行模式)
Agent teams 是 do-issue 的默认并行执行后端。队友通过基于文件系统的消息机制进行协作;在实现过程中发现共享文件或依赖关系时,可以实时沟通。
自动降级:对于使用 --scope minor 的单个问题,将跳过 agent teams(改用 Task 工具或内联执行)。使用 --no-agent-teams 可在任何调用中强制通过 Task 工具分派。
要求:Claude Code 2.1.32+、tmux、CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1。如果缺少前置条件,将静默回退到通过 Task 工具分派。
# Agent teams configuration
fix_issue:
agent_teams:
enabled: true # on by default; --no-agent-teams to disable
max_teammates: 4 # limit concurrent workers
model: sonnet # teammate model (lead uses current model)
auto_downgrade: true # skip agent teams for --scope minor
有关 agent teams 模式的详细信息,请参阅 modules/parallel-execution.md。
配置
fix_issue:
parallel_execution: true
max_parallel_subagents: 3
review_between_batches: true
auto_close_issues: false
commit_per_task: true
**验证:**运行命令并添加 --help 标志,以确认命令是否可用。
详细资源
- 阶段 1:有关输入解析和需求提取,请参阅 modules/issue-discovery.md
- 阶段 2:有关依赖关系分析,请参阅 modules/task-planning.md
- 阶段 3:有关子 Agent 分派,请参阅 modules/parallel-execution.md
- 阶段 4:有关审查模式,请参阅 modules/quality-gates.md
- 阶段 5-6:有关收尾工作,请参阅 modules/completion.md
- 错误:有关常见问题,请参阅 modules/troubleshooting.md
退出标准
- 执行开始前,已创建全部 6 项必需的进度项(从
do-issue:discovery-complete到do-issue:issues-updated),并在各阶段结束时将对应项标记为已完成 - 根据会话上下文检测到的代码托管平台,使用正确的平台 CLI 获取 Issue 需求(GitHub 使用
gh, GitLab 使用glab) - 仅创建一个涵盖所有 Issue 的整合 PR;不创建逐 Issue 的 PR
- 并行任务批次之间执行代码审查门禁;必须通过后才能分派下一批任务
- PR 准备好接受审查后,已对所有指定 Issue 发表评论或将其关闭,并附上 PR 引用