brn-toolkit:workflow
npx skills add https://github.com/zfael/brn --skill brn-toolkit:workflow
Agent 安装分布
Skill 文档
Development Workflow Orchestrator
Description
The Workflow skill orchestrates high-level development tasks that involve multiple other skills (JIRA, Git, GitHub). It is designed to reduce the cognitive load of starting and managing tasks.
Available Scripts
start
Initiates work on a specific ticket. This script:
- Fetches ticket details from JIRA.
- Determines the correct repository (based on convention or config).
- Creates a new git worktree for the feature branch.
- Updates the JIRA ticket status to “In Progress”.
- Usage:
brn start <ticket_id>(Shortcut) orbrn workflow start <ticket_id> - Arguments:
ticket_id: The JIRA issue key (e.g.,PROJ-123).
- Example:
brn start PROJ-123
Workflow Overview
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
â DEVELOPMENT WORKFLOW â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â 1. INITIATE â
â âââ brn start <ticket> â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â 2. PLAN â
â âââ Understand requirements â Create implementation plan â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â 3. CODE â
â âââ Implement â Test â Iterate â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â 4. REVIEW â
â âââ Self-review â Fix issues â Validate â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ¤
â 5. SHIP â
â âââ Create PR â Update ticket â Clean up worktree â
âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ
Detailed Phases
Phase 1: Initiate
Start work on a JIRA ticket using the deterministic command:
brn start PROJ-123
Phase 2: Plan
Create an implementation plan before coding. Read the ticket thoroughly and create a PLAN.md in the worktree.
Phase 3: Code
Implement the solution following the plan. Commit frequently with the ticket ID in the message.
Phase 4: Review
Self-review before creating PR. Use linter, tests, and type checking.
Phase 5: Ship
Should always check ~/.brn/config.yaml to confirm automation is enabled. Should not commit the PLAN.md file. Should keep commit message clean. Dont append co-authored-by
# Push branch
git push origin <branch-name>
# Create PR
brn github create_pr <owner/repo> <head> <base> <title>
# Add PR link to ticket
brn jira add_comment <ticket_key> "PR: <url>"
# Update ticket status
brn jira update_ticket <ticket_key> "Code Review"
Phase 6: Clean-up
It should clean-up git worktrees if code change was pushed upstream.