feedback

ユーザー確認必須: このスキルはGitHub Issue操作（クローズ・コメント）を伴います。自律実行時は操作内容をユーザーに提示し、承認を得てから実行してください。

Scope

• Do: フィードバックの作成・同期・分類・リンク・クローズ・フラグ解消を実行する
• Don't: リンク先req/specの内容修正や実装。修正は別途実施する

---

Feedback運用コマンド

対象: $ARGUMENTS

---

引数解析

$ARGUMENTS	モード	処理
create	新規作成	resources/create.md に従い GitHub Issue を作成
issue番号（スペース区切りで複数可）	取り込み	Step 1〜7 を実行
空	未処理一覧	Step 1〜7 を実行（Step 2 で対象選択）

---

Step 1: 同期

reqord feedback sync

---

Step 1.5: リポジトリ確認

GitHub操作前に対象リポジトリを確認する:

git remote -v

想定と異なるリポジトリの場合はユーザーに確認を取る。

---

Step 2: 対象フィードバックの特定

入力バリデーション

issue番号は正の整数のみ受け付ける（/^#?\d+$/）。# 接頭辞は任意。形式不正な入力はエラー表示してスキップ。

$ARGUMENTSが空の場合

1. reqord feedback list --state open --json で未処理一覧を取得
2. テーブル形式で表示:

| # | Issue | Type | Severity | LinkedTo | Status |
|---|-------|------|----------|----------|--------|
| 1 | #208 | bug | medium | spec-000011 | open |
| 2 | #209 | requirement-gap | medium | req-000011 | open |

3. AskUserQuestionで対象を選択してもらう（複数選択可、「全件処理」オプションも提示）

$ARGUMENTSが指定されている場合

スペース区切りで複数issue番号を受け付ける。存在しないものはエラー表示してスキップ。

---

Step 3: 内容確認

対象フィードバックごとに reqord feedback show <issue-number> --json を並列実行し、内容を確認する。

表示内容: GitHub Issue のタイトル・本文、現在の type / severity / linkedTo / status

---

Step 4: 分類・リンク判断

resources/classify-and-link.md のルールに従い、各フィードバックの Type とリンク先を判定する。

対象フィードバックごとに提示:

### #208: [Issueタイトル]
- 推奨 Type: bug
- 推奨リンク先: --spec spec-000011
- 判断理由: [Issueの内容から読み取った根拠]

AskUserQuestionで各フィードバックの Type・リンク先を確認する。

---

Step 5: リンク実行

ユーザー承認後、各フィードバックに対して reqord feedback link を実行する:

# spec にリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --spec <spec-id>

# 既存 req にリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --req <req-id>

# 新規 req を作成してリンクする場合
reqord feedback link <issue-number> --type <type> --severity <severity> --created-req

既にリンク済みのフィードバック（linkedTo に値がある）はスキップし、報告のみ行う。

注意: 1つのフィードバックが複数のreq/specに影響する場合は、影響を受けるすべてに対してリンクを実行する（複数回実行）。影響範囲の漏れを防ぐため、req/specの description やコードベースを確認すること。

---

Step 6: クローズ処理

クローズ判断

• クローズ可能: type/severity が設定済み、かつリンク先が設定済み
• クローズ不可: リンクが未完了、または追加対応が必要

Flag ライフサイクルの注意事項

重要: feedback close と flag 解消は独立した概念。

feedback close = フィードバックの取り込み完了（分類・リンク済み）
               ≠ flag 解消（req/spec の修正完了）

flag のライフサイクル:
  作成 → feedback link 時に req/spec へ自動付与
  解消 → req/spec の修正完了後に `reqord feedback resolve` で除去

.reqord/settings/setting.yaml の feedbackValidation 設定により、flag 残存時の動作が決まる:

• blockOnUnresolved: true の場合、severityThreshold 以上の severity の flag が残存していると /reqord:verify done がブロックされる
• blockOnUnresolved: false（デフォルト）の場合、flag 残存は警告のみで完了処理を妨げない

クローズ実行

reqord feedback close <issue-number>

---

Step 7: 結果確認・修正フロー案内

処理結果サマリー

| Issue | Type | Severity | リンク先 | Status |
|-------|------|----------|----------|--------|
| #208 | bug | medium | spec-000011 | closed |
| #209 | requirement-gap | medium | req-000011 | closed |

残存確認

reqord feedback list --state open

Flag 残存の注意喚起

クローズしたフィードバックに関連する req/spec の flag を確認し、未解消の flag がある場合は報告:

以下の req/spec に feedback-review flag が残っています（修正完了後に解消が必要）:
- req-000011: feedback-review (from #209)
- spec-000011: feedback-review (from #208)

修正方法:
- 要件の修正: `/reqord:edit <req-id>`
- 仕様の修正: `/reqord:edit <spec-id>`

修正完了後のflag解消は resources/resolve.md の手順、または以下を実行:
  reqord feedback resolve <artifact-id> --issue <issue-number>

修正フロー案内

flag付与後の修正→再検証フロー:

1. 修正内容確認・設計更新: /reqord:edit <spec-id|req-id>
2. 実装コンテキスト確認:   /reqord:brief <spec-id>
3. 修正実装
4. flag解消:              reqord feedback resolve <artifact-id> --issue <issue-number>
5. 再検証:                /reqord:verify done <spec-id>

---

リファレンス（resources/）

ファイル	内容	読むタイミング
resources/create.md	フィードバック新規作成手順	create サブコマンド実行時
resources/classify-and-link.md	Type判定・リンク先決定ルール	Step 4 の分類判断時
resources/resolve.md	Flag解消手順	修正完了後のflag除去時

---

エラーハンドリング

reqord CLIが見つからない場合

❌ reqord CLI が見つかりません。
インストール方法: npm install -g @reqord/cli
環境チェック: `/reqord:setup --check`

gh CLIが未認証の場合

⚠ gh CLI が未認証です。GitHub Issue操作にはgh auth loginが必要です。