Always respond in Japanese. Write all workflow documents (*.md) in Japanese.

/ghwf0-remote

GitHub Issue/PR のラベルを監視し、ワークフローを自動実行するデーモンを制御する。

Usage

/ghwf0-remote start    # デーモン起動
/ghwf0-remote stop     # デーモン停止
/ghwf0-remote status   # 状態確認

Label Schema

Opt-in Label (Required)

Label	Description
`ghwf`	デーモン監視を有効化（必須）

Note: ghwf ラベルがないIssueは、コマンドラベルがあっても無視されます。

State Labels (Daemon Managed)

Label	Description
`ghwf:executing`	実行中
`ghwf:waiting`	承認待ち
`ghwf:completed`	完了

Command Labels (User Assigned)

Label	Description	Requires Update
`ghwf:exec`	次ステップを実行	No
`ghwf:redo`	現在ステップ再実行	Yes
`ghwf:redo-N`	step N から再実行	Yes
`ghwf:revision`	wf1 から全体再実行	Yes
`ghwf:stop`	監視停止	No

Progress Labels (Daemon Managed)

ghwf:step-1 〜 ghwf:step-7

Configuration

Environment Variable	Default	Description
`POLL_INTERVAL`	60	Polling interval in seconds
`MAX_STEPS_PER_SESSION`	0 (unlimited)	Max workflow steps before daemon pauses
`VERBOSE`	false	Enable detailed logging

Retry Settings

Environment Variable	Default	Description
`GHWF_RETRY_MAX`	3	Max retry attempts for API calls
`GHWF_RETRY_DELAY`	5	Initial retry delay (seconds)
`GHWF_RETRY_BACKOFF`	2	Backoff multiplier
`GHWF_CLAUDE_RETRY_MAX`	2	Max retries for Claude calls
`GHWF_CLAUDE_RETRY_DELAY`	30	Initial delay for Claude retries

Example:

GHWF_RETRY_MAX=5 MAX_STEPS_PER_SESSION=20 /ghwf0-remote start

Daemon Behavior

Polling (60秒間隔)

1. Query: Issues/PRs with ghwf + ghwf:* command labels
2. For each:
   a. ghwf:exec → 次ステップ実行
   b. ghwf:redo* → 更新チェック → step N から実行
   c. ghwf:revision → 更新チェック → step 1 から実行
   d. ghwf:stop → 監視停止
3. ラベル更新
4. Push

Update Detection (redo*/revision)

以下のいずれかの更新がなければ待機:

Issue/PR に新しいコメント (bot 除く)
Issue 本文の更新
PR レビューコメント

Bot コメントの判定:

author: github-actions[bot]}
body が 🤖 で始まる

Processing

start

Check prerequisites: gh auth status, tmux
Launch tmux session ghwf-daemon
Run ~/.claude/scripts/ghwf/ghwf-daemon.sh
Confirm startup

stop

Kill tmux session ghwf-daemon
Confirm shutdown

status

Check commands:

# Daemon status
tmux ls 2>&1 | grep -E "ghwf-daemon"

# Active Claude process
ps aux | grep -E "claude.*ghwf" | grep -v grep

# Current execution info (if running)
cat .wf/ghwf-current.json 2>/dev/null

# Claude output log (stream-json format)
cat .wf/ghwf-claude.log 2>/dev/null | tail -50

# Recent daemon log
tmux capture-pane -t ghwf-daemon -p -S -20

Display (table format):

ghwf-daemon ステータス
┌──────────────────┬───────────────────────────┐
│       項目       │           状態            │
├──────────────────┼───────────────────────────┤
│ デーモン         │ ✅ 実行中                 │
│ tmux session     │ ghwf-daemon               │
│ 起動時刻         │ 2026-02-02 11:32:31 (JST) │
│ 最終ポーリング   │ 2026-02-02 11:32:36 (JST) │
│ 実行済みステップ │ 0                         │
└──────────────────┴───────────────────────────┘

実行中のClaudeプロセス
┌───────────┬──────────────────────────────────────┐
│   項目    │                 状態                 │
├───────────┼──────────────────────────────────────┤
│ コマンド  │ /ghwf1-kickoff revise                │
│ 対象      │ Issue #1                             │
│ 実行時間  │ 21秒                                 │
│ CPU使用率 │ 2.3%                                 │
└───────────┴──────────────────────────────────────┘

監視中のワーク
- なし

Claude詳細出力 (直近)
{"type":"tool_use","name":"Read","input":{"file_path":"/path/to/file"}}
{"type":"tool_result","content":"file contents..."}
{"type":"text","content":"ファイルを読み込みました。"}

最近のログ (直近10行)
[2026-02-02 11:32:31] Polling for ghwf:* labels...
[2026-02-02 11:32:35] Processing issue #1 with label: ghwf:revision
[2026-02-02 11:32:36] Executing step 1: ghwf1-kickoff

If no Claude process running, show:

実行中のClaudeプロセス
なし（待機中）

Claude詳細出力
なし（実行中のプロセスがありません）

State Files

`.wf/ghwf-state.json` (Daemon state)

{
  "daemon": {
    "enabled": true,
    "started_at": "2026-01-31T10:00:00Z",
    "last_poll": "2026-01-31T10:05:00Z",
    "tmux_session": "ghwf-daemon"
  },
  "works": {
    "<work-id>": {
      "issue": 123,
      "pr": 456,
      "current_step": 3,
      "last_execution": "2026-01-31T10:00:00Z"
    }
  }
}

`.wf/ghwf-current.json` (Current execution)

Claude実行中のみ存在。実行完了時に削除される。

{
  "step": 1,
  "command": "ghwf1-kickoff",
  "mode": "revise",
  "issue": 1,
  "started_at": "2026-02-02T02:32:36Z",
  "pid": 12345
}

`.wf/ghwf-claude.log` (Claude output)

claude --print --output-format stream-json の出力。各行がJSONオブジェクト（tool_use, tool_result, text等）。

{"type":"tool_use","name":"Read","input":{"file_path":"..."}}
{"type":"tool_result","content":"..."}
{"type":"text","content":"処理完了"}

Security

Rule	Description
Collaborator-only	`admin`/`write`/`maintain` 権限のみ
Command whitelist	`ghwf:*` ラベルのみ処理
Bot ignore	自動コメントは更新判定から除外

ghwf0-remote