github-graphql-api

# GitHub GraphQL API共通処理 > **参照元**: decompose-issue.md, detailed-design-workflow.md から分離された共通GraphQL API処理 --- ## 概要 GitHub REST APIにはSub-issue関連のバグがあるため、GraphQL APIを使用する。 **Reference**: https://github.com/cli/cli/issues/10378 --- ## Sub-issue登録 親IssueにSub-issueを紐付けるGraphQL API処理。 ### 処理フロー ```python def add_sub_issue(parent_issue_id: int, child_issue_id: int) -> bool: """ 親IssueにSub-issueを登録する Args: parent_issue_id: 親Issue番号 child_issue_id: 子Issue番号（Sub-issue） Returns: 成功時True、失敗時False（致命的エラーとしない） """ try: # 1. GraphQL Node IDを取得 parent_node_id = bash( f"gh issue view {parent_issue_id} --json id --jq '.id'" ).stdout.strip() child_node_id = bash( f"gh issue view {child_issue_id} --json id --jq '.id'" ).stdout.strip() if not parent_node_id or not child_node_id: return False # 2. GraphQL APIでSub-issue関係を追加 result = bash(f''' gh api graphql \ -H "GraphQL-Features: sub_issues" \ -f 'query=mutation {{ addSubIssue(input: {{ issueId: "{parent_node_id}", subIssueId: "{child_node_id}" }}) {{ issue {{ number }} subIssue {{ number }} }} }}' ''') return result.exit_code == 0 except Exception: return False # Sub-issue登録失敗は致命的エラーとしない ``` ### シェルコマンド版 ```bash # 1. Node ID取得 PARENT_NODE_ID=$(gh issue view $PARENT_ISSUE_ID --json id --jq '.id') CHILD_NODE_ID=$(gh issue view $CHILD_ISSUE_ID --json id --jq '.id') # 2. Sub-issue登録 gh api graphql \ -H "GraphQL-Features: sub_issues" \ -f "query=mutation { addSubIssue(input: { issueId: \"$PARENT_NODE_ID\", subIssueId: \"$CHILD_NODE_ID\" }) { issue { number } subIssue { number } } }" || true # エラーでも続行 ``` --- ## エラーハンドリング | エラー | 対応 | |--------|------| | Node ID取得失敗 | 処理をスキップ（警告ログ出力） | | GraphQL API失敗 | 処理をスキップ（致命的エラーとしない） | | ネットワークエラー | リトライ1回後スキップ | **重要**: Sub-issue登録の失敗はワークフロー全体を停止させない。Issue自体は作成済みなので、手動でSub-issue関係を設定可能。 --- ## 使用箇所 | ワークフロー | 用途 | |-------------|------| | `/decompose-issue` | 分割したSubtaskを親Issueに紐付け | | `/detailed-design-workflow` | 作成したIssueをEpicに紐付け | --- ## CLIスクリプト **自動化スクリプトが利用可能です：** ```bash bash .opencode/skill/github-graphql-api/scripts/add-sub-issue.sh <parent-issue> <child-issue> ``` | 引数 | 説明 | |------|------| | `parent-issue` | 親Issue番号 | | `child-issue` | Sub-issueとして追加するIssue番号 | **使用例：** ```bash bash .opencode/skill/github-graphql-api/scripts/add-sub-issue.sh 10 42 ```