/zen:issue:update

Issue の作業メモリコメントを手動で更新する

---

概要

このコマンドは作業メモリを手動で更新するためのものです。

自動更新と手動更新

zen workflow では、以下のコマンド実行時に作業メモリが自動的に更新されます:

コマンド	自動更新内容
/zen:issue:start	作業メモリの初期化、実装計画の記録
/zen:pr:create	変更ファイル、コミット履歴、PR 情報の記録
/zen:pr:fix	レビュー対応履歴の記録
/zen:pr:cleanup	完了情報の記録
/zen:lint	品質チェック結果の記録（条件付き: Issue ブランチのみ）

このコマンドの用途

/zen:issue:update は以下の場合に使用します:

1. 決定事項の記録: 重要な設計判断や方針決定をメモしたいとき
2. 補足情報の追加: 自動更新では記録されない追加情報を残したいとき
3. 進捗の手動更新: 特定のタイミングで進捗状況を記録したいとき
4. 次のセッションへの引き継ぎ: セッション終了前に状況を整理したいとき

---

このコマンドを実行したら、以下のフェーズを順番に実行してください。

引数

引数	説明
[memo]	追加するメモ（省略可）

---

Phase 0: 現在の Issue 特定

0.1 ブランチ名から Issue 番号を抽出

現在のブランチ名を取得し、Issue 番号を抽出:

git branch --show-current

ブランチ名のパターン: {type}/issue-{number}-{slug}

抽出ルール:

1. issue- の後に続く数字を抽出
2. 例: feat/issue-13-implement-update → Issue #13

0.2 ブランチ名から Issue 番号が抽出できない場合

現在のブランチから Issue 番号を特定できません。

現在のブランチ: {branch_name}

オプション:
- Issue 番号を手動で指定
- キャンセル

AskUserQuestion で Issue 番号を確認。

0.3 Issue の存在確認

gh issue view {issue_number} --json number,title,state

Issue が見つからない場合:

エラー: Issue #{number} が見つかりません

対処:
1. `gh issue list` で Issue 一覧を確認
2. 正しい Issue 番号を指定して再実行

---

Phase 1: 作業メモリコメントの検索

1.1 Issue のコメント一覧を取得

gh api repos/{owner}/{repo}/issues/{issue_number}/comments --jq '.[] | {id: .id, body: .body}'

1.2 作業メモリコメントの特定

コメント本文に ## 🧘 zen 作業メモリ を含むコメントを検索。

見つからない場合:

警告: 作業メモリコメントが見つかりません

この Issue は `/zen:issue:start` で開始されていない可能性があります。

オプション:
- 新規に作業メモリコメントを作成
- キャンセル

AskUserQuestion で確認し、必要に応じて新規作成。

---

Phase 2: 更新情報の収集

2.1 変更ファイルの取得

# ステージング状態を確認
git status --porcelain

# 変更の統計を取得
git diff --stat HEAD

2.2 変更ファイルリストの整形

変更ファイルを以下の形式に整形:

### 変更ファイル
- `path/to/file1.ts` - 追加
- `path/to/file2.ts` - 変更
- `path/to/file3.ts` - 削除

ステータスの判定:

• A / ?? → 追加
• M → 変更
• D → 削除
• R → 名前変更

2.3 ユーザーメモの処理

引数でメモが指定されている場合、「決定事項・メモ」セクションに追加。

---

Phase 3: 作業メモリの更新

3.1 更新内容の構築

作業メモリコメントを以下の形式で更新:

## 🧘 zen 作業メモリ

### セッション情報
- **開始**: {original_start_timestamp}
- **ブランチ**: {branch_name}
- **最終更新**: {current_timestamp}

### 進捗
{existing_progress_with_updates}

### 変更ファイル
{updated_file_list}

### 決定事項・メモ
{existing_notes}
- [{timestamp}] {new_memo}

### 次のステップ
{existing_next_steps}

3.2 コメントの更新

gh api repos/{owner}/{repo}/issues/comments/{comment_id} \
  -X PATCH \
  -f body="{updated_body}"

---

Phase 4: 完了報告

更新完了を報告:

Issue #{number} の作業メモリを更新しました

変更ファイル: {file_count} 件
最終更新: {timestamp}

メモが追加された場合:

Issue #{number} の作業メモリを更新しました

変更ファイル: {file_count} 件
追加メモ: {memo_preview}
最終更新: {timestamp}

---

更新タイミングのガイダンス

コマンド実行時に以下のガイダンスを参考情報として表示:

カテゴリ	タイミング
必須	複数ファイル変更完了時、重要な決定時、エラー対処時
推奨	30分経過時、複雑な処理の前、休憩前

---

エラーハンドリング

main/master ブランチの場合

警告: 現在 {branch} ブランチにいます

作業ブランチに切り替えてから実行してください。
または `/zen:issue:start {number}` で新しい作業を開始してください。

Issue がクローズされている場合

警告: Issue #{number} は既にクローズされています

作業メモリの更新をスキップします。

コメント更新に失敗した場合

エラー: 作業メモリコメントの更新に失敗しました

考えられる原因:
- ネットワークエラー
- 権限不足
- コメントが削除された

対処:
1. `gh issue view {number}` で Issue を確認
2. 再度実行

---

使用可能なツール

• Bash: gh コマンド、git コマンド実行
• Read: 設定ファイル読み取り
• AskUserQuestion: ユーザー確認・明確化