Designing Architectures

A solid reference guide when you're making architectural decisions and need quick lookup tables for common tradeoffs. The decision matrix alone is worth having around: sync vs async, monolith vs microservices, SQL vs NoSQL, each with actual criteria instead of hand waving. Covers the usual suspects like API design patterns (REST, GraphQL, gRPC), caching strategies, message queues, and cloud native patterns. The content is structured in Chinese but the technical concepts are universal. Think of it as a cheat sheet for those moments when you're whiteboarding a system and need to justify why you're picking Kafka over RabbitMQ or when to actually use event sourcing. Not a deep dive on any topic, but a useful decision framework.

GitHub stars: 224
last updated: Jun 10, 2026

View on GitHub

Install

$ npx -y skills add telagod/code-abyss --skill designing-architectures --agent claude-code

Installs into .claude/skills of the current project.

Files

阵法秘典 · 架构设计

判断先于执行：决定「是否做 / 选什么 / 如何取舍」（栈、方案、架构、权衡）前，先读领域判断内核 skills/_kernel/backend/SKILL.md——它管 judgment，本秘典管 execution；冲突时以内核判断为准。

路由

意图	秘典	核心
API 设计	api-design	RESTful、GraphQL、gRPC、OpenAPI
安全架构	security-arch	零信任、IAM、威胁建模、合规
云原生	cloud-native	容器、K8s、Serverless、Service Mesh
消息队列	message-queue	Kafka、RabbitMQ、事件驱动、CQRS
缓存	caching	Redis、CDN、一致性、穿透/雪崩

决策矩阵

决策点	选项 A	选项 B	判据
同步 vs 异步	REST/gRPC 同步调用	消息队列异步	延迟敏感→同步；解耦/削峰→异步
单体 vs 微服务	单体(模块化)	微服务	团队<5→单体；独立部署需求→微服务
SQL vs NoSQL	RDBMS	MongoDB/DynamoDB	强一致/关联→SQL；灵活 schema/高吞吐→NoSQL
缓存策略	Cache-Aside	Write-Through	读多写少→Aside；写后即读→Through
API 风格	REST	GraphQL	资源型 CRUD→REST；复杂聚合/前端驱动→GraphQL
事件架构	事件通知	事件溯源(ES)	简单解耦→通知；审计/回溯→ES+CQRS

原则

SOLID: S单一职责 O开闭 L里氏替换 I接口隔离 D依赖倒置
分布式: CAP定理 | BASE最终一致 | 幂等设计
安全: 纵深防御 | 最小权限 | 零信任
扩展: 水平优先 | 无状态服务 | 数据分片

SKILL.md on GitHub

Details

Repository: github.com/telagod/code-abyss
Categories: Backend & APIs, Security, Code Review & Quality, Cloud & Infrastructure, Design & UI/UX
License: MIT
First seen: Jun 11, 2026