# Dev:feedback

> 実装完了後、学んだことをDESIGN.mdに蓄積。スキル/ルールの自己改善を提案。 ストーリー駆動開発の終点。 「フィードバック」「/dev:feedback」で起動。 Trigger: フィードバック, 学習事項蓄積, /dev:feedback, feedback, design update

- Skill: `ryryo/dev-feedback` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add ryryo/dev-feedback`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ryryo/dev-feedback/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ryryo (https://skillmd.com/u/ryryo)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/ryryo/dev-feedback

---


# フィードバック → 仕様書蓄積（dev:feedback）

## 出力先

| ファイル | Step |
|----------|------|
| `docs/FEATURES/{feature-slug}/DESIGN.md` | 2a |
| `docs/FEATURES/DESIGN.md` | 2a |
| `docs/FEATURES/{feature-slug}/IMPROVEMENTS.md` | 3 |

---

## 実行手順（必ずこの順序で実行）

### Step 0: SELECT（対象計画の選択）

`docs/FEATURES/` 配下を走査し、ユーザーにフィードバック対象を選ばせる。

#### 0a: feature 選択

1. `Glob("docs/FEATURES/*/")` で feature ディレクトリ一覧を取得
2. feature が **1つだけ** → 自動選択（確認メッセージのみ出す）
3. feature が **2つ以上** → **AskUserQuestion** で選択させる
   - 各 option: `{ label: "{feature-slug}", description: "docs/FEATURES/{feature-slug}" }`
4. 選択結果を `feature-slug` として保持

#### 0b: story 選択

1. `Glob("docs/FEATURES/{feature-slug}/stories/*/story-analysis.json")` で story 一覧を取得
2. 各 `story-analysis.json` を Read し、`story.title`（または `story` フィールド）を取得して選択肢の description に使う
3. story が **1つだけ** → 自動選択
4. story が **2つ以上** → **AskUserQuestion** で選択させる
   - 各 option: `{ label: "{story-slug}", description: story.title }`
5. 選択結果を `story-slug` として保持

**ゲート**: `feature-slug` + `story-slug` が確定

#### 0c: ワークスペース初期化

```bash
bash .claude/skills/dev/feedback/scripts/init-feedback-workspace.sh {feature-slug}
```

DESIGN.md / IMPROVEMENTS.md が未作成の場合のみテンプレートを配置する（既存ファイルは上書きしない）。

---

### Step 1: REVIEW（品質ゲート + 変更分析）

references/review-analyze.md を参照し、git diff を分析して品質ゲート判定 + 分析JSONを作成する。

1. git diff main...HEAD で差分を取得
2. OpenCode CLI（または手動チェックリスト）で実装レビュー
3. 変更内容を分析し、学習事項を抽出 → 分析JSON
4. レビュー結果をユーザーに提示
5. Critical issuesがあれば → **AskUserQuestion** で次のアクションを確認:
   - `/plan-doc` で修正計画書を作成（別スレッドで修正作業）
   - `/dev:story` で修正タスクリストを生成（別スレッドで修正作業）
   - そのまま続行（軽微な場合）

**ゲート**: レビュー + 分析JSON完了

### Step 2: DESIGN（DESIGN.md更新 + 整理）

#### 2a: 機能DESIGN.md + 総合DESIGN.md更新

references/update-design.md を参照し、Step 1 の分析結果を元に DESIGN.md を更新する。

1. 既存の DESIGN.md を Read（なければ新規作成）
2. `docs/FEATURES/{feature-slug}/DESIGN.md` に追記・保存
3. `docs/FEATURES/DESIGN.md` に重要な判断を追記

#### 2b: 総合DESIGNの整理

1. → **Task（opus）** に委譲（code-simplifier スキル）
2. 整理観点:
   - 用語・表現の一貫性
   - セクション構造の論理性
   - 冗長さの排除
   - 将来の追記性

**ゲート**: 機能DESIGN.md + 総合DESIGN.md更新完了

### Step 3: IMPROVE（ルール化検討 + CLAUDE.md更新検討 + テスト管理）

references/propose-manage.md を参照し、Step 1-2 の結果からルール化・CLAUDE.md更新の候補を検討して IMPROVEMENTS.md を Write する。

1. 既存ルール一覧を `Glob(".claude/rules/**/*.md")` で収集、CLAUDE.md を Read
2. OpenCode CLI（またはフォールバック基準）で改善分析
3. 候補ごとに具体的な当てはめ先（`.claude/rules/{category}/{name}.md` or `CLAUDE.md` の該当セクション）を明記
4. `docs/FEATURES/{feature-slug}/IMPROVEMENTS.md` に保存
5. TDDタスクがあった場合:
   - → **AskUserQuestion** でテスト整理方針を確認（整理する/すべて保持/スキップ）
   - 選択に応じてテストの簡素化・削除を実行

---

## 完了条件

- [ ] feature-slug + story-slug が確定した（Step 0）
- [ ] 実装レビュー + 変更分析が完了した（Step 1）
- [ ] 機能DESIGN.mdが更新された（Step 2a）
- [ ] 総合DESIGN.mdが更新・整理された（Step 2a + 2b）
- [ ] ルール化・CLAUDE.md更新の候補が検討された（Step 3）
- [ ] テスト資産が整理された（TDD時）（Step 3）

## 参照

- agents/: code-simplifier（Step 2b 委譲先）
- references/: review-analyze.md, update-design.md, propose-manage.md
- references/templates/: DESIGN.template.md, IMPROVEMENTS.template.md
- scripts/: init-feedback-workspace.sh