docs(faq): correct rebase FAQ to match actual behavior (#1370)

The "Why won't Claude rebase my branch?" FAQ told users they could
enable rebasing by passing `--allowedTools "Bash(git rebase:*)"` via
claude_args. This does not work: the system prompt built in
src/create-prompt/index.ts unconditionally instructs Claude that it
cannot merge, rebase, or perform branch operations beyond creating and
pushing commits, so Claude declines rebase requests regardless of the
allowed tools.

Update the FAQ to describe the actual behavior and point users to the
real workaround (rebase locally or via the Claude Code CLI).

Closes #1286

Co-authored-by: bymle <229636660+bymle@users.noreply.github.com>
This commit is contained in:
bymle 2026-06-12 12:16:55 +08:00 committed by GitHub
parent ee2b19d882
commit 8046d850b5
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -63,17 +63,14 @@ The GitHub App for Claude doesn't have workflow write access for security reason
### Why won't Claude rebase my branch? ### Why won't Claude rebase my branch?
By default, Claude only uses commit tools for non-destructive changes to the branch. Claude is configured to: Claude only creates and pushes commits. It does not merge branches, rebase, force push, or perform other destructive git operations. Specifically, Claude is configured to:
- Never push to branches other than where it was invoked (either its own branch or the PR branch) - Never push to branches other than where it was invoked (either its own branch or the PR branch)
- Never force push or perform destructive operations - Never force push or perform destructive operations
You can grant additional tools via the `claude_args` input if needed: This restriction is enforced in Claude's system prompt, so it applies even if you grant the underlying git tools (for example `--allowedTools "Bash(git rebase:*)"`). In that case Claude will still decline rebase requests and explain the limitation rather than running the command.
```yaml If you need to rebase, do it yourself locally — or with the Claude Code CLI outside of this action — and push the result.
claude_args: |
--allowedTools "Bash(git rebase:*)" # Use with caution
```
### Why won't Claude create a pull request? ### Why won't Claude create a pull request?