submit-fix

Installation
SKILL.md

/submit-fix — Submit Fix PRs and Track

Input

Read .ai/issue-analysis-<issue_number>.md for the issue context. NOTE: If the analysis artifact say the issue is already fixed or not reproducible, do not proceed with the fix. Report and stop.

Pre-checks — DO NOT SKIP

  1. Read .ai/fix-verification-report.md. If the verdict is NOT FIXED, do NOT submit any PRs. Report that the fix has not been verified and stop.
  2. If .ai/fix-verification-report.md does not exist, do NOT submit. Report that verification has not been run and stop.
  3. Also check .ai/fix-plan-<issue_number>.md if it exists — if the dev test status is FAILED, do NOT submit.

Only proceed to create PRs if the verification report says FIXED.

Steps

  1. Identify all repos with changes. Check each repo directory in the workspace for uncommitted or staged changes related to the fix.
  2. For each changed repo:
    • Create a branch named fix/<issue_number> (or similar).
    • Commit the changes with a message referencing the issue.
    • Push the branch to origin (the fork): git push -u origin fix/<issue_number>.
    • Create the PR against the upstream repo, not the fork. Use:
      gh pr create --repo <upstream-org>/<upstream-repo> --head <fork-owner>:fix/<issue_number> --base master
      
      To find the upstream repo, check git remote get-url upstream. The fork owner comes from git remote get-url origin. For example, if origin is Tharsanan1/carbon-apimgt-wso2 and upstream is wso2/carbon-apimgt:
      gh pr create --repo wso2/carbon-apimgt --head Tharsanan1:fix/4863 --base master
      
  3. Write the fix report to .ai/fix-report-<issue_number>.md:
# Fix Report — Issue #<issue_number>

## Issue
- **Link:** <GitHub issue URL>
- **Title:** <issue title>

## Pull Requests
| Repo | PR | Status |
|------|-----|--------|
| <repo-name> | <PR URL> | Open |

## Summary of Changes
- **<repo-name>:** <brief description of what was changed>
Related skills
Installs
16
First Seen
Apr 2, 2026