메뉴
Find an actionable open GitHub issue (or take an issue number or quoted task), implement the fix, commit, update the changelog, and open or update a PR. Use when asked to fix an issue or pick up work from the tracker, e.g. "/fix-issue 1354".
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | fix-issue |
| description | Find an actionable open GitHub issue (or take an issue number or quoted task), implement the fix, commit, update the changelog, and open or update a PR. Use when asked to fix an issue or pick up work from the tracker, e.g. "/fix-issue 1354". |
Find an actionable open GitHub issue (a bug, or a well-scoped task or content request), implement it, then open a pull request. Only take on work small and well-specified enough to implement confidently from the issue plus repo context, with no design or balance decisions left open. If no actionable issue remains, scan the codebase for common bug patterns instead.
Supported arguments: an issue number, a short task description in quotes (for well-scoped work with no GitHub issue), or none to auto-select an issue. Requested arguments: $ARGUMENTS
Steps:
Pick the work
If a quoted task description is given, treat it as the work item and skip the issue search (still apply the scope guard below).
If an issue number is given, fetch it directly:
gh issue view <number> --json title,body,labels,comments
Otherwise, list open issues and pick one not already covered by an open PR:
gh issue list --state open --limit 40
gh pr list --state open
Eligible work is either a bug with a clear reproduction path, or a task / content / enhancement that is concrete and well-specified (clear outcome, names the country, system, or files it touches, and a sibling implementation exists to mirror).
Scope guard: only proceed if the work is small and unambiguous. Skip it (and say why) when the issue is vague or has no acceptance criteria; needs a design or balance decision that is the user's or team's call; requires new art, audio, or map assets you cannot author; spans many systems or countries; or is a large feature better split into its own PR. When in doubt, report the issue back rather than guess.
If no actionable issue remains (all too vague, graphical, engine-level crashes, out of scope, or already covered), scan the codebase for common bug patterns instead: work through the "Scan patterns" section of .claude/docs/bug-patterns.md.
When working a codebase-scanned bug or a quoted task with no issue number, omit the Closes # line from the PR since there is no issue to reference.
Understand the work
Read the issue body (or the task description). For a bug, identify the wrong behaviour, the expected behaviour, and any country, decision, event, or system named. For a task, identify the desired outcome, its acceptance criteria, and which files or systems it touches.
Locate the relevant code
Search for the named decisions, effects, triggers, scripted GUIs, or on_actions. If not found, do a wider search:
grep -rn "keyword" common/ events/ --include="*.txt" -l
Read the files involved. Understand the data flow before touching anything.
Diagnose or plan (planning model)
Do this yourself, on the strongest available model. For a bug, trace the logic to find exactly where the wrong value is produced or the wrong branch is taken; confirm the cause in code before writing a fix, do not guess. For a task, plan the change against existing patterns: find a sibling implementation to mirror (a comparable focus, event, decision, idea, or MIO) and reuse its structure and conventions.
Produce a concrete edit list: the exact files, the exact lines or blocks to change, and the precise new text for each. Resolve every ambiguity here (values, variable names, loc keys, ordering) so the implementation step has no decisions left to make. Also note any related-but-out-of-scope issues you spot, and what to leave untouched.
Implement the change (implementation model)
Once the edit list is fully resolved, hand the mechanical implementation to a Sonnet subagent (the Agent tool with model: sonnet; use head-mod-developer or another fitting agent type). Planning stays on the strong model; only the typing-out is delegated. Give the subagent the full edit list verbatim, the convention reminders below, an explicit instruction to stay strictly within the listed files, and concrete verification commands (greps that must return a specific count, etc.) to run and report back.
If the edit is trivial enough that delegation adds no value (a single one-line change), just make it directly.
Make the smallest change that resolves the issue, whether a bug fix or new/edited content. For content, follow the matching system conventions in AGENTS.md and the relevant .claude/docs/ reference (focus trees, events, decisions, ideas, MIOs, localisation), and add every required loc key. Follow the project conventions (AGENTS.md):
Do not refactor surrounding code or fix unrelated issues in the same commit. After the subagent returns, verify its diff scope yourself (git diff --stat) before committing, since subagents can edit outside their brief.
Commit
Never create or switch branches on your own. First check the current branch:
git rev-parse --abbrev-ref HEAD
main: stop and use AskUserQuestion to ask which branch to use. Offer: (a) check out an existing branch (user supplies the name), (b) create a new branch (user supplies the name). Only after the user answers, run git checkout <name> or git checkout -b <name>. Do not invent a branch name.main: commit on the current branch. Do not switch or create a branch.Then stage only the files changed for this work and commit. Use an accurate verb (Fix for a bug, Add or Implement for a task):
git add <files>
git commit -m "<verb> <short description> (#<issue number>)
<one or two sentences: a bug's root cause and fix, or what a task added or changed>
Ensure branch is up to date
Run git merge origin/main and ensure the branch is up to date before creating a changelog entry or a pull request.
Update the changelog
Run /changelog to add an entry under the current version in Changelog.txt. Commit the changelog update separately.
Open or update the pull request
Push the branch first:
git push -u origin <branch>
Then check whether an open PR already exists for this branch:
gh pr list --head <branch> --state open --json number,url,body
a. If no open PR exists: hand off to /open-pr <issue number>. That skill is the single source of truth for the create path (AngriestBird-format body, draft PR, changelog). Do not duplicate its logic here.
b. If an open PR already exists: rewrite its body in AngriestBird format and apply with gh pr edit <PR#> --body "...". Do NOT create a second PR. Preserve everything already there — every Closes #N line, every existing #### section bullet, any test-plan section (extend it via /test-plan) — and append the new work under the matching section. Format per /open-pr step 5 — it is the single source of truth.
Apply with a heredoc to keep formatting intact:
gh pr edit <PR#> --body "$(cat <<'EOF'
<full rewritten body>
EOF
)"
Report back
Output the PR URL, whether the PR was created or updated, and a one-paragraph summary of what was fixed or added.
Rewrite a country rework/additions TASK issue into a clear, mechanic-by-mechanic design brief: study its mockups, inventory the country's existing assets, and reframe each mechanic (goal / real-world idea / starting state / influences / player choices / progression) with AI/tooling hints stripped. Use when asked to reframe, clarify, or rewrite a rework task or roadmap issue, e.g. "/rework-brief JAP 801".
Check a file or the branch diff against the full MD content review checklist (economic, political, visual, military, AI, code) with blocker tags. Use when asked to content-review country content or verify content-guideline compliance before merge.
Scaffold generals, field marshals, and admirals for a country using the MD count formulas and region skill ranges, writing character and recruit_character entries. Use when asked to add leaders, generals, or admirals for a TAG, e.g. "/add-leader NIG".
Wire a country-specific income or expense stream into the MD money system: calculation block, hidden tooltip idea, loc key, and granting effect. Use when asked to add an income or expense stream, e.g. "/additional-income GRE golden_visa income".
Adversarial edge-case hunt over the branch diff or a single file: challenges every change for unhandled scenarios, silent failures, scope/timing/variable traps, and logic gaps rule-based review misses. Use when asked to adversarially review, stress-test, or find edge cases in a change.
Comprehensive pre-merge review of one file or the whole branch diff: dispatches parallel reviewer agents (correctness, adversarial edge cases, performance, simplification, content) and merges findings. Use when asked to audit or fully review a branch or file. Replaces /review-branch.