fix-issue

Automates GitHub issue resolution from working documents to PR merge.

Updated Nov 7, 2025
One-click install
npx skills add https://github.com/IKcoding-jp/Roast-Plus --skill fix-issue-ikcoding-jp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-issue
Source: https://github.com/IKcoding-jp/Roast-Plus/tree/main/.claude/skills/fix-issue
Command: npx skills add https://github.com/IKcoding-jp/Roast-Plus --skill fix-issue-ikcoding-jp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GitHubのIssue解決を自動化するワークフローです。Working Documentsを読み込み、Issueの説明作成から計画・実装、要件確認・検証・動作確認、独立レビュー、Steeringの更新、そしてPR作成と自動マージまでを一連のステップとして実行します。Issue番号を引数として受け取り、トピックブランチを必須とし、mainブランチへの直接コミットを禁止します。

Core Features & Use Cases

  • Working Documentsを基にIssueの全体計画と実装パスを自動生成
  • 以降のフェーズ(説明 → 計画 → 実装 → 要件確認 → 検証 → 動作確認 → レビュー → Steering更新 → PR作成・自動マージ)をユーザー対話で段階的に進行
  • ブランチ戦略の遵守(トピックブランチ必須、main直接コミット禁止)と自動PR作成・マージ
  • TDDを用いた実装プロセスとコードレビューの統合

Quick Start

Issue番号を引数として渡すと、現在のIssueに対して全自動の解決ワークフローを開始します。

Frequently Asked Questions about fix-issue

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub issue resolution end-to-end from planning to PR merge?

To automate GitHub issue resolution, you can use a workflow that reads Working Documents, generates an implementation plan, writes code via TDD, runs tests, conducts independent reviews, and creates a PR. This workflow requires an issue number as an argument to initiate the automated process.

Can I automatically create and merge a pull request while enforcing a topic branch workflow?

Yes, automated GitHub issue workflows can enforce a topic-branch workflow by prohibiting direct commits to main. The process automatically creates a PR from the topic branch and merges it after completing verification, testing, and independent code reviews.

How does TDD integrate with automated code review and issue resolution workflows?

TDD integrates into automated issue resolution during the implementation phase, ensuring tests are written before code. The workflow then proceeds to verification, action testing, and an independent code review phase before creating a pull request.

Do I need Working Documents to start an automated GitHub issue fix workflow?

Yes, Working Documents are required to start the automated GitHub issue fix workflow. The workflow reads these documents to generate the issue description, plan the implementation path, and guide subsequent phases like TDD implementation and PR creation.

What are the limitations of fully automating GitHub issue resolution and PR creation?

The main limitation of automating GitHub issue resolution is the requirement for user confirmation at key decision points. The workflow pauses for user interaction during planning, implementation, and review phases, meaning it is not a completely unattended autonomous process.

Why does my automated issue resolution workflow require a topic branch instead of committing to main?

Automated issue resolution workflows require a topic branch to enforce strict branching strategies and prohibit direct commits to main. This ensures code quality by routing changes through automated TDD, independent reviews, and a formal PR merge process.