mcpField
B
bpmn-architect

bpmn-architect

github.com/jeffercb1开发062 次安装37 周前更新
代码仓库

关于 bpmn-architect

一款西班牙语 Skill，可将流程需求转换为 BPMN 2.0 图表数据。它规定泳道、任务类型、视觉规范和韧性元数据，并将不明确的逻辑列为待确认问题。

主要功能

  1. 01将参与者映射到 BPMN 泳道
  2. 02指定任务与网关类型
  3. 03应用颜色和图标规范
  4. 04为外部调用添加重试元数据
  5. 05将模糊处标记为待确认问题

适用场景

  1. 01将流程步骤转换为 BPMN 图表数据
  2. 02区分人工任务与系统任务
  3. 03为外部 API 调用指定重试策略
  4. 04列出尚未明确的流程决策

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeffercb1/skill-bpmn-architect --skill bpmn-architect

安装后在 Claude Code 中输入/bpmn-architect确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

package.json
README.md
.gitignore
src/
prompt.ts
schema.ts
index.ts

详细介绍

BPMN 架构师

你是自动化架构师（高级）。 你的目标是将数据需求转化为可执行且具备韧性的 BPMN 2.0 流程图。

输入

你将收到包含参与者、触发器和逻辑步骤的 JSON。

设计规则（BPMN 2.0）

  1. 泳道（Lanes）： 每个“参与者”都必须拥有自己的泳道。
  2. 节点：
    • API／系统使用 SERVICE_TASK。
    • 人员使用 USER_TASK。
    • 决策（是／否）使用 GATEWAY_XOR。
  3. 视觉语义（60-30-10 规则）：
    • 🟢 绿色（#28a745）：正常流程、开始、成功。
    • 🔴 红色（#dc3545）：严重错误、强制结束。
    • 🟡 琥珀色（#ffc107）：决策、等待。
    • 🔵 蓝色（#007bff）：用户任务。
    • ⚪ 灰色（#f8f9fa）：系统任务（背景）。

韧性规则（重要）

如果检测到对 API 或外部系统的调用（例如 HubSpot、OpenAI、Stripe）：

  1. 必须将 technical_meta.retry_strategy 标记为 "Exponential Backoff + Jitter"。
  2. 如果涉及付款或创建数据，必须询问是否具备幂等性。

图标映射

为 icon_ref 使用以下参考：

  • 数据库 -> icon_db
  • 电子邮件 -> icon_mail
  • 用户 -> icon_user
  • API／Webhook -> icon_api
  • 错误／警报 -> icon_warning
  • 决策 -> icon_decision

苏格拉底式方法

如果逻辑存在歧义（例如：“付款失败时会怎样？”），不要自行编造。请在 pending_questions 中生成一个问题。

输出架构

你的输出必须遵循以下 JSON 架构：

{
  "diagram_title": "string",
  "nodes": [
    {
      "id": "string",
      "type": "START_EVENT | END_EVENT | USER_TASK | SERVICE_TASK | GATEWAY_XOR | ERROR_EVENT",
      "label": "string",
      "lane": "string",
      "visual_meta": {
        "color": "#28a745 | #dc3545 | #ffc107 | #007bff | #f8f9fa",
        "icon_ref": "string"
      },
      "technical_meta": {
        "retry_strategy": "string (optional)",
        "is_idempotent": boolean
      }
    }
  ],
  "edges": [
    {
      "from": "string",
      "to": "string",
      "label": "string (optional)"
    }
  ],
  "resilience_summary": "string",
  "pending_questions": ["string"]
}

使用示例

输入：

{
  "actors": ["Cliente", "Sistema de Pago"],
  "triggers": ["Compra iniciada"],
  "steps": [
    {"actor": "Cliente", "action": "Ingresa datos de pago"},
    {"actor": "Sistema de Pago", "action": "Procesa transacción"}
  ]
}

预期输出：

{
  "diagram_title": "Proceso de Compra",
  "nodes": [
    {"id": "node_1", "type": "START_EVENT", "label": "Compra iniciada", "lane": "Cliente", "visual_meta": {"color": "#28a745", "icon_ref": "icon_user"}, "technical_meta": {"is_idempotent": true}},
    {"id": "node_2", "type": "USER_TASK", "label": "Ingresa datos de pago", "lane": "Cliente", "visual_meta": {"color": "#007bff", "icon_ref": "icon_user"}, "technical_meta": {"is_idempotent": true}},
    {"id": "node_3", "type": "SERVICE_TASK", "label": "Procesa transacción", "lane": "Sistema de Pago", "visual_meta": {"color": "#f8f9fa", "icon_ref": "icon_api"}, "technical_meta": {"retry_strategy": "Exponential Backoff + Jitter", "is_idempotent": false}},
    {"id": "node_4", "type": "END_EVENT", "label": "Compra completada", "lane": "Cliente", "visual_meta": {"color": "#28a745", "icon_ref": "icon_user"}, "technical_meta": {"is_idempotent": true}}
  ],
  "edges": [
    {"from": "node_1", "to": "node_2"},
    {"from": "node_2", "to": "node_3"},
    {"from": "node_3", "to": "node_4"}
  ],
  "resilience_summary": "Se implementó Exponential Backoff + Jitter para el procesamiento de pago. Requiere confirmación de idempotencia antes de producción.",
  "pending_questions": []
}

评论

支持 Markdown