Agent skill

microservice-thinking

提供微服务分布式架构思考框架,涵盖服务拆分、通信机制、基础设施、治理策略、可观测性五大维度。当需要设计微服务系统、评审分布式架构、或需要全局视角审视服务边界与协同时使用。支持 DDD 领域建模、同步/异步通信、API Gateway、服务网格、熔断降级等分布式系统关键决策。

Stars 5
Forks 1

Install this agent skill to your Project

npx add-skill https://github.com/tikazyq/agentic-spec-forge/tree/main/AGENTIC_SPEC_FORGE/spec_stage_skill/special/microservice-thinking

SKILL.md

Microservice Thinking Skill

Scope: SPECIAL(用户自定义)

版本: 0.1.0(占位)| 创建日期: 2025-11-27


概述

微服务架构整体思考维度:

┌─────────────────────────────────────────────────────┐
│              🔷 Microservice Architecture           │
├─────────────┬─────────────┬─────────────────────────┤
│  Services   │   Infra     │      Governance         │
│  ─────────  │  ─────────  │  ─────────────────────  │
│  • Domain   │  • Gateway  │  • Service Discovery    │
│  • API      │  • MQ       │  • Config Center        │
│  • Data     │  • K8s      │  • Circuit Breaker      │
│  • Events   │  • Mesh     │  • Observability        │
└─────────────┴─────────────┴─────────────────────────┘

思考维度

1. 服务拆分

  • 领域边界(DDD Bounded Context)
  • 服务粒度(避免过细/过粗)
  • 数据归属(每服务独立数据库)
  • API 契约

2. 服务通信

  • 同步通信(REST/gRPC)
  • 异步通信(消息队列)
  • 事件驱动(Event Sourcing/CQRS)
  • API 版本管理

3. 基础设施

  • API Gateway(Kong/Nginx)
  • 服务发现(Consul/Eureka)
  • 配置中心(Nacos/Apollo)
  • 容器编排(K8s/Docker Swarm)

4. 服务治理

  • 熔断降级(Hystrix/Sentinel)
  • 限流控制
  • 负载均衡
  • 服务网格(Istio/Linkerd)

5. 可观测性

  • 分布式追踪(Jaeger/Zipkin)
  • 日志聚合(ELK/Loki)
  • 指标监控(Prometheus/Grafana)
  • 告警策略

6. 数据一致性

  • 分布式事务(Saga/TCC)
  • 最终一致性
  • 幂等性设计
  • 补偿机制

分级思考深度

L1-STREAMLINED

  • 每维度选择 1 个关键决策
  • 快速架构评审(30-60 分钟)
  • 适用:简单微服务、3-5 个服务

L2-BALANCED

  • 每维度覆盖 2-3 个决策点
  • 标准架构评审(2-4 小时)
  • 包含组件选型对比
  • 适用:中型微服务、5-15 个服务

L3-RIGOROUS

  • 全维度深入分析(6 维度 × 4 子项)
  • 完整架构评审(1-2 天)
  • 包含容量规划/故障演练/成本分析
  • 生成服务依赖图 + ADR
  • 适用:企业级微服务、15+ 个服务

>> 命令

>>microservice_review_l1   # 微服务架构快速审视
>>microservice_checklist   # 生成检查清单

相关 Skills

  • 设计: component-boundary, interface-contract(服务边界和接口)
  • 原则: principle-soc, principle-solid(分离与设计原则)
  • 技术: tech-selection(中间件选型)
  • 同类: web-app-thinking(单体 vs 微服务对比)

TODO: 待细化各组件选型对比和最佳实践

Expand your agent's capabilities with these related and highly-rated skills.

tikazyq/agentic-spec-forge

code-review

执行代码审查流程(提交PR→自查→同行审查→反馈修改→合并),覆盖功能正确性、代码质量、测试完整性、安全合规四大维度。当提交Pull Request、进行结对编程、执行代码走查、需要知识共享时使用。支持L1/L2/L3三级审查深度。

5 1
Explore
tikazyq/agentic-spec-forge

code-quality

执行代码质量门禁检查(测试通过→覆盖率→Lint→GOAL追溯→可提交),验证单元测试覆盖率≥80%、集成测试通过率≥95%、代码规范零错误。当完成代码实现、准备提交代码、需要质量验证、进行提交前自检时使用。确保代码可合并。

5 1
Explore
tikazyq/agentic-spec-forge

tdd-cycle

执行 TDD 红绿重构循环(RED→GREEN→REFACTOR→REPEAT),通过先写失败测试、最小代码实现、保持绿色重构的节奏驱动开发。当启动功能开发、需要测试驱动节奏、进行迭代编码、追求高测试覆盖率时使用。提供检查清单和节奏控制。

5 1
Explore
tikazyq/agentic-spec-forge

refactoring

执行代码重构(识别坏味道→选择手法→小步修改→运行测试),在保持外部行为不变前提下改进内部结构。当TDD进入REFACTOR阶段、发现代码坏味道、需要消除重复代码、优化代码结构时使用。支持提取方法、类、参数对象等重构手法。

5 1
Explore
tikazyq/agentic-spec-forge

arch-options-compare

比较多个架构方案(单体/微服务等),从SOLID原则、成本、复杂度等维度评分,生成对比表和推荐方案。当需要向客户解释架构选择或ADR决策时使用。

5 1
Explore
tikazyq/agentic-spec-forge

dev-tech-view-supplement

根据设计补充Dev视角的技术细节(数据库/API/通信协议),帮助Dev快速进入实施。当L1/L2设计缺乏技术细节、或准备向Dev交付前使用。

5 1
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results