app:
  description: IT・開発向け REST API (OpenAPI 3.0) 仕様書自動生成ワークフロー。ユーザー入力からOpenAPI YAMLドラフト、設計チェック、エンドポイント一覧、実装注意点を生成します。
  icon: 🤖
  icon_background: '#FFEAD5'
  mode: workflow
  name: OpenAPI仕様書生成ワークフロー
  use_icon_as_answer_icon: false
kind: app
version: 0.6.0
workflow:
  conversation_variables: []
  environment_variables: []
  features:
    file_upload:
      image:
        enabled: false
    opening_statement: ''
    suggested_questions: []
    suggested_questions_after_answer:
      enabled: false
    text_to_speech:
      enabled: false
  graph:
    edges:
    - data:
        sourceType: start
        targetType: llm
      id: start-to-llm1
      source: start
      target: llm1
    - data:
        sourceType: llm
        targetType: end
      id: llm1-to-end
      source: llm1
      target: end
    nodes:
    - data:
        title: 開始
        type: start
        variables:
        - label: query
          max_length: 2048
          options: []
          required: true
          type: paragraph
          variable: query
      height: 90
      id: start
      position:
        x: 80
        y: 282
      type: custom
      width: 244
    - data:
        title: OpenAPI生成
        type: llm
        model:
          provider: openai
          name: gpt-5-mini
          mode: chat
          completion_params:
            temperature: 0.2
        prompt_template:
        - role: system
          text: 'あなたはOpenAPI 3.0 仕様書作成とREST設計レビューのエキスパートです。出力は指定の4つのセクション（Part 1〜4）に厳密に分割して返してください。Part
            1 は有効な OpenAPI 3.0 形式の YAML のみを出力してください（余分な説明文やコードブロック、注釈は含めないこと）。エラー応答は
            RFC 7807 Problem Details 形式を採用し、components.schemas と components.responses
            に ProblemDetails を定義してください。


            ---


            【最終出力フォーマット (この指示が最優先)】

            最終出力は **読みやすい日本語の Markdown** で返してください。JSON

            配列・オブジェクトをそのまま出力してはいけません。

            - 見出し (## / ###) でセクションを区切る

            - リスト (- / 1.) や表 (| ... |) で構造化

            - 各項目の意図や根拠が分かるよう短い説明文を添える

            - 営業デモで顧客に直接見せられる体裁にする


            (構造化されたデータ項目を内部で扱うのは構いませんが、出力時に Markdown

            に変換してください。)'
        - role: user
          text: '以下のユーザー入力をもとに4つの出力を生成してください。ユーザー入力（1つのテキストフィールド）には、APIエンドポイントの日本語説明、リソース名、主要な操作（CRUD
            のうち該当するもの）、認証方式（例: Bearer Token, API Key, OAuth2）を含めてください。出力は日本語で行ってください。


            入力:

            {{#start.query#}}


            出力フォーマット（厳密）:

            ---PART 1: OPENAPI YAML START---

            <ここにOpenAPI 3.0準拠の YAML を出力>

            ---PART 1: OPENAPI YAML END---


            ---PART 2: RESTful 準拠チェック START---

            - 命名規則（リソース名、パス）: 指摘と修正案

            - HTTPメソッド適切性: 指摘と修正案

            - ステータスコード選定: 指摘と修正案

            ※ 各項目は箇条書きで、問題点と推奨修正を示してください。

            ---PART 2: RESTful 準拠チェック END---


            ---PART 3: エンドポイント一覧 START---

            テーブル形式（CSVまたはMarkdown表）で列を含める: Path, HTTP Method, 説明, リクエストスキーマ参照, レスポンススキーマ参照,
            認可要否

            ---PART 3: エンドポイント一覧 END---


            ---PART 4: 実装上の注意点 START---

            箇条書きで、認証、バリデーション、エラーハンドリング（RFC 7807 に基づく実装例）、パフォーマンス、セキュリティ、互換性に関する具体的注意点を述べること。

            ---PART 4: 実装上の注意点 END---


            追加の指示:

            - OpenAPI の components.securitySchemes を必ず含めること。

            - Problem Details は components.schemas.ProblemDetails として定義し、components.responses
            に共通の errorResponse を用意すること。

            - paths、components.schemas、components.responses、components.securitySchemes
            を含めること。

            - 出力言語は日本語。ただし Part 1 の OpenAPI YAML 内のフィールド名と値は OpenAPI に準拠した英語キー（openapi,
            info, paths, components 等）を使用すること。

            - Part 1 の YAML はバリデーションに通ることを意識して生成すること（例: リファレンスは "#/components/schemas/XXX"
            で参照）。

            '
        vision:
          enabled: false
        memory: null
        context:
          enabled: false
      height: 90
      id: llm1
      position:
        x: 380
        y: 282
      type: custom
      width: 244
    - data:
        title: 終了
        type: end
        outputs:
        - value_selector:
          - llm1
          - text
          variable: result
      height: 90
      id: end
      position:
        x: 680
        y: 282
      type: custom
      width: 244
  hash: null
