跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

start

Start a new PR by creating a feature branch following repo conventions

rlajous · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add rlajous/claude-code-commands --skill start

技能说明


name: start description: Start a new PR by creating a feature branch following repo conventions argument-hint: "[ticket-id]" disable-model-invocation: false allowed-tools: Read, Grep, Glob, Bash(git checkout:), Bash(git pull:), Bash(gh issue view:*), AskUserQuestion, Write user-invocable: true

Cross-runtime: follow runtime compatibility for invocation, delegation, configuration precedence, state paths, and permissions.

You are helping create a new pull request. Your task is to create a properly named feature branch, optionally fetch ticket details, and store context for subsequent commands.

Step 1: Load Configuration

Resolve project configuration with canonical-first precedence:

if [ -f ".git-workflow/config.yaml" ]; then
  CONFIG_PATH=".git-workflow/config.yaml"
elif [ -f ".claude/config.yaml" ]; then
  CONFIG_PATH=".claude/config.yaml" # legacy read-only fallback
else
  CONFIG_PATH=""
fi

Configuration Priority:

  1. .git-workflow/config.yaml (if exists)
  2. .claude/config.yaml (legacy read-only fallback)
  3. Auto-detection (package.json, pyproject.toml, etc.)
  4. Sensible defaults

Default Values (when no config):

workflow:
  type: staging
  developmentBranch: staging
  productionBranch: main
branches:
  feature: "{type}/{ticket}-{description}"
commits:
  types: [Feature, Fix, Hotfix, Refactor, Docs, Test, Chore]
  requireTicket: false
  ticketPattern: "^[A-Z]+-\\d+$"
issueTracker:
  type: auto

Step 2: Gather Information

Ask the user for the following information (use the active host user-input mechanism):

Question 1: Ticket ID

Question: "What is the ticket ID or URL?"

  • Examples:
    • PROJ-1234 (Jira format)
    • ENG-456 (Linear format)
    • #789 (GitHub issue)
    • https://linear.app/team/issue/ENG-456/...
    • https://your-org.atlassian.net/browse/PROJ-1234

Parsing Logic:

  • Extract ticket ID from URL if provided
  • Linear: Pattern /issue/([A-Z]+-\d+)/
  • Jira: Pattern /browse/([A-Z]+-\d+)
  • GitHub: Pattern issues/(\d+) or #(\d+)

Validation:

  • If commits.requireTicket: true in config, ticket is required
  • Validate against commits.ticketPattern if provided
  • If no ticket provided and not required, proceed without it

Question 2: Change Type

Question: "What type of change is this?"

Options (from config or defaults):

  • feature - New feature or enhancement
  • fix - Bug fix
  • hotfix - Urgent production fix
  • chore - Maintenance, dependencies, etc.
  • refactor - Code refactoring
  • docs - Documentation changes

Question 3: Short Description

Question: "Provide a brief description (will be converted to kebab-case)"

Examples:

  • "add user authentication" -> add-user-authentication
  • "fix memory leak in parser" -> fix-memory-leak-in-parser

Step 3: Fetch Ticket Details (Optional)

If a ticket ID was provided and issue tracker is configured:

Auto-Detect Issue Tracker Type

Based on ticket format and available MCP servers:

  • ^[A-Z]+-\d+$ with Linear MCP available -> Linear
  • ^[A-Z]+-\d+$ with Jira config/MCP available -> Jira
  • ^#?\d+$ or GitHub URL -> GitHub Issues (via gh CLI)

Linear Integration

If Linear ticket format is detected, use the Linear MCP server:

# Fetch ticket details via Linear MCP
mcp__linear__get_issue(id: ticketId)

The MCP server handles authentication automatically via OAuth.

Jira Integration

If Jira is configured, use the Jira MCP server:

# Fetch ticket details via Jira MCP
mcp__jira__get_issue(issueKey: ticketId)

The MCP server handles authentication automatically. The jira.baseUrl from config is used to identify the Jira instance.

GitHub Issues

If GitHub format detected:

# Use gh CLI to fetch issue
gh issue view {issue_number} --json title,body,state

Store Fetched Data:

{
  "ticket_title": "Fetched title from issue tracker",
  "ticket_description": "Description from issue tracker",
  "ticket_status": "In Progress"
}

Step 4: Create Branch

Generate Branch Name

Apply the branch pattern from config (default: {type}/{ticket}-{description}):

Pattern: {type}/{ticket}-{description}
Type: fix
Ticket: proj-1234
Description: add-user-auth

Result: fix/proj-1234-add-user-auth

Branch Naming Rules:

  • Convert ticket to lowercase
  • Convert description to kebab-case (lowercase, hyphens)
  • Remove special characters
  • Limit total length to 100 characters

Examples:

  • fix/proj-1234-standardize-token-info-schema
  • feature/eng-456-add-holder-analysis
  • hotfix/abc-789-fix-critical-bug
  • chore/update-dependencies (no ticket)

Create and Checkout Branch

Immediately before running any command below, show the resolved base branch, pull target, new branch name, and canonical context destination. Ask for explicit confirmation to create and check out the branch. Do not treat automatic skill invocation or earlier information-gathering answers as approval.

# Ensure we're on the development branch and up-to-date
git checkout {workflow.developmentBranch} 2>/dev/null || git checkout main
git pull

# Create feature branch
git checkout -b {branch_name}

Error Handling:

  • If branch already exists, ask: "Branch exists. Switch to it or create a new name?"
  • If not on expected base branch, warn and confirm

Step 5: Store Context

Create .git-workflow/pr-context.json with collected information:

mkdir -p .git-workflow
{
  "ticket_id": "PROJ-1234",
  "ticket_url": "https://issue-tracker.com/PROJ-1234",
  "ticket_title": "Title from issue tracker (if fetched)",
  "branch": "fix/proj-1234-description",
  "type": "fix",
  "description": "Human readable description",
  "started_at": "2025-01-17T12:00:00Z",
  "config": {
    "workflow": "staging",
    "developmentBranch": "staging",
    "productionBranch": "main"
  }
}

Important:

  • Create .git-workflow/
阅读完整来源 ↗