Skip to content

FrancyJGLisboa/agent-skills-platform / references/examples/pr-blocker-summarizer

pr-blocker-summarizer

Unverified

Summarizes open pull requests into a blockers-first standup digest. Activates when the user asks to summarize open PRs, find blocked pull requests, generate a PR standup, or triage review backlog from a PR export.

discovery.json

View on GitHub
{
  "question": "What is preventing this pull request from merging?",
  "trigger": ["A pull request has unresolved review or CI state"],
  "decision": ["Assign the next unblock action", "Declare the pull request ready to merge"],
  "evidence": ["Pull-request metadata", "Review state", "CI check results"],
  "success_measure": "Every active blocker has an evidence-backed owner and next action",
  "outcome": "Produce an actionable pull-request blocker summary",
  "environment": {
    "documentation_sources": ["Pull-request provider API documentation"],
    "data_sources": ["Pull-request metadata, reviews, and CI status"],
    "required_capabilities": ["Read pull-request state"],
    "readiness_checks": ["The pull request exists and is readable"]
  },
  "risk": {"tier": "low", "permissions": ["Read pull-request state"], "mutation_boundary": "read-only", "approval_required": []},
  "software_mutation": {"applies": false},
  "data_interfaces": {"applies": true, "interface_types": ["api"], "authoritative_sources": ["Pull-request provider API documentation"], "entities": ["Pull request", "Review", "CI check"], "identifiers": ["Pull-request number", "Review ID", "CI check ID"], "relationships": ["Reviews and CI checks belong to one pull request"], "field_semantics": ["Provider status values retain their documented merge semantics"], "invariants": ["Every reported blocker references its source review or CI check"], "freshness_and_pagination": ["All pages are read and status is refreshed before the summary"], "nullability": ["Optional reviewer and completion timestamps remain distinct from missing records"], "readiness_checks": ["One safe pull-request response matches the documented provider schema"]},
  "semantic_contract": {"applies": false},
  "semantic_recon": {
    "sources": [{
      "id": "pull-request-api",
      "type": "api",
      "reuse": "recurring",
      "impact": "low",
      "contract_id": "pull_request_reviews",
      "contract_path": "contracts/data_contract_pull_request_reviews"
    }]
  },
  "routing_tests": {
    "should_trigger": ["What blocks PR 42?", "Summarize unresolved pull-request checks", "Is this pull request ready to merge?"],
    "should_not_trigger": ["Merge PR 42", "Write release notes", "Review this issue backlog"]
  }
}
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall