mirror of
https://github.com/anthropics/claude-code-action.git
synced 2026-01-22 22:44:13 +08:00
3ed14485f8
* feat: improve documentation with solutions guide and GitHub context - Add comprehensive solutions.md with 9 complete use case examples - Fix migration guide examples to include required GitHub context - Update examples missing GitHub context (workflow-dispatch-agent, claude-modes) - Enhance README with prominent Solutions & Use Cases section - Document tracking comment behavior change in automation mode - All PR review examples now include REPO and PR NUMBER context Fixes issues reported in discussions #490 and #491 where: - Migration examples were dysfunctional without GitHub context - Users lost PR review capability after v0.x migration - Missing explanation of tracking comment removal in agent mode 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: apply prettier formatting to fix CI Co-authored-by: kashyap murali <km-anthropic@users.noreply.github.com> * refactor: streamline examples and remove implementation details - Remove 5 redundant examples (57% reduction: 12→7 files) - Deleted: claude.yml, claude-auto-review.yml, claude-modes.yml, claude-args-example.yml, auto-fix-ci-signed/ - Rename examples for clarity - pr-review-with-tracking.yml → pr-review-comprehensive.yml - claude-pr-path-specific.yml → pr-review-filtered-paths.yml - claude-review-from-author.yml → pr-review-filtered-authors.yml - workflow-dispatch-agent.yml → manual-code-analysis.yml - auto-fix-ci/auto-fix-ci.yml → ci-failure-auto-fix.yml - Update all examples from @v1-dev to @v1 - Remove implementation details (agent mode references) from docs - Delete obsolete DIY Progress Tracking section - Add track_progress documentation and examples Addresses PR feedback about exposing internal implementation details and consolidates redundant examples into focused, clear use cases. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com> * fix: apply prettier formatting to fix CI Applied prettier formatting to 3 files to resolve CI formatting issues. Co-authored-by: kashyap murali <km-anthropic@users.noreply.github.com> --------- Co-authored-by: Claude <noreply@anthropic.com> Co-authored-by: claude[bot] <209825114+claude[bot]@users.noreply.github.com> Co-authored-by: kashyap murali <km-anthropic@users.noreply.github.com> Co-authored-by: Kashyap Murali <13315300+katchu11@users.noreply.github.com>
71 lines
4.6 KiB
Markdown
71 lines
4.6 KiB
Markdown
|
|
|
|
# Claude Code Action
|
|
|
|
A general-purpose [Claude Code](https://claude.ai/code) action for GitHub PRs and issues that can answer questions and implement code changes. This action intelligently detects when to activate based on your workflow context—whether responding to @claude mentions, issue assignments, or executing automation tasks with explicit prompts. It supports multiple authentication methods including Anthropic direct API, Amazon Bedrock, and Google Vertex AI.
|
|
|
|
## Features
|
|
|
|
- 🎯 **Intelligent Mode Detection**: Automatically selects the appropriate execution mode based on your workflow context—no configuration needed
|
|
- 🤖 **Interactive Code Assistant**: Claude can answer questions about code, architecture, and programming
|
|
- 🔍 **Code Review**: Analyzes PR changes and suggests improvements
|
|
- ✨ **Code Implementation**: Can implement simple fixes, refactoring, and even new features
|
|
- 💬 **PR/Issue Integration**: Works seamlessly with GitHub comments and PR reviews
|
|
- 🛠️ **Flexible Tool Access**: Access to GitHub APIs and file operations (additional tools can be enabled via configuration)
|
|
- 📋 **Progress Tracking**: Visual progress indicators with checkboxes that dynamically update as Claude completes tasks
|
|
- 🏃 **Runs on Your Infrastructure**: The action executes entirely on your own GitHub runner (Anthropic API calls go to your chosen provider)
|
|
- ⚙️ **Simplified Configuration**: Unified `prompt` and `claude_args` inputs provide clean, powerful configuration aligned with Claude Code SDK
|
|
|
|
## 📦 Upgrading from v0.x?
|
|
|
|
**See our [Migration Guide](./docs/migration-guide.md)** for step-by-step instructions on updating your workflows to v1.0. The new version simplifies configuration while maintaining compatibility with most existing setups.
|
|
|
|
## Quickstart
|
|
|
|
The easiest way to set up this action is through [Claude Code](https://claude.ai/code) in the terminal. Just open `claude` and run `/install-github-app`.
|
|
|
|
This command will guide you through setting up the GitHub app and required secrets.
|
|
|
|
**Note**:
|
|
|
|
- You must be a repository admin to install the GitHub app and add secrets
|
|
- This quickstart method is only available for direct Anthropic API users. For AWS Bedrock or Google Vertex AI setup, see [docs/cloud-providers.md](./docs/cloud-providers.md).
|
|
|
|
## 📚 Solutions & Use Cases
|
|
|
|
Looking for specific automation patterns? Check our **[Solutions Guide](./docs/solutions.md)** for complete working examples including:
|
|
|
|
- **🔍 Automatic PR Code Review** - Full review automation
|
|
- **📂 Path-Specific Reviews** - Trigger on critical file changes
|
|
- **👥 External Contributor Reviews** - Special handling for new contributors
|
|
- **📝 Custom Review Checklists** - Enforce team standards
|
|
- **🔄 Scheduled Maintenance** - Automated repository health checks
|
|
- **🏷️ Issue Triage & Labeling** - Automatic categorization
|
|
- **📖 Documentation Sync** - Keep docs updated with code changes
|
|
- **🔒 Security-Focused Reviews** - OWASP-aligned security analysis
|
|
- **📊 DIY Progress Tracking** - Create tracking comments in automation mode
|
|
|
|
Each solution includes complete working examples, configuration details, and expected outcomes.
|
|
|
|
## Documentation
|
|
|
|
- **[Solutions Guide](./docs/solutions.md)** - **🎯 Ready-to-use automation patterns**
|
|
- **[Migration Guide](./docs/migration-guide.md)** - **⭐ Upgrading from v0.x to v1.0**
|
|
- [Setup Guide](./docs/setup.md) - Manual setup, custom GitHub apps, and security best practices
|
|
- [Usage Guide](./docs/usage.md) - Basic usage, workflow configuration, and input parameters
|
|
- [Custom Automations](./docs/custom-automations.md) - Examples of automated workflows and custom prompts
|
|
- [Configuration](./docs/configuration.md) - MCP servers, permissions, environment variables, and advanced settings
|
|
- [Experimental Features](./docs/experimental.md) - Execution modes and network restrictions
|
|
- [Cloud Providers](./docs/cloud-providers.md) - AWS Bedrock and Google Vertex AI setup
|
|
- [Capabilities & Limitations](./docs/capabilities-and-limitations.md) - What Claude can and cannot do
|
|
- [Security](./docs/security.md) - Access control, permissions, and commit signing
|
|
- [FAQ](./docs/faq.md) - Common questions and troubleshooting
|
|
|
|
## 📚 FAQ
|
|
|
|
Having issues or questions? Check out our [Frequently Asked Questions](./docs/faq.md) for solutions to common problems and detailed explanations of Claude's capabilities and limitations.
|
|
|
|
## License
|
|
|
|
This project is licensed under the MIT License—see the LICENSE file for details.
|