| name | beads-pr-prepare |
| description | Prepare a pull request title/body from a Beads task (optionally using gh) |
Beads: prepare PR
Goal
Given a Beads task id (e.g. bd-a3f8), prepare a PR title and markdown body that references the task.
Inputs
bead_id(required)- Whether to use
ghto create/update PR (optional; only if available + authenticated)
Procedure
- Fetch task details:
bd show <bead_id> --json
- Draft PR metadata:
- Title: keep it short; include bead id prefix (e.g.
bd-a3f8: <title>) - Body: use the template at:
./.goose/skills/beads-pr-prepare/templates/pr-body.md
- If
ghis available and authorized, offer optional automation:
- Create PR (example):
gh pr create --title "<title>" --body-file <path-to-generated-body>
Output
- Always return:
- PR title
- PR body markdown
- If
ghautomation is used, also return:- PR URL
Notes
- If
--jsonisn’t supported, fall back tobd show <bead_id>and extract details from text. - Running
ghshould be explicit: only do it when the user asks to create the PR.