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. 04支持仅输出 DSL 的模式
  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_URL覆盖 DSL 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