gh-discussion-replier

Gh Discussion Replier

Overview

The gh-discussion-replier skill enables posting professional English replies to GitHub Discussions. Unlike issues, discussions use the GraphQL API for both reading and posting. This skill handles the full workflow: fetching context, checking star status, composing a reply, and posting.

Workflow

1. Identify the Discussion: Get the discussion number (e.g., #66) and URL.
2. Fetch Discussion Content: Use GraphQL to get the title, body, author, and category.
3. Check Star Status: Run the bundled script to check if the author has starred the repo.
   • Command: bash .github/skills/gh-discussion-replier/scripts/check_discussion_star.sh <discussion_number>
   • Interpretation:
     • Exit code 0: User has starred. Use "Already Starred" templates.
     • Exit code 1: User has NOT starred. Include "Star Request" in the reply.
4. Select a Template: Load references/templates.md to choose a suitable response pattern based on the discussion category (Ideas, Q&A, General, Show and tell).
5. Draft the Reply: Compose a concise message based on star status and template.
6. Post the Comment: Use the GraphQL addDiscussionComment mutation (see below).

Tool Integration

Fetch Discussion Content

import subprocess, json

def get_discussion(owner, repo, number):
    query = '''
    query($owner:String!, $repo:String!, $number:Int!) {
      repository(owner:$owner, name:$repo) {
        discussion(number:$number) {
          id title body
          author { login }
          category { name }
          comments(first:10) { nodes { body author { login } } }
        }
      }
    }
    '''
    r = subprocess.run(['gh', 'api', 'graphql',
        '-f', f'query={query}',
        '-f', f'owner={owner}',
        '-f', f'repo={repo}',
        '-f', f'number={number}'],
        capture_output=True, text=True)
    return json.loads(r.stdout)['data']['repository']['discussion']