Agent skill

Distributed Systems Architecture

by devcodex-labs in devcodex-labs/devcodex

分布式系统架构专家 Owner — 当任务涉及消息队列、RPC、事件驱动、跨服务一致性、分布式锁/租约、交付语义、顺序、幂等、重试、补偿、分区、背压或故障注入时使用;要求把网络与重复执行视为常态并冻结可验证的不变量。

AGPL-3.0Auto-check passedBackend & APIs

Install Distributed Systems Architecture

skills CLI
$ npx skills add devcodex-labs/devcodex --skill distributed-systems-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install devcodex-labs/devcodex distributed-systems-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/devcodex-labs/devcodex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/content/skills/distributed-systems-architecture .claude/skills/distributed-systems-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
distributed-systems-architecture
GitHub stars
439
Token cost
~648 tokens
SKILL.md length
145 words
Files
3
Skills in repo
70
Repo updated
First seen
Licence
AGPL-3.0

At a glance

分布式系统架构专家 Owner — 当任务涉及消息队列、RPC、事件驱动、跨服务一致性、分布式锁/租约、交付语义、顺序、幂等、重试、补偿、分区、背压或故障注入时使用;要求把网络与重复执行视为常态并冻结可验证的不变量。

  • Works in 7 steps: 列出节点、服务、存储、broker 和外部系统的信任/失败边界。 → 冻结业务不变量与可接受一致性,而不是先选中间件。 → 为每条写路径定义… → …
  • Backend & APIs work in your project
  • SKILL.md covers 职责, DistributedSystemsArchitectureG…, 执行流程 and DurableBatchOrchestrationProbe, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Distributed Systems Architecture is an agent skill from devcodex-labs/devcodex. 分布式系统架构专家 Owner — 当任务涉及消息队列、RPC、事件驱动、跨服务一致性、分布式锁/租约、交付语义、顺序、幂等、重试、补偿、分区、背压或故障注入时使用;要求把网络与重复执行视为常态并冻结可验证的不变量。

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files (for example `agents/openai.yaml` and `intent.json`).

It sits in Backend & APIs. The repository describes itself as: Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts. The licence is AGPL-3.0.

When your agent uses it

  • Backend & APIs work in your project

Example prompts

  • “/distributed-systems-architecture”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. 列出节点、服务、存储、broker 和外部系统的信任/失败边界。
  2. 冻结业务不变量与可接受一致性,而不是先选中间件。
  3. 为每条写路径定义 delivery/order/idempotency/retry/compensation。
  4. 为 lease/lock/single-active 定义丢失资格后的 fail-safe,禁止继续副作用。
  5. 建立正常、重复、乱序、延迟、丢失、分区、恢复与重放矩阵。
  6. 将可观测字段绑定 request/event/idempotency/trace/attempt/partition。
  7. 把验证映射到 unit/integration/failure-injection/load/recovery replay。

What it can do on your machine

Read from SKILL.md and the folder at commit 1dd4525. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Distributed Systems Architecture loads about 648 tokens when it runs. Until then it costs about 35 tokens; SKILL.md has 145 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~648

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from devcodex-labs/devcodex at commit 1dd4525, republished under its AGPL-3.0 licence (© devcodex-labs). 145 words, ~648 tokens.

Download SKILL.mdSave it as .claude/skills/distributed-systems-architecture/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
distributed-systems-architecture
description
分布式系统架构专家 Owner — 当任务涉及消息队列、RPC、事件驱动、跨服务一致性、分布式锁/租约、交付语义、顺序、幂等、重试、补偿、分区、背压或故障注入时使用;要求把网络与重复执行视为常态并冻结可验证的不变量。

Distributed Systems Architecture

职责

从系统级边界统一设计一致性、交付、顺序、幂等、重试、补偿、分区与背压。backend 负责领域流程,SRE 负责运行恢复,data 负责持久化;本 Skill 负责跨节点/跨服务语义。

DistributedSystemsArchitectureGate

字段要求
consistencyModelstrong/eventual/causal/session 等选择、读写可见性和可接受陈旧窗口
deliverySemanticsat-most-once / at-least-once / effectively-once,禁止无证据承诺 exactly-once
orderingPolicyglobal/partition/key ordering、乱序窗口、重放规则
idempotencyModelkey、scope、TTL、结果缓存、并发重复和副作用边界
retryBudgetretryable 分类、backoff/jitter、总预算、deadline 与 retry storm 防护
compensationPlantransaction/outbox/saga/补偿动作、不可补偿边界和人工恢复
partitionFailureMatrixtimeout、partial failure、lease loss、split brain、clock skew、dependency outage
backpressurePlanproducer/consumer 速率、队列上限、drop/reject/degrade、dead letter 与恢复
durableBatchOrchestration数据源耗尽、持久 cursor/checkpoint、批次节奏、多 Worker 原子聚合、durable completion、Coordinator/callback 崩溃恢复

执行流程

  1. 列出节点、服务、存储、broker 和外部系统的信任/失败边界。
  2. 冻结业务不变量与可接受一致性,而不是先选中间件。
  3. 为每条写路径定义 delivery/order/idempotency/retry/compensation。
  4. 为 lease/lock/single-active 定义丢失资格后的 fail-safe,禁止继续副作用。
  5. 建立正常、重复、乱序、延迟、丢失、分区、恢复与重放矩阵。
  6. 将可观测字段绑定 request/event/idempotency/trace/attempt/partition。
  7. 把验证映射到 unit/integration/failure-injection/load/recovery replay。

DurableBatchOrchestrationProbe

队列、批处理、导入导出或 fan-out/fan-in 流程声称“完整 run”时,必须验证:

  1. 数据源是否分页/流式推进至可证明耗尽,并持久化 cursor/checkpoint。
  2. 批次节奏、并发和背压是否有界,重试后不会重复扩大副作用。
  3. 多 Worker 的 accepted/completed/failed 计数与聚合状态是否原子、幂等且可重放。
  4. BatchRun/Batch/Job/Coordinator/Completion Event(或等价领域对象)是否持久化,进程内 callback 不作为唯一完成事实源。
  5. Coordinator、Worker、callback、broker/storage 崩溃后能从持久状态恢复并保持最终完成不变量。
  6. executable evidence 覆盖 crash、duplicate、out-of-order、dependency outage、rolling drain 和恢复后聚合。

缺少任一适用项只能 partial;一次 addBulk 或内存循环只证明入队动作,不证明 durable batch orchestration。

输出字段

consistencyModel、deliverySemantics、orderingPolicy、idempotencyModel、retryBudget、compensationPlan、partitionFailureMatrix、backpressurePlan、observabilityKeys、verificationRoute、evidenceMatrix。

反模式

  • 用“最终一致”代替陈旧窗口、冲突策略和收敛条件。
  • 宣称 exactly-once,却只做消息去重或 broker ACK。
  • 所有错误无限重试,未设 deadline、jitter 和 retry budget。
  • 分布式锁过期/续租失败后仍继续写副作用。
  • 只测试正常路径,不测重复、乱序、分区和恢复。
  • 把 Redis、Kafka 或数据库选型当作系统语义本身。

验证

至少覆盖 duplicate、out-of-order、late/lost message、consumer crash、broker/storage outage、lease loss、retry storm、poison message、partial success、replay 与恢复后不变量。

© devcodex-labs, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in content/skills/distributed-systems-architecture of devcodex-labs/devcodex.

  • SKILL.md
  • agents/openai.yaml
  • intent.json

Open the folder on GitHubat commit 1dd4525

Compare with similar skills

Distributed Systems Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Distributed Systems Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Distributed Systems Architecture this skilldevcodex-labs/devcodex439—~648Automated safety check: PassAGPL-3.0
Configuring Horizoncoollabsio/coolify63k4 repos~898Automated safety check: PassMIT
Nestjs Best Practicesrolling-scopes/rsschool-app10k6 repos~1.2kAutomated safety check: PassMIT
Sub2API AdminWei-Shaw/sub2api43k1 repos~717Automated safety check: PassLGPL-3.0
Firecrawl Build Onboardingfirecrawl/firecrawl190k1 repos~1.4kAutomated safety check: NotesISC
Obsidian BasesAtmosphere/atmosphere3.8k22 repos~3.2kAutomated safety check: PassApache-2.0

Similar skills

  • Configuring Horizon

    coollabsio/coolify

    A skill your agent uses whenever the user mentions Horizon by name in a Laravel context.

    63k GitHub starsUsed in 4 repos~898 tokens
    Backend & APIsAuto-check passed
  • Nestjs Best Practices

    rolling-scopes/rsschool-app

    NestJS best practices and architecture patterns for building production-ready applications.

    10k GitHub starsUsed in 6 repos~1.2k tokens
    Backend & APIsAuto-check passed
  • Sub2API Admin

    Wei-Shaw/sub2api

    Manages a Sub2API deployment from the command line: accounts, redeem and invitation codes, groups, proxies, imports, exports and raw admin API calls.

    43k GitHub starsUsed in 1 repo~717 tokens
    Backend & APIsAuto-check passed
  • Firecrawl Build Onboarding

    firecrawl/firecrawl

    Gets Firecrawl working in a project: signs you in through the browser, saves FIRECRAWL_API_KEY to .env and picks the first SDK or REST path.

    190k GitHub starsUsed in 1 repo~1.4k tokens
    Backend & APIsAuto-check: notes
  • Obsidian Bases

    Atmosphere/atmosphere

    Create and edit Obsidian Bases (.base files) with views, filters, formulas, and summaries.

    3.8k GitHub starsUsed in 22 repos~3.2k tokens
    Backend & APIsAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed

More from devcodex-labs/devcodex

All 70 skills in this repo
  • Accessibility I18n

    devcodex-labs/devcodex

    无障碍与国际化专家 Owner — 当任务涉及可访问性、键盘操作、焦点、屏幕阅读器、ARIA、语言地区、本地化、RTL、翻译资源、用户可见文案或多语言文档时使用;要求把包容性体验和本地化验证绑定到真实用户路径。

    439 GitHub stars~718 tokensUpdated 21 days ago
    Auto-check passed
  • AI Agent System Architecture

    devcodex-labs/devcodex

    AI Agent 系统架构专家 Owner — 当任务涉及 Agent 路由、工具调用、上下文管理、记忆、状态机、权限、人机协作、可观测性、回放验证或模型辅助治理时使用;要求把 Agent 行为设计成可解释、可恢复、可审计。

    439 GitHub stars~2.4k tokensUpdated 21 days ago
    Auto-check passed
  • API Contract Architecture

    devcodex-labs/devcodex

    API 契约架构专家 Owner — 当任务涉及 public API、HTTP/SDK/CLI 契约、版本兼容、错误模型、分页过滤、幂等、Schema、类型、迁移或消费者影响时使用;要求先冻结消费者契约,再设计实现与验证。

    439 GitHub stars~865 tokensUpdated 21 days ago
    Auto-check passed
  • Architecture Design

    devcodex-labs/devcodex

    架构设计文档编排 Owner — 当用户要求架构设计、系统设计、技术架构或可指导开发、Review 与任务拆分的完整方案时使用;要求从业务流程反推节点、状态、数据、一致性、异常补偿、ADR 与实施任务。

    439 GitHub stars~1.1k tokensUpdated 21 days ago
    Auto-check passed
  • Audit Common

    devcodex-labs/devcodex

    审查公共维度 G0~G5 + Profile Freshness Check — 所有 audit 子类型必先执行的基础维度层

    439 GitHub stars~4.1k tokensUpdated 21 days ago
    Auto-check passed
  • Audit Session

    devcodex-labs/devcodex

    审计工作流的跨会话状态机 — 在 <audit-root/.audit-state/<session-id.json 持久化轮次/发现项/收敛状态,支持 Token 中断后精准恢复

    439 GitHub stars~1.8k tokensUpdated 21 days ago
    Auto-check passed

Categories

Questions about Distributed Systems Architecture

What does Distributed Systems Architecture do?

分布式系统架构专家 Owner — 当任务涉及消息队列、RPC、事件驱动、跨服务一致性、分布式锁/租约、交付语义、顺序、幂等、重试、补偿、分区、背压或故障注入时使用;要求把网络与重复执行视为常态并冻结可验证的不变量。. Distributed Systems Architecture is an agent skill from devcodex-labs/devcodex.

When should I use Distributed Systems Architecture?

Distributed Systems Architecture fits situations like: backend & APIs work in your project.

How do I install Distributed Systems Architecture in Claude Code?

Run `npx skills add devcodex-labs/devcodex --skill distributed-systems-architecture -a claude-code`. Or copy the skill folder (content/skills/distributed-systems-architecture in devcodex-labs/devcodex) into .claude/skills/distributed-systems-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Distributed Systems Architecture in Codex?

Run `npx skills add devcodex-labs/devcodex --skill distributed-systems-architecture -a codex`. Or copy the skill folder (content/skills/distributed-systems-architecture in devcodex-labs/devcodex) into .agents/skills/distributed-systems-architecture in your project. Codex loads it when a task matches its description.

Can I use Distributed Systems Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add devcodex-labs/devcodex --skill distributed-systems-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/distributed-systems-architecture, .gemini/skills/distributed-systems-architecture, .github/skills/distributed-systems-architecture and .opencode/skills/distributed-systems-architecture in your project.

What does Distributed Systems Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Distributed Systems Architecture is instructions for the agent only.

Does Distributed Systems Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Distributed Systems Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Distributed Systems Architecture use?

Distributed Systems Architecture is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Distributed Systems Architecture use?

About 648 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Distributed Systems Architecture?

Skills that share tags, products or a category with Distributed Systems Architecture: Configuring Horizon (coollabsio/coolify, 63k stars), Nestjs Best Practices (rolling-scopes/rsschool-app, 10k stars), Sub2API Admin (Wei-Shaw/sub2api, 43k stars) and Firecrawl Build Onboarding (firecrawl/firecrawl, 190k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Distributed Systems Architecture?

devcodex-labs (a GitHub organization) maintains it in devcodex-labs/devcodex, which has 439 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on September 17, 2026.

Source: devcodex-labs/devcodex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.