audit-review-decisions

Audit Review Decisions Skill

Mine merged PR review threads for agreed-but-deferred suggestions that were never implemented. Identify review debt before it compounds.

When to Use

• User says "audit review decisions", "find deferred review items", "surface review debt", "what did reviewers flag for later"

Arguments

• $1 — Time period (e.g. 14d, 30d, 7d). Default: 14d.
• $2 — Output path. Default: ${AUTOSKILLIT_TEMP}/audit-review-decisions/review_decisions_audit_$(date +%Y-%m-%d_%H%M%S).md

Critical Constraints

NEVER:

• Create files outside ${AUTOSKILLIT_TEMP}/audit-review-decisions/
• Have triage or validation subagents make GitHub API calls (local data only for Step 2)
• Post duplicate [AUDIT] markers — check for existing marker before posting
• Run subagents in the background (run_in_background: true is prohibited)
• Use gh pr list without --limit to avoid pagination truncation
• Use \| in Grep patterns — use | for alternation (ERE, not BRE)

ALWAYS:

• Save raw PR JSON to temp before any analysis (Step 1)
• Use GraphQL alias batching (~20 PRs per query) for data collection
• Include rateLimit { cost remaining resetAt } in every GraphQL query
• Sleep 1s between consecutive mutating GitHub API calls (Step 5 watermark posts)
• Step 2 triage subagents read local JSON files only — zero API calls
• Step 3 validation subagents grep the actual current codebase
• Skip threads that already contain an [AUDIT] comment
• Resolve owner/repo from git remote get-url origin — never hardcode
• Use /autoskillit: prefix when invoking any other skill

---

Workflow

Step 0: Watermark Resolution

1. Parse $1 for time period. Default 14d. Compute PERIOD_DAYS.

2. Resolve OWNER and REPO from git remote get-url origin.

3. Query the most recent [AUDIT] sentinel comment across recently merged PRs:

   gh api graphql -f query='
     query($owner:String!, $name:String!) {
       rateLimit { cost remaining resetAt }
       repository(owner:$owner, name:$name) {
         pullRequests(first:500, states:MERGED, orderBy:{field:UPDATED_AT,direction:DESC}) {
           nodes { number
             reviewThreads(first:50) {
               nodes { comments(first:10) { nodes { body createdAt } } }
             }
           }
         }
       }
     }' -f owner="${OWNER}" -f name="${REPO}"
   

   Extract the most recent createdAt from any comment whose body starts with [AUDIT]. Store as LAST_AUDIT_TS (empty string if none — first run).