shiiman-workflow:single-issue

Single Issue Flow

Issue 作成から PR 作成まで自動実行するシングルエージェント開発フロー。

Help

$ARGUMENTS に --help が含まれる場合、以下を表示して終了:

/shiiman-workflow:single-issue - シングルエージェント Issue 開発フロー

概要:
  Issue 作成から PR 作成まで自動実行する。
  Issue 作成 → worktree/ブランチ作成 → 実装 → コミット → PR 作成。

使用方法:
  /shiiman-workflow:single-issue [タスク説明] [オプション]

オプション:
  --plan    plan mode で計画書を新規作成してから実行
  --branch  worktree の代わりにブランチを作成
  --help    このヘルプを表示

例:
  /shiiman-workflow:single-issue                        # 既存計画書から実行（worktree）
  /shiiman-workflow:single-issue --plan                 # 計画書を作成してから実行
  /shiiman-workflow:single-issue --branch               # ブランチ作成モードで実行
  /shiiman-workflow:single-issue "ログイン機能を追加"    # タスク説明から直接実行

3つの実行モード

モード 1: 計画書実行モード（デフォルト）

引数なしで実行。既存の承認済み計画書から直接実行。

[既存計画書] → Issue作成 → ブランチ作成 → 実装 → ... → PR作成

モード 2: 計画書作成モード（--plan）

plan mode を使って計画書を作成・承認してから実行。

[ユーザー入力] → plan mode → 計画書作成 → 承認 → Issue作成 → ... → PR作成

モード 3: 直接実行モード（タスク説明あり）

計画書を作らず、タスク説明から直接実行。簡単なタスク向け。

[タスク説明] → Issue作成 → ブランチ作成 → 実装 → ... → PR作成

実行フロー

Issue作成 → ブランチ作成 → 実装 → 自己レビュー → [確認] → Issue更新 → コミット → プッシュ → PR作成

モード判定

1. 先頭引数が --plan の場合 → モード 2（計画書作成モード）
2. 引数が1つ以上あり、--plan / --help 以外の文字列の場合 → モード 3（直接実行モード）
3. 引数なしの場合 → モード 1（計画書実行モード）

モード 1: 計画書実行モード（デフォルト）

重要: このモードでは plan mode を使用しません。

• EnterPlanMode ツールを使用しないでください
• 計画の承認を求めないでください
• 直接フローを実行してください

ステップ 0: 計画書の読み込み

.claude/plans/ ディレクトリから最新の計画ファイルを読み込みます。

ls -t ~/.claude/plans/*.md | head -1

計画書が見つからない場合:

## 計画書が見つかりません

計画書が見つかりませんでした。

### 代替手段
- `shiiman-workflow:single-issue --plan` で新しい計画を作成
- `shiiman-workflow:single-issue タスク説明` で直接実行

計画書が見つかったら、ステップ 1 から実行。

モード 2: 計画書作成モード（--plan）

EnterPlanMode ツールを使用して plan mode に入ります。

1. ユーザーに実装したい内容を確認
2. EnterPlanMode を実行して plan mode に入る
3. 計画書を作成（.claude/plans/ に保存される）
4. ユーザーが計画を承認したら、自動的に shiiman-workflow:single-issue の実行フェーズに進む

モード 3: 直接実行モード（タスク説明あり）

重要: このモードでは plan mode を使用しません。

• EnterPlanMode ツールを使用しないでください
• 計画書を作成しないでください
• タスク説明を Issue の内容として使用してください

タスク説明を確認し、直接ステップ 1 から実行。

共通ステップ（全モード共通）

ステップ 1: Issue 作成

Skill ツールで shiiman-github:issue-create --no-confirm を呼び出す。

Issue タイトル: タスク内容を簡潔に（50文字以内）

Issue ラベル:

• enhancement: 新機能
• bug: バグ修正
• documentation: ドキュメント
• improvement: リファクタリング

Issue 本文フォーマット:

## 概要

{タスクの目的・背景}

## タスク

- [ ] {サブタスク1}
- [ ] {サブタスク2}
- [ ] {サブタスク3}

## 完了条件

- {達成すべき条件1}
- {達成すべき条件2}

ステップ 2: worktree / ブランチ作成

デフォルト（--branch なし）:

Skill ツールで shiiman-github:worktree-create {issue番号} を呼び出す。

--branch 指定時:

Skill ツールで shiiman-github:branch-create {issue番号} を呼び出す。

ユーザーがベースブランチを明示した場合は、そちらを優先する。

ステップ 3: 実装

Issue の内容に基づいてコードを実装:

1. 必要なファイルを特定
2. コード変更を実施
3. 動作確認（可能な場合）
4. サブタスク完了時に Issue を更新（バックグラウンド）

ステップ 4: セキュリティチェック＆自己レビュー

セキュリティチェック:

git status

以下のパターンを検出したら警告:

• .env* - 環境変数
• *.pem, *.key - 秘密鍵
• credentials.json - 認証情報
• node_modules/, vendor/ - 依存パッケージ

自己レビュー:

git diff

以下の観点でチェック:

• コード品質・命名規則
• セキュリティ（OWASP Top 10）
• パフォーマンス（N+1、メモリリーク）

ステップ 5: ユーザー確認

重要: ここでユーザーに確認を求める。

## 変更内容の確認

以下の変更をコミットします:

{git diff --stat の出力}

### 変更ファイル一覧
{変更ファイルリスト}

### 自己レビュー結果
{レビューで確認した内容のサマリー}

### コミットメッセージ
{自動生成されたメッセージ}

この内容でコミット・プッシュ・PR作成を実行してよろしいですか？

ステップ 6: Issue チェックボックス完了更新

ユーザー確認後、コミット前に Issue の残りのチェックボックスを含め、全てを完了状態に更新します。

ステップ 7: コミット

Skill ツールで shiiman-git:add-commit --no-confirm を呼び出す。

ステップ 8: プッシュ案内

以下のコマンドをユーザーに提示する（自動実行しない）:

git push -u origin {ブランチ名}

ステップ 9: PR 作成

Skill ツールで shiiman-github:pr-create --no-confirm を呼び出す。

PR 本文:

## 概要

{変更内容の説明}

## 変更内容

- {変更点1}
- {変更点2}

## 関連 Issue

Closes #{issue番号}

## テスト計画

- [ ] {テスト項目}

ステップ 10: 完了報告

## 開発フロー完了

### 作成された Issue
- #{issue番号}: {タイトル}

### 作成されたブランチ / worktree
- {ブランチ名}
- パス: {worktree のパス}（worktree モード時のみ）

### 作成された PR
- PR #{pr番号}: {タイトル}
- URL: {pr_url}

PR がマージされると Issue #{issue番号} は自動的にクローズされます。

### worktree クリーンアップ（worktree モード時のみ）

PR マージ後、不要になった worktree を削除してください:
`/shiiman-git:worktree` で gtr rm または gtr clean を実行

重要な注意事項

• ✅ モード 2 のみ EnterPlanMode を使用
• ✅ モード 1, 3 では plan mode を使用しない
• ✅ コミット前に必ずユーザー確認を行う
• ✅ 機密ファイルをコミットしない
• ✅ .claude/settings.json のコミットメッセージ設定に従う（設定がなければ Conventional Commits）
• ✅ PR で Closes #N を使用して Issue を参照
• ❌ ユーザー確認なしでコミット・プッシュしない
• ❌ デフォルトブランチに直接コミットしない