mcpField
P
processon-diagram-generator

processon-diagram-generator

github.com/full-stack-skillsドキュメント270 回インストール4 週間前に更新
リポジトリ

processon-diagram-generator について

根拠に基づく図の仕様を、編集可能なProcessOn DSLに変換し、希望に応じて画像もレンダリングするスキルです。ホスト上で編集できる出力向けで、Mermaid、PlantUML、マインドマップのみの場合は専用スキルを案内します。

主な機能

  1. 01依頼や資料から図の構造を抽出
  2. 02編集可能なProcessOn DSLを生成
  3. 03任意の画像レンダリング
  4. 04DSLのみの出力モード
  5. 05一部の一時的な通信失敗を再試行

活用シーン

  1. 01編集可能なProcessOn業務フロー図の作成
  2. 02画像を生成せずDSLのみを出力
  3. 03参照した資料から図を作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/full-stack-skills/document-skills --skill processon-diagram-generator

インストール後、Claude Code で/processon-diagram-generatorを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

agents/
openai.yaml
scripts/
check_update.py
processon_api_client.py
tests/
test_processon_api_client.py
version/
coze-version.json
github-version.json

詳細

ProcessOn 図生成ツール

根拠に基づく図の仕様を編集可能な DSL に変換し、要求された場合はレンダリング済み画像も生成します。

使い分け

  • ProcessOn またはホスト上で編集可能な出力が要求された場合にのみ、このスキルを使用します。
  • 通常の Markdown ネイティブな図には mermaid スキルを使用します。インストール方法：npx skills add full-stack-skills/document-skills --skill mermaid
  • 厳密な UML、C4、または .puml 出力には plantuml スキルを使用します。インストール方法：npx skills add full-stack-skills/document-skills --skill plantuml
  • ProcessOn 対応のマインドマップ用アウトラインのみが必要な場合は、processon-mindmap スキルを使用します。インストール方法：npx skills add full-stack-skills/document-skills --skill processon-mindmap

設定

必須：

export PROCESSON_API_KEY="<your-processon-api-key>"

キーは https://smart.processon.com/user で取得します。キーを表示、保存したり、プロンプトや出力に含めたりしないでください。

任意の設定：

変数用途
PROCESSON_DSL_API_URLDSL API URL を上書きします
PROCESSON_RENDER_API_URL画像レンダリング API URL を上書きします
PROCESSON_MODELリモートモデルを上書きします
PROCESSON_UIDリクエスト UID を上書きします
PROCESSON_CONNECT_TIMEOUTリクエストのタイムアウト時間（秒）
PROCESSON_MAX_RETRIESタイムアウト、429、5xx エラー時の再試行回数

呼び出しのたびにリモートの更新確認を行わないでください。ユーザーから更新またはメンテナンスについて尋ねられた場合にのみ、同梱されているバージョンファイルを確認してください。

明示的な更新確認は、要求された場合にのみ実行します：

python3 scripts/check_update.py

ワークフロー

  1. リクエストまたは調査したソースから、ノード、関係、判断、参加者、状態、ラベルを抽出します。
  2. ソースを調査して不足している関係を補います。曖昧さによって図が大きく変わる場合にのみ、質問してください。
  3. ユーザーの言語を維持し、交差を最小限に抑えた読みやすいレイアウトを求める、簡潔なプロンプトを作成します。
  4. 同梱のクライアントを実行します：
python3 scripts/processon_api_client.py \
  --title "登录流程" \
  "生成登录、鉴权、数据查询和令牌签发流程图"
  1. 編集可能な DSL のみが必要な場合は、--no-render を使用します。
  2. 画像のレンダリングに失敗した場合も、完全な DSL と編集 URL を提示します。

出力要件

最終回答には、以下を含める必要があります：

  • 省略のない完全な DSL；
  • 編集 URL https://smart.processon.com/editor；
  • レンダリングに成功した場合は、レンダリング画像の URL または保存先パス；
  • レンダリングに失敗した場合は、失敗理由を明確に記載すること；
  • 図の再構成にあたって置いた前提。

ホストが対応している場合は、通常の Markdown リンクまたはローカル画像プレビューを使用します。ユーザーから要求されない限り、URL のみを記載する形式を強制しないでください。

信頼性に関するルール

  • タイムアウト、接続障害、HTTP 429、HTTP 5xx の場合にのみ再試行します。
  • 上限付きの指数バックオフを使用します。
  • 認証エラーや、その他の確定的な 4xx エラーは再試行しないでください。
  • DSL の提示を、画像レンダリングの成否に左右させないでください。
  • 画像は、指定されたプロジェクトまたは明示された出力ディレクトリの下に保存します。マシン固有のハードコードされたパスは使用しないでください。
  • 空または不正な API レスポンスは、認証情報を漏らさない診断メッセージを添えて拒否します。

検証

完了前に、DSL が空でないこと、図の種類が既知であるか明示的に汎用として指定されていること、編集 URL が含まれていること、ローカル出力先がある場合はそのパスが存在することを確認します。クライアントを変更した後は、オフラインのユニットテストを実行します：

python3 -m unittest discover -s tests -p 'test_*.py'

コメント

Markdown 対応