Skip to content

fix(review-agent): move output schema from pr-review skill to agent definition - #1112

Merged
waynesun09 merged 3 commits into
mainfrom
fix-review-output-schema-in-agent
May 18, 2026
Merged

fix(review-agent): move output schema from pr-review skill to agent definition#1112
waynesun09 merged 3 commits into
mainfrom
fix-review-output-schema-in-agent

Conversation

@ralphbean

@ralphbean ralphbean commented May 18, 2026

Copy link
Copy Markdown
Member

Summary

  • The review agent's JSON output schema (field names, jq examples, agent-result.json filename) lived entirely in skills/pr-review/SKILL.md, unlike triage and code agents which carry this in their agent definition files
  • When the skill fails to load, the agent improvises and writes fields outside the strict schema (outcome, summary, prior_review_sha, prior_review_provenance), causing additionalProperties: false validation failures
  • Moves the pipeline-mode output schema to agents/review.md with an explicit warning against unknown fields; the skill now delegates to the agent definition for output format
  • Adds JSON schema tables (fields, types, constraints, required-per-action rules) alongside the jq examples, with schemas/review-result.schema.json marked as source of truth
  • Escapes literal HTML comment patterns in skills/pr-review/SKILL.md that triggered fullsend scan context high-severity hidden_html_comment findings (the scanner does line-by-line matching and doesn't respect code fences)

Supersedes #1111.

Test plan

  • fullsend scan context on skills/pr-review/SKILL.md — clean
  • Review agent produces correct agent-result.json when pr-review skill is unavailable
  • Review agent produces correct agent-result.json on next PR review run

Refs: fullsend-ai/agents#376

…efinition

When the pr-review skill fails to load (e.g. injection scan finding blocks
it or skill discovery fails), the agent improvises its output and writes
fields outside the strict schema (outcome, summary, prior_review_sha,
prior_review_provenance), causing validation failures.

Triage and code agents carry their output schema directly in the agent
definition, so they produce correct output regardless of skill availability.
Align review with that pattern: move the pipeline-mode JSON schema and jq
examples from skills/pr-review/SKILL.md into agents/review.md, with an
explicit note that additionalProperties: false rejects unknown fields.

The skill now delegates to the agent definition for output format details.

Assisted-by: Claude claude-sonnet-4-6 <noreply@anthropic.com>
Signed-off-by: Ralph Bean <rbean@redhat.com>
@github-actions

github-actions Bot commented May 18, 2026

Copy link
Copy Markdown

Site preview

Preview: https://dca8f93f-site.fullsend-ai.workers.dev

Commit: 23a3c9c7b885e311d3ffb9d0927117bff87d38db

Merge content from #1111 into this PR:
- Escape literal HTML comment patterns in pr-review SKILL.md that
  trigger fullsend scan context hidden_html_comment findings
- Add JSON schema tables (fields, types, constraints, required-per-action)
  to the agent definition alongside the existing jq examples
- Mark schemas/review-result.schema.json as source of truth
- Replace inline HTML comment reference in SKILL.md constraints with
  back-reference to step 6

Supersedes #1111.

Signed-off-by: Wayne Sun <gsun@redhat.com>
…elds

Remove the paragraph in review.md that duplicated the finding object
table. Clarify in SKILL.md that action/pr_number/repo are always
required and the per-action table lists additional required fields.

Signed-off-by: Wayne Sun <gsun@redhat.com>
@fullsend-ai-review

Copy link
Copy Markdown

Review

No findings.

@fullsend-ai-review fullsend-ai-review Bot added the ready-for-merge All reviewers approved — ready to merge label May 18, 2026
@waynesun09
waynesun09 added this pull request to the merge queue May 18, 2026
Merged via the queue into main with commit 6a9ff0b May 18, 2026
7 checks passed
@waynesun09
waynesun09 deleted the fix-review-output-schema-in-agent branch May 18, 2026 22:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-merge All reviewers approved — ready to merge

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants