common-messaging

Name: common-messaging
Author: structure-projects

当用户要求"发消息/写 MQ/消息队列/事件"时触发。覆盖消息幂等、死信队列、延迟消息、事务消息。

by structure-projects(0) 0 installs

Free

Free account. Installing gives you the manifest plus copy-paste snippets.

See reviews

About

Instruction file imported from structure-projects/structure-admin (.cursor/rules/common-messaging.mdc). Copyright stays with the author.

消息队列规范

完整规范详见 wiki/_common/messaging.md

硬约束（MUST）

✅ MUST 消费端幂等（用 Redis SETNX 去重）
✅ MUST 配置死信队列（DLQ）+ 告警
✅ MUST 跨服务消息经生态消息桥（具体类名见栈级规则，如 structure-boot 用 DataScopeStreamBridge）
✅ MUST 用生态事件管理器发布事件（具体类名见栈级规则）
✅ MUST 事件实现生态事件接口（具体接口见栈级规则）

禁止（MUST NOT）

❌ 在 Consumer 里写业务逻辑（应 dispatch 给 handler）
❌ 跳过幂等设计
❌ 不配 DLQ

关联

Wiki：wiki/_common/messaging.md
技能：coding / debug-issue

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/structure-projects-structure-admin-common-messaging-rule/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

structure-projects-structure-admin-common-messaging-rule.ocm.jsonjson

{
  "ocm": "1",
  "id": "structure-projects-structure-admin-common-messaging-rule",
  "kind": "skill",
  "name": "common-messaging",
  "description": "当用户要求\"发消息/写 MQ/消息队列/事件\"时触发。 覆盖消息幂等、死信队列、延迟消息、事务消息。",
  "publisher": "structure-projects",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "github-cursor-rules"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "当用户要求\"发消息/写 MQ/消息队列/事件\"时触发。 覆盖消息幂等、死信队列、延迟消息、事务消息。"
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github-cursor-rules",
      "repository": "https://github.com/structure-projects/structure-admin",
      "path": ".cursor/rules/common-messaging.mdc",
      "ref": "5dd748f1263c3590c1eea5907d76dcdb7a16b857",
      "url": "https://github.com/structure-projects/structure-admin/blob/5dd748f1263c3590c1eea5907d76dcdb7a16b857/.cursor/rules/common-messaging.mdc",
      "key": "structure-projects/structure-admin/.cursor/rules/common-messaging.mdc"
    },
    "applies_to": "**/*Event*.java, **/*Listener*.java, **/*Handler*.java, **/application*.yaml"
  },
  "instructions": "# 消息队列规范\n\n> 完整规范详见 `wiki/_common/messaging.md`\n\n## 硬约束（MUST）\n\n- ✅ **MUST** 消费端幂等（用 Redis SETNX 去重）\n- ✅ **MUST** 配置死信队列（DLQ）+ 告警\n- ✅ **MUST** 跨服务消息经生态消息桥（具体类名见栈级规则，如 structure-boot 用 `DataScopeStreamBridge`）\n- ✅ **MUST** 用生态事件管理器发布事件（具体类名见栈级规则）\n- ✅ **MUST** 事件实现生态事件接口（具体接口见栈级规则）\n\n## 禁止（MUST NOT）\n\n- ❌ 在 Consumer 里写业务逻辑（应 dispatch 给 handler）\n- ❌ 跳过幂等设计\n- ❌ 不配 DLQ\n\n## 关联\n\n- Wiki：`wiki/_common/messaging.md`\n- 技能：`coding` / `debug-issue`",
  "cost": {
    "context_tokens": 108
  }
}

Fetch it by URL: GET /api/v1/registry/structure-projects-structure-admin-common-messaging-rule/manifest?version=1.0.0