apollo-skills

Maintainer skills and workflows for semi-automated Apollo community operations:

• issue review
• issue-to-PR
• PR review
• periodic community review automation
• contributor promotion review
• server release orchestration
• Java client release orchestration
• helm chart release orchestration
• quick-start release orchestration

These skills are designed for human-in-the-loop operation by default, with optional machine-readable handoff blocks for pipeline chaining.

Skills

1) apollo-issue-review

Review and triage issues, propose labels, ask for missing details, and draft maintainer replies.

Default output: human-friendly summary and reply draft.
Optional: append pipeline handoff fields when output_mode=pipeline.

2) apollo-issue-to-pr

Convert qualified issues (bug / feature request / enhancement) into minimal draft PRs with risk gating and focused validation.

Default output: human-friendly implementation and validation summary.
Optional: append pipeline handoff fields when output_mode=pipeline.

3) apollo-pr-review

Run maintainer-grade PR review with compatibility/regression focus, then produce a publish-ready review draft.

Default output: human-friendly review decision and findings.
Optional: append pipeline handoff fields when output_mode=pipeline.

4) apollo-community-review

Run the scheduled Apollo GitHub community review automation for apolloconfig/apollo:

• scan open issues and PRs for new external activity
• route issues to apollo-issue-review and PRs to apollo-pr-review
• apply deterministic high-confidence auto-send policy
• batch the run into one inbox summary with Auto-sent, Needs review, and Skipped/Error

5) apollo-java-release

Run Apollo Java formal release flow with checkpoint-gated automation:

• release version bump PR
• GitHub prerelease creation
• release workflow trigger (auto-publish via central-publishing-maven-plugin)
• announcement discussion creation
• post-release SNAPSHOT bump PR
• prerelease promotion to official release after publish workflow succeeds

6) apollo-contributor-promotion-review

Run a quarterly Apollo contributor promotion review across apolloconfig:

• scan recent contributor activity across the organization
• rank the top contributors from the last 100 days
• backfill historical PR/review/community evidence for the top candidates
• produce an internal report for member, committer discussion, PMC discussion, or continued observation

7) apollo-release

Run Apollo server formal release flow with checkpoint-gated automation:

• release revision bump PR (pom.xml revision only)
• prerelease draft from CHANGES.md with user-selected highlight PRs (--highlight-prs)
• package workflow trigger (release-packages.yml) and release asset verification
• docker publish workflow trigger (docker-publish.yml)
• prerelease promotion to official release
• announcement discussion creation
• post-release SNAPSHOT bump PR with CHANGES.md archive and milestone management

8) apollo-helm-chart-release

Run Apollo Helm chart release flow for apolloconfig/apollo-helm-chart with local automation and publish gates:

• detect version trigger from chart version / appVersion diff with docs lag fallback
• run helm lint, package both charts, move tgz to docs, and regenerate docs/index.yaml
• enforce whitelist-only git changes before commit
• create standardized release commit and generate ready-for-review PR draft
• stop at push/PR gate commands for explicit human confirmation

9) apollo-quick-start-release

Run Apollo quick-start release follow-up flow with checkpoint-gated automation:

• trigger quick-start asset sync workflow (sync-apollo-release.yml) for release version updates
• wait for sync workflow completion and inspect fixed-branch PR status (codex/quick-start-sync-<version>)
• require PR merge confirmation before docker publish when sync changes exist
• trigger docker publish workflow (docker-publish.yml) with configurable tag (default: release version)
• support resume via state file and explicit checkpoint confirmations

Recommended Flow

1. apollo-issue-review
2. apollo-issue-to-pr (only when issue is ready)
3. apollo-pr-review
4. apollo-release (for Apollo server release cycles)
5. apollo-java-release (for formal Java SDK release cycles)
6. apollo-community-review (for periodic issue/PR scan, skill routing, and gated auto-send)
7. apollo-contributor-promotion-review (for quarterly contributor ranking and promotion readiness review)
8. apollo-helm-chart-release (for apollo-helm-chart packaging/index/PR flow)
9. apollo-quick-start-release (for apollo-quick-start sync PR + docker publish flow)

All publish actions remain confirmation-gated by default.

Quick Usage

Use $apollo-issue-review <issue-id>
Use $apollo-issue-to-pr <issue-id>
Use $apollo-pr-review <pr-id>
Use $apollo-java-release <release-version>
Use $apollo-community-review
Use $apollo-contributor-promotion-review
Use $apollo-release <release-version>
Use $apollo-helm-chart-release
Use $apollo-quick-start-release <release-version>

Repository Layout

apollo-issue-review/
apollo-issue-to-pr/
apollo-pr-review/
apollo-community-review/
apollo-contributor-promotion-review/
apollo-release/
apollo-java-release/
apollo-helm-chart-release/
apollo-quick-start-release/

Each skill contains its own SKILL.md and optional references/, scripts/, or agents/ content.