pr-review（公关审查）

PR Review

Perform a comprehensive review of pull requests for the oc repository, which is a CLI tool based on kubectl that provides kubectl commands plus OpenShift-specific functionality.

When to Apply

Use this skill when:

• Reviewing a pull request
• User asks to review code changes
• User requests /pr-review or similar commands

Review Process

Follow these steps in order:

1. Dependencies Verification

Ensure Go dependencies are consistent by running:

• go mod tidy -diff

- This command ensures that go.mod and go.sum are consistent and match the source code in the module.

2. Build Verification

Run the build to ensure code compiles:

make oc

• If build fails, report errors and stop the review
• If build succeeds, proceed to testing
• Note: Use make oc instead of make build to avoid building for all architectures (faster)

3. Code Verification

Run verification checks to catch style and potential issues:

make verify

This runs multiple verification targets including:

• verify-gofmt - Go formatting checks
• verify-golint - Linting checks
• verify-govet - Go vet checks
• verify-cli-conventions - CLI-specific conventions
• verify-generated-completions - Generated code verification
• Report any verification errors or warnings
• Note any patterns that need addressing

4. Test Execution

Run the test suite to verify functionality:

make test

• Report any test failures with details
• If critical tests fail, flag for immediate attention
• Proceed even if some tests fail (document them)
• Known Issue: Test failure in github.com/openshift/oc/pkg/cli (kubeconfig error) can be ignored

5. Code Review & Go Style Application

After running the above checks, review the changed code and apply Go best practices. Start by:

• Load changes against the base branch by using git diff. The base branch is main by default, but it can be overwritten by [base-git-branch] argument when this skill is invoked using pr-review command directly.
• Understand the scope of the changes.

Then proceed to review. Follow these steps:

• Effective Go Principles: Apply the Effective Go skill automatically

- Use gofmt for formatting - Follow Go naming conventions (MixedCaps/mixedCaps, no underscores) - Ensure proper error handling (no ignored errors) - Check for idiomatic Go patterns

• oc-Specific Considerations:

- Ensure kubectl compatibility is maintained - Verify OpenShift-specific commands follow existing patterns - Check that CLI output follows consistent formatting - Validate flag definitions match kubectl conventions where applicable

• Breaking Changes:

- Ensure that the command line API is backwards-compatible - Check for CLI flag removals or renames - Check for changes in command line arguments

• Code Quality:

- Look for potential race conditions - Check for resource leaks (unclosed files, connections, goroutine leaks) - Goroutine leak patterns to watch: - Goroutines without context cancellation handling - Missing select with ctx.Done() case - Unbounded channel operations without timeouts - go func() without proper lifecycle management - Use errgroup or sync.WaitGroup for coordinated goroutines - Verify proper context propagation - Ensure appropriate logging levels

• Documentation:

- All exported functions/types should have doc comments - CLI command help text should be clear and complete - Complex logic should have explanatory comments

6. Apply Fixes

Based on the review:

• Fix any linting issues automatically where safe
• Apply gofmt and goimports formatting
• Suggest or implement idiomatic Go improvements
• Document any issues that require manual review

7. Summary

Provide a structured summary:

• ✅ Build status
• ✅ Test results (pass/fail counts)
• ✅ Linting status
• 📝 Code quality observations
• 🔧 Changes applied (if any)
• ⚠️ Issues requiring attention

Key Checks for oc

Since oc is built on kubectl:

• Verify upstream kubectl compatibility
• Check for proper use of kubectl libraries
• Ensure OpenShift-specific features are clearly separated
• Validate that CLI behavior matches kubectl conventions

References

• Effective Go
• oc Repository
• kubectl Conventions