sc-commit-push-pr Skill

Orchestrates the commit, push, and PR creation workflow using background agents.

Capabilities

Agent Delegation

Orchestration Logic

/sc-commit-push-pr Flow

1. Stage important files

   • Prompt user if unclear which files to stage
   • Skip if no changes detected

2. Invoke commit-push agent via Agent Runner

   • Pass source/destination branch parameters
   • Parse fenced JSON response

3. Handle response:

   • If pr_exists: true → Return PR URL to user
   • If needs_pr_text: true → Prompt user for title/body, then invoke create-pr
   • If error.code == "GIT.MERGE_CONFLICT" → Guide user through conflict resolution

/sc-create-pr Flow

1. Accept title/body from user

   • May be provided as arguments or prompted

2. Invoke create-pr agent via Agent Runner

   • Pass title, body, source, destination

3. Return PR URL to user

Provider Support

• GitHub - Uses gh CLI for PR operations
• Azure DevOps - Uses REST API with AZURE_DEVOPS_PAT

Provider is auto-detected from git remote on each run.

Configuration

Required: Protected Branches

Create .sc/shared-settings.yaml:

git:
  protected_branches:
    - main
    - develop

Or let the skill auto-detect from git-flow configuration.

Credentials

Set environment variables:

• GitHub: GITHUB_TOKEN (or gh auth login)
• Azure DevOps: AZURE_DEVOPS_PAT

Error Handling

Storage

Related

• Design Document
• commit-push Agent
• create-pr Agent