القائمة
微服务边界与架构决策记录模板——定义服务边界、接口契约、数据归属、通信方式。当进行架构设计或服务拆分时自动触发。 触发词：微服务、服务拆分、架构设计、服务边界、ADR。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
用 citty + @clack/prompts 构建 Node.js CLI 的端到端工作流，覆盖命令路由、参数 schema、 终端交互、异步任务 UI 与 ESM 发布。触发词：citty、clack、prompts、CLI、命令行、子命令、 交互式、spinner、defineCommand、runMain、ESM 发布。
构建、扩展或调试 CodeMirror 6 浏览器代码编辑器，覆盖状态事务、扩展原语、 装饰、Compartment、语言包、补全诊断、主题、React 集成与 CM5→CM6 迁移。 触发词：CodeMirror 6、CM6、@codemirror/、EditorView、StateField、 Lezer、@uiw/react-codemirror。
使用 @pierre/diffs 与 @pierre/trees 构建代码审查、PR 视图、IDE 文件树、Merge Conflict 解决器。 覆盖 React/Vanilla API、虚拟化、Worker Pool、SSR、Shadow DOM 主题、CodeMirror 集成。 触发词：pierre、diff 渲染、文件树、PR 视图、merge conflict。
GitHub 仓库运营 + npm 包 tag 触发发布的一体化工作流。覆盖 issue/PR 分诊、CI 排障、 安全告警，以及 npm publish（provenance / scoped）+ 自动 GitHub Release（CHANGELOG 段落注入）。 触发词：github、gh、release、publish、tag、npm、provenance、changelog、triage、ci broken、版本发布。
为长跑 AI Coding 任务（Codex /goal、Claude Code、Cursor、Kiro autopilot）构建可审计、 不假完成、抗漂移的提示词。激活后先澄清需求、自动加载 AGENTS.md / 当前 spec / lessons.md， 再产出 5 段式 goal 与长跑健康守则。触发词：goal、写 goal、长任务、长跑、ralph。
使用 Mantine 组件库构建 React UI。涵盖核心组件选型、主题定制、Styles API、 布局模式、表单处理、日期选择器、图表、日程组件、通知系统、模态框管理、 Spotlight 搜索、文件上传、轮播、富文本编辑与 50+ hooks。 触发词：Mantine、UI 组件、主题配置、Styles API、DatePicker、Schedule、 Heatmap、通知、模态框、表单布局、Spotlight、Dropzone、Carousel、hooks。
| name | microservices-boundary |
| type | architecture-rule |
| description | 微服务边界与架构决策记录模板——定义服务边界、接口契约、数据归属、通信方式。当进行架构设计或服务拆分时自动触发。 触发词：微服务、服务拆分、架构设计、服务边界、ADR。 |
| version | 1.0.0 |
| author | wta |
禁止未定义接口契约就开始开发。 没有契约的微服务开发 = 集成时必定返工。
每当做出影响系统架构的决策时，创建以下格式的 ADR：
# ADR-<序号>: <决策标题>
## 状态
提议 / 已接受 / 已废弃 / 已取代
## 背景
为什么需要做这个决策？技术或业务驱动力？
## 决策
具体做出了什么决策？
## 理由
为什么选择这个方案？
## 替代方案
考虑过哪些替代方案？为什么不选它们？
## 后果
### 正面影响
- ...
### 负面影响
- ...
### 注意事项
- ...
| 场景 | 推荐方式 | 理由 |
|---|---|---|
| 同步查询（需要立即响应） | HTTP/gRPC | 请求-响应模型，简单直接 |
| 异步通知（无需响应） | 消息队列 | 解耦、削峰、重试 |
| 数据同步（跨服务数据一致） | 事件溯源 / CDC | 最终一致性、可审计 |
| 高频低延迟 | gRPC + Protobuf | 二进制协议、强类型 |
| 通信形态 | Spring Cloud (Java) | Python (FastAPI / asyncio) | Go (chi/grpc-go) | Node (NestJS/Fastify) |
|---|---|---|---|---|
| 同步 REST | @FeignClient / WebClient | httpx.AsyncClient | net/http + retryablehttp | NestJS HttpModule / undici |
| gRPC | grpc-spring-boot-starter | grpcio + grpcio-tools | google.golang.org/grpc | @grpc/grpc-js |
| 消息队列 | Spring Cloud Stream / RabbitTemplate | aio-pika / aiokafka | confluent-kafka-go / nats.go | bullmq / kafkajs |
| 服务注册/发现 | Spring Cloud Eureka / Nacos | 通常依赖 K8s Service / Consul | 同左 | 同左 |
| 配置中心 | Spring Cloud Config / Nacos | Vault / AWS Parameter Store | 同左 | 同左 |
| 链路追踪 | Spring Boot Actuator + Micrometer + OpenTelemetry | OpenTelemetry SDK Python | OpenTelemetry SDK Go | OpenTelemetry SDK Node |
| 熔断/限流 | Resilience4j | aiobreaker / 自实现 | gobreaker | opossum |
约定：跨语言项目优先使用 OpenTelemetry + Protobuf（gRPC 或 messaging schema），保持线缆格式一致；架构决策记录中应明确选择并附 ADR。
在制定架构决策后，对照项目宪法检查：
| 反模式 | 说明 | 改进 |
|---|---|---|
| 跨服务直接数据库访问 | 破坏了服务封装和数据归属 | 通过 API 或事件访问其他服务数据 |
| 分布式单体 | 服务间高度耦合，必须同时部署 | 重新划分服务边界，明确单一职责 |
| 共享数据库 | 多个服务共用同一个数据库 schema | 每个服务拥有独立的数据库，通过 API 通信 |
| 没有版本管理 | API 变更导致下游服务崩溃 | 实施 API 版本化，保持向后兼容 |