# Dev Flow

> 4-phase software development flow: Spec Writing → Spec Review → Implementation → Code Review. Used with the dev-flow-orchestrator extension.

- Skill: `runceel/dev-flow` (Agent Skill)
- Install (CLI): `npx skillmds@latest add runceel/dev-flow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/runceel/dev-flow/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: runceel (https://skillmd.com/u/runceel)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/runceel/dev-flow

---


# ソフトウェア開発フロー (dev-flow)

このフローは要件から動作するコードまでの開発プロセスを自動化します。
オーケストレーターが各フェーズを専門エージェントに委任し、レビューフェーズで品質を担保します。

## フロー概要

```
[要件] → spec-writer → spec-reviewer → developer → code-reviewer → [完成]
                ↑______________|                ↑__________________|
                   差し戻し(最大3回)                差し戻し(最大3回)
```

## フェーズ説明

| フェーズ | 担当スキル | 説明 |
|---|---|---|
| spec | spec-writer | 要件から機能仕様書 (spec.md) を作成 |
| spec-review | spec-reviewer | 仕様書の品質・完全性・アーキテクチャ適合性をレビュー |
| implementation | developer | 承認済み仕様に基づいて製品コード＋ユニットテストを実装 |
| code-review | code-reviewer | 仕様適合・アーキテクチャ準拠・テストカバレッジをレビュー |

## フロー定義

```json flow-definition
{
  "name": "ソフトウェア開発フロー",
  "phases": [
    {
      "id": "spec",
      "name": "仕様策定",
      "skill": "spec-writer",
      "prompt": "以下の要件に基づいて、詳細な機能仕様書を作成してください。\n\n## 要件\n\n{requirement}",
      "output_file": "spec.md"
    },
    {
      "id": "spec-review",
      "name": "仕様レビュー",
      "skill": "spec-reviewer",
      "prompt": "以下の機能仕様書をレビューしてください。明確性・完全性・正確性・アーキテクチャ適合性の観点で評価し、問題点があれば具体的に指摘してください。",
      "input_files": ["spec.md"],
      "review": true,
      "on_reject": "spec",
      "max_retries": 3
    },
    {
      "id": "implementation",
      "name": "実装",
      "skill": "developer",
      "prompt": "以下の承認済み機能仕様書に基づいて、製品コードとユニットテストを実装してください。",
      "input_files": ["spec.md"],
      "output_file": "implementation-summary.md"
    },
    {
      "id": "code-review",
      "name": "コードレビュー",
      "skill": "code-reviewer",
      "prompt": "以下の仕様書と実装サマリーを参照し、実装されたコードをレビューしてください。仕様適合・アーキテクチャ準拠・テストカバレッジを評価してください。",
      "input_files": ["spec.md", "implementation-summary.md"],
      "review": true,
      "on_reject": "implementation",
      "max_retries": 3
    }
  ]
}
```

## 使い方

```
run_flow(flow_skill="dev-flow", requirement="タスク管理機能を追加したい。ユーザーがタスクを作成・編集・削除でき、期限でソートできること。")
```

オーケストレーター (`dev-flow-orchestrator` Extension の `run_flow` ツール) が上記フロー定義を読み込み、
各フェーズの専門エージェントを順番に起動します。

## カスタマイズ

このフローをベースに独自のフローを作成する場合は、このファイルをコピーして
`flow-definition` の JSON ブロックを編集してください。各フェーズの `skill` フィールドに
対応する `.github/skills/{skill}/SKILL.md` が必要です。