shiiman-workflow:single

Single Flow

Issue/PR なしで計画書からタスクを実行し、コミットメッセージを出力する軽量フロー。

Help

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

/shiiman-workflow:single - 軽量シングルエージェントフロー

概要:
  Issue/PR なしで計画書からタスクを実行し、コミットメッセージを出力する。
  worktree/ブランチ作成 → 実装 → 自己レビュー → コミットメッセージ出力。

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

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

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

前提条件

• gh コマンドが利用可能
• gh auth status が成功する（GitHub CLI 認証済み）

3つの実行モード

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

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

[既存計画書] → ブランチ作成 → 実装 → 自己レビュー → [確認] → コミットメッセージ出力

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

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

[ユーザー入力] → plan mode → 計画書作成 → 承認 → ブランチ作成 → 実装 → ... → コミットメッセージ出力

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

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

[タスク説明] → ブランチ作成 → 実装 → 自己レビュー → [確認] → コミットメッセージ出力

実行フロー

ブランチ作成 → 実装 → 自己レビュー → [確認] → コミットメッセージ出力

モード判定

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 --plan` で新しい計画を作成
- `shiiman-workflow:single タスク説明` で直接実行

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

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

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

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

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

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

• EnterPlanMode ツールを使用しないでください
• 計画書を作成しないでください
• タスク説明をそのまま実装の指針として使用してください

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

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

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

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

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

--branch 指定時:

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

計画書またはタスク説明から適切なブランチ名を生成する。

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

ステップ 2: 実装

計画書またはタスク説明の内容に基づいてコードを実装:

1. 必要なファイルを特定
2. コード変更を実施
3. 動作確認（可能な場合）

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

セキュリティチェック:

git status

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

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

自己レビュー:

git diff

以下の観点でチェック:

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

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

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

## 変更内容の確認

以下の変更を行いました:

{git diff --stat の出力}

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

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

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

この内容でよろしいですか？

ステップ 5: コミットメッセージ出力

重要: このフローではコミット・プッシュ・PR作成を行いません。

ユーザー確認後、推奨コミットメッセージを出力して終了:

## 実装完了

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

### 変更サマリー
{git diff --stat の出力}

### 推奨コミットメッセージ

以下のコミットメッセージを推奨します:

{Conventional Commits 形式のメッセージ}

**コミットメッセージ形式**:

1. まず `.claude/settings.json` の `git.commitMessage` 設定を確認
2. 設定がある場合はその形式に従う
3. 設定がない場合は Conventional Commits（日本語）を使用

### 次のステップ

プッシュするには以下を実行:

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

必要に応じて PR 作成: `gh pr create`

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

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

重要な注意事項

• ✅ モード 2 のみ EnterPlanMode を使用
• ✅ モード 1, 3 では plan mode を使用しない
• ✅ ブランチを作成する（feature/{slug} 形式）
• ✅ コミットメッセージを出力する
• ✅ 機密ファイルを警告する
• ❌ Issue を作成しない
• ❌ 自動でコミット・プッシュしない
• ❌ PR を作成しない
• ❌ デフォルトブランチで直接作業しない