mcpField
D
do-issue

do-issue

github.com/athola開発34398 回インストール1 日前に更新
リポジトリ

do-issue について

do-issueは、GitHub、GitLab、Bitbucketからissueを取得し、タスク計画とサブエージェントで実装を進めるスキルです。独立したタスクの並列実行とレビューゲートに対応し、複数のissueを1つのPRにまとめます。

主な機能

  1. 01gitプラットフォームの自動検出
  2. 02issue番号、URL、一覧の受付
  3. 03タスクと依存関係の計画
  4. 04独立タスクの並列実行
  5. 05タスク群の間でレビュー
  6. 06複数issueを1つのPRに集約

活用シーン

  1. 01関連する複数issueの一括実装
  2. 02独立作業のサブエージェントへの分担
  3. 03複数のgitプラットフォームでのissue修正の調整
  4. 04レビューゲートを経た統合PRの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/athola/claude-night-market --skill do-issue

インストール後、Claude Code で/do-issueを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

modules/
completion.md
issue-discovery.md
parallel-execution.md
quality-gates.md
task-planning.md
troubleshooting.md

詳細

使用しない場合

  • 直接修正できるほど明白な単一ファイルの修正
  • 作業完了後の PR の準備（sanctum:pr-prep を使用）

Issue の修正

検出された Git プラットフォーム（GitHub、GitLab、Bitbucket）から issue の内容を取得し、サブエージェント主導の開発を通じて要件に体系的に対応します。依存関係が許す範囲でタスクを並行して実行します。

プラットフォームは leyline:git-platform SessionStart フックによって自動検出されます。使用する CLI を判断するには、セッションコンテキストで git_platform: を確認してください。

主な機能

  • クロスプラットフォーム：GitHub／GitLab／Bitbucket を自動検出し、適切な CLI を使用します
  • 柔軟な入力：単一の issue 番号、プラットフォームの URL、またはスペース区切りのリストを指定できます
  • 並列実行：独立したタスクをサブエージェント経由で同時に実行します
  • 1 つの PR：すべての issue を 1 つの統合 PR にまとめます（issue ごとに PR を作成することはありません）
  • 品質ゲート：タスクグループ間でコードレビューを行います
  • クリーンなコンテキスト：各サブエージェントは、作業に集中できるようクリーンなコンテキストで開始します

ワークフローの概要

フェーズ説明モジュール
1. 発見入力を解析し、issue を取得して、要件を抽出しますissue-discovery
2. 計画依存関係を分析し、タスクの内訳を作成しますtask-planning
3. 実行独立したタスクに対して並列サブエージェントを起動しますparallel-execution
4. 品質タスクのバッチ間でコードレビューのゲートを設けますquality-gates
5-6. 完了順次タスク、最終レビュー、issue の更新を行いますcompletion

必須の進捗項目

  1. do-issue:discovery-complete
  2. do-issue:tasks-planned
  3. do-issue:parallel-batch-complete
  4. do-issue:review-passed
  5. do-issue:sequential-complete
  6. do-issue:issues-updated

Forge CLI コマンド

セッションコンテキストで検出されたプラットフォーム（git_platform:）を使用してください。マッピングの詳細は Skill(leyline:git-platform) を参照してください。

操作GitHub（gh）GitLab（glab）
issue の取得gh issue view <N> --json title,body,labels,commentsglab 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 フラグを付けて実行し、利用可能かどうか確認してください。

エージェントチーム（デフォルトの実行モード）

エージェントチームは、do-issue のデフォルトの並列実行バックエンドです。チームメンバーはファイルシステムベースのメッセージングで連携するため、実装中に共有ファイルや依存関係が見つかった場合もリアルタイムで通信できます。

自動的な切り替え： --scope minor を指定した単一 issue の場合、エージェントチームはスキップされます（代わりに Task ツールまたはインライン実行を使用します）。すべての実行で Task ツールによる起動を強制するには、--no-agent-teams を使用してください。

必要条件： 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

エージェントチームの詳細なパターンについては、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 フラグを付けて実行し、利用可能かどうか確認してください。

詳細リソース

完了条件

  • 必須の進捗項目6件すべて（do-issue:discovery-complete から do-issue:issues-updated まで）が実行開始前に作成され、 各フェーズの完了時に完了としてマークされている
  • セッションのコンテキストに基づいて検出された正しい forge CLI（GitHub の場合は gh、GitLab の場合は glab）を使用して、Issue の要件が取得されている
  • すべての Issue を対象とする統合 PR がちょうど1件作成されている。Issue ごとの PR は作成されていない
  • 並列タスクのバッチ間でコードレビューのゲートが実行され、次のバッチを ディスパッチする前に合格している
  • 指定されたすべての Issue に、レビュー可能な状態になった PR への参照を付けてコメントするか、Issue をクローズしている

コメント

Markdown 対応