symphony-trello: Skill for Codex

Review Sweep

Goals

• Find the PR related to the current Trello card or branch.
• Gather top-level comments, inline review comments, review states, and checks.
• Gather GitHub review threads, including whether each thread is resolved.
• Treat actionable human, bot, and Codex review feedback as blocking until handled.
• Reply to addressed GitHub review threads, but leave thread resolution to the reviewer unless the user explicitly asks you to resolve them.
• Reply in the right place when accepting, clarifying, or pushing back.
• Keep PR title, body, branch, and metadata aligned with the current Trello scope when an existing PR is reused.
• Record the outcome in the Trello workpad before handoff.

Finding The PR

Try these sources in order:

1. PR URLs in the Trello card description.

2. PR URLs in recent Trello comments.

3. Branch names in the Trello card description or comments.

4. The current branch:

   git branch --show-current
   gh pr view --json number,url,title,state,headRefName,baseRefName
   

5. Open PRs whose branch, title, body, or labels match card context:

   gh pr list --state open --json number,url,title,body,headRefName,labels
   

If no PR exists, skip GitHub review checks and continue with local validation.

Feedback Sweep

For a PR number:

pr_number="<number>"
gh pr view "$pr_number" --json number,title,state,mergeable,reviewDecision,statusCheckRollup
gh api "repos/{owner}/{repo}/issues/$pr_number/comments"
gh api "repos/{owner}/{repo}/pulls/$pr_number/comments"
gh api "repos/{owner}/{repo}/pulls/$pr_number/reviews"
gh pr checks "$pr_number"

Also fetch review threads through GraphQL when the repository supports them. Paginate the review-thread connection so large PRs do not silently omit feedback:

owner="$(gh repo view --json owner --jq .owner.login)"
repo="$(gh repo view --json name --jq .name)"
gh api graphql --paginate \
  -f owner="$owner" \
  -f repo="$repo" \
  -F number="$pr_number" \
  -f query='
    query($owner: String!, $repo: String!, $number: Int!, $endCursor: String) {
      repository(owner: $owner, name: $repo) {
        pullRequest(number: $number) {
          reviewThreads(first: 100, after: $endCursor) {
            pageInfo { hasNextPage endCursor }
            nodes {
              id
              isResolved
              isOutdated
              path
              line
              comments(first: 100) {
                nodes {
                  id
                  body
                  author { login }
                  createdAt
                }
              }
            }
          }
        }
      }
    }'