Menu
Defines the compact JSONL finding schema used by all PR specialist agents and the review auditor.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
Resolve GitHub PR review comments safely, read unresolved comments, validate each issue, make minimal fixes, test, commit, and resolve.
Use zero-install context minimization first, with optional local optimization tooling when available.
Accessibility review for semantic HTML, ARIA, keyboard support, focus, screen readers, contrast, and WCAG-oriented issues.
API and contract review for OpenAPI/AsyncAPI/protobuf changes, backwards compatibility, schemas, status codes, and examples.
Architecture review for SOLID, layering, boundaries, coupling, cohesion, extensibility, and maintainability.
Backend review for handlers, services, validation, errors, transactions, dependency boundaries, and service contracts.
| name | findings-contract |
| description | Defines the compact JSONL finding schema used by all PR specialist agents and the review auditor. |
| license | MIT |
All reviewer agents must return compact JSONL findings. One finding per line.
{
"id": "SEC-001",
"agent": "security-reviewer",
"severity": "blocking",
"category": "security",
"file": "src/auth/token.ts",
"line": 42,
"title": "Access token is logged",
"evidence": "The changed code writes accessToken to structured logs.",
"recommendation": "Remove the token from logs or mask it before logging.",
"confidence": "high"
}
| Field | Values |
|---|---|
id | Stable per agent run, prefix by category, e.g. SEC-001 |
agent | Agent name |
severity | blocking, non_blocking, note |
category | Review category |
file | Relative path, or empty string for repo-level finding |
line | Integer line number or null |
title | Short finding title |
evidence | Concrete evidence from diff/file/tool output |
recommendation | Minimal actionable recommendation |
confidence | high, medium, low |