app:
  description: コードから言語を判定し、言語に応じた形式でドキュメントコメントを自動生成するワークフロー
  icon: 📝
  icon_background: '#FFEAD5'
  mode: workflow
  name: コードドキュメント自動生成
  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: ドキュメント生成
        type: llm
        model:
          provider: openai
          name: gpt-5-mini
          mode: chat
          completion_params:
            temperature: 0.2
        prompt_template:
        - role: system
          text: 'あなたはコードドキュメント生成の専門家です。与えられたソースコードから言語を判定し、該当するドキュメンテーション形式でドキュメントコメントを生成してください。Pythonの場合はGoogle
            Style docstringを使用し、JavaScriptおよびTypeScriptの場合はJSDocまたはTSDocを使用し、Javaの場合はJavadocを使用してください。各ドキュメントコメントには説明、引数、戻り値、例外、使用例を含めてください。出力は元のコードにドキュメントコメントを挿入した完全なソースコードのみとし、余計な説明は付けないでください。


            ---


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

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

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

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

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

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

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


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

            に変換してください。)'
        - role: user
          text: '入力コード:

            {{#start.query#}}


            注意事項:

            - 元のコードを変更しないでください。ドキュメントコメントのみを追加してください。

            - PythonではGoogle Style docstringを関数、メソッド、クラスに追加してください。

            - JavaScript/TypeScriptではJSDoc/TSDocコメントを使用してください。

            - JavaではJavadocを使用してください。

            - 複数の関数やクラスがある場合、すべてにコメントを追加してください。

            - 関数の例外は可能な限り検出して記載してください。

            - 使用例と簡単な使用方法を例示してください。

            もしコードから関数やクラスが検出できない場合は、元のコードをそのまま返してください。'
        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
