Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Dec 17, 2025

Implements automated review of blog post PRs against changelog documentation standards with round-robin processing.

Implementation

Workflow file: .github/workflows/blog-changelog-reviewer.md

  • Daily scheduled execution with fuzzy timing to distribute load
  • Round-robin PR selection using cache-memory to persist review state across runs
  • Draft filtering via draft field in PR metadata
  • Dynamic documentation fetching from github/blog repository using GitHub MCP tools:
    • docs/changelog-contributing-process.md via get_file_contents
    • docs/changelog-documentation.md via get_file_contents
  • External repository access using GitHub MCP tools (list_pull_requests, pull_request_read)
  • Safe outputs for PR comments (max 1) and audit discussions

State Management

Cache structure at /tmp/gh-aw/cache-memory/blog-reviewer/state.json:

{
  "reviewed_prs": [123, 456, 789],
  "last_review_date": "2024-12-17"
}

Cycles through all open non-draft PRs, resets when complete.

Security

  • Read-only permissions (contents: read, pull-requests: read)
  • Network allowlist: defaults, github
  • Strict mode validation passed
  • GitHub toolsets scoped to repos and pull_requests only
  • All operations use GitHub MCP tools (no shell commands like curl or gh)

Custom agent used: create-agentic-workflow
Design agentic workflows using GitHub Agentic Workflows (gh-aw) extension with interactive guidance on triggers, tools, and security best practices.

Original prompt

Generate an agentic workflow that reviews blog post and enforces changelog best practices as documented in the following docs

  • each blog post is a pull request, add comment with your observations in the PR comments
  • ignore drafts
  • review 1 PR at a time in a round robin fashion (use a cache to pick the PR)

References:

Custom agent used: create-agentic-workflow
Design agentic workflows using GitHub Agentic Workflows (gh-aw) extension with interactive guidance on triggers, tools, and security best practices.


💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

Copilot AI self-assigned this Dec 17, 2025
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Review blog posts for changelog best practices Add agentic workflow for reviewing github/blog changelog PRs Dec 17, 2025
Copilot AI requested a review from pelikhan December 17, 2025 21:02
@pelikhan
Copy link
Contributor

@copilot you cannot use curl or gh, you must use github mcp tools.

Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copy link
Contributor Author

Copilot AI commented Dec 17, 2025

@copilot you cannot use curl or gh, you must use github mcp tools.

Updated in commit 350b993. Replaced all curl and gh commands with GitHub MCP tools:

  • curlget_file_contents() for fetching documentation
  • gh pr listlist_pull_requests() for fetching PRs
  • gh pr viewpull_request_read() for PR details

Also removed web-fetch tool and raw.githubusercontent.com from network allowlist since we're now using GitHub MCP tools exclusively.

@pelikhan pelikhan closed this Dec 17, 2025
@pelikhan pelikhan deleted the copilot/review-blog-posts-changelog branch December 17, 2025 23:25
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants