系统架构图

本条目介绍 系统架构图 的公开用途。DeepSkill 当前公开目录说明:“映射系统架构 — 阅读代码库,识别服务及其连接关系,输出包含组件描述的 C4 级别架构图(以 Mermaid 图表形式呈现)。当被要求“映射架构”、“系统图”、“这是如何工作的”或“架构概览”时使用。” 适用场景包括系统管理、写代码与代码审查。本页根据公开目录资料和固定版本的上游仓库整理,建议使用前核对该版本的环境、工具、权限及数据处理要求。Skillπ 提供站方用途介绍与原站链接;原始 SKILL.md 和附件仅在对应许可允许时开放。

仓库
jeremylongshore/tons-of-skills-marketplace

安装方式

先用 Prompt 核对来源,也可切换到安装命令或下载可用的安装包。

安装方式

用 AI 助手安装

复制提示词,让助手先核对固定版本和依赖。

查看 Prompt收起 Prompt
先检查当前 Agent 是否已安装 SkillPI Skill Finder。如果尚未安装,请按官方仓库的说明安装并启用:https://github.com/Findskills/skillpi。然后使用 Skill Finder 打开此 SkillPI 详情页并定位 "atlas-map":https://skillpi.com/zh/skills/deepskill-bce0df1e89a18dbc9b911c8452ed074d474c7032e24683444681f2b3b57608e2。安装前核对上游来源和版本:https://github.com/jeremylongshore/tons-of-skills-marketplace/blob/6ea46b08dce892944db7c16f28d0b5308d402402/plugins/ai-agency/tonone/skills/atlas-map/SKILL.md。来源不一致时停止并说明差异。核对通过后,用 Skill Finder 安装目标 Skill,并报告安装路径和来源版本。

此命令从 GitHub 来源仓库获取指定技能。运行前请先查看源文件。

运行工具
npx skills add https://github.com/jeremylongshore/tons-of-skills-marketplace/tree/6ea46b08dce892944db7c16f28d0b5308d402402/plugins/ai-agency/tonone/skills/atlas-map --skill atlas-map
许可协议: —

来源与配置

查看 GitHub 源码

jeremylongshore/tons-of-skills-marketplace固定提交 6ea46b08dce892944db7c16f28d0b5308d402402

配置方式待核实

请查看原始来源中的适用工具、依赖和权限要求。

安装实测待补充

本条目介绍 系统架构图 的公开用途。DeepSkill 当前公开目录说明:“映射系统架构 — 阅读代码库,识别服务及其连接关系,输出包含组件描述的 C4 级别架构图(以 Mermaid 图表形式呈现)。当被要求“映射架构”、“系统图”、“这是如何工作的”或“架构概览”时使用。” 适用场景包括系统管理、写代码与代码审查。本页根据公开目录资料和固定版本的上游仓库整理,建议使用前核对该版本的环境、工具、权限及数据处理要求。Skillπ 提供站方用途介绍与原站链接;原始 SKILL.md 和附件仅在对应许可允许时开放。

↓ 0 下载 ↗ 0 分享点击

文件浏览

在原站浏览文件 ↗

原始 SKILL.md

打开原文 ↗
---
name: atlas-map
description: Map the system architecture — read the codebase, identify services and connections, output a C4-level architecture map as Mermaid diagrams with component descriptions. Use when asked to "map the architecture", "system diagram", "how does this work", or "architecture overview".
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version: 0.6.4
author: tonone-ai <hello@tonone.ai>
license: MIT
---

# Map the System Architecture

You are Atlas — the knowledge engineer from the Engineering Team. Produce an actual architecture map — not a template for making one. Read the codebase, understand the system, write the diagrams and descriptions.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

## Operating Principle

The map must answer one question clearly: _How is this system structured and how do the pieces talk to each other?_ If someone reads it and still doesn't know where a request goes when it hits the system, the map has failed.

Use the C4 model as your abstraction framework. Level 1 (System Context) orients any audience. Level 2 (Container) orients a developer joining the team. Only go to Level 3 (Component) if a single service is complex enough to warrant it.

One diagram = one question. Split rather than pile on.

---

## Step 0: Read the Codebase

Scan for structure indicators before writing anything:

- Entry points: `main.go`, `index.ts`, `app.py`, `server.*`, `cmd/`
- Package files: `package.json`, `go.mod`, `pyproject.toml`, `Cargo.toml` — frameworks and external deps
- Services: `docker-compose.yml`, `Dockerfile`, `services/`, `apps/`, `packages/` — deployable boundaries
- Infrastructure: `terraform/`, `pulumi/`, `cdk/`, `k8s/`, `helm/` — how it runs
- CI/CD: `.github/workflows/`, `Jenkinsfile` — deploy targets and environments
- Data: migration files, ORM configs, connection strings — what stores are in use
- Existing docs: `docs/architecture/`, existing ADRs, README — don't duplicate what's already accurate

If the project is small enough that a single README paragraph describes the whole system, say so and produce a simpler map. Don't use C4 ceremony for a two-file script.

---

## Step 1: Identify the Pieces

For each service, container, or significant module, determine:

- **What it does** — one sentence, no jargon
- **What it talks to** — other services, data stores, external APIs, queues
- **How it communicates** — HTTP/REST, gRPC, message queue, SQL, direct import
- **What data it owns** — which store, what schema (high level)
- **Where it runs** — container, Lambda, Edge, mobile, browser

Identify external actors: human users (who?), external systems (what SaaS, what APIs), automated systems (cron, webhooks).

---

## Step 2: Produce the C4 Level 1 — System Context

This diagram answers: _What is this system, who uses it, and what external systems does it depend on or serve?_

Write it as a Mermaid diagram. Use real names from the codebase — not placeholders.

```mermaid
graph TB
    actor1["👤 [User type — e.g., 'End User']"]
    actor2["🤖 [Admin / Operator]"]

    subgraph system["[System Name]"]
        core["[Core System]"]
    end

    ext1["[External Service — e.g., Stripe]"]
    ext2["[External Service — e.g., SendGrid]"]
    db1[("[ Primary Database]")]

    actor1 -->|"[action — e.g., 'HTTP/S']"| core
    actor2 -->|"[action]"| core
    core -->|"[protocol]"| ext1
    core -->|"[protocol]"| ext2
    core -->|"SQL"| db1
```

Annotate each arrow with the communication type. "talks to" is not an annotation.

---

## Step 3: Produce the C4 Level 2 — Container Diagram

This diagram answers: _What are the deployable units inside the system and how do they connect?_

Only include containers that actually exist in the codebase. Don't invent microservices that aren't there.

```mermaid
graph TB
    user["👤 User"]

    subgraph system["[System Name]"]
        web["[Web App]\n[React / Next.js]\nPort 3000"]
        api["[API Server]\n[Go / Gin]\nPort 8080"]
        worker["[Background Worker]\n[Python / Celery]"]
        db[("[ PostgreSQL\nUsers, Orders")]
        cache[("⚡ Redis\nSession, Rate limit")]
        queue["📨 [Queue — SQS / RabbitMQ]"]
    end

    stripe["💳 Stripe API"]
    email["📧 SendGrid"]

    user -->|"HTTPS"| web
    web -->|"REST/JSON"| api
    api -->|"SQL"| db
    api -->|"GET/SET"| cache
    api -->|"Publish"| queue
    queue -->|"Subscribe"| worker
    worker -->|"REST"| stripe
    worker -->|"REST"| email
```

Label each container with: name, technology stack, and what it owns. Keep labels concise.

---

## Step 4: Component Descriptions

After the diagrams, write a short description for each container/service:

```
### [Service Name]
- **Purpose:** [one sentence]
- **Technology:** [language, framework, runtime]
- **Owns:** [data or functionality it's responsible for]
- **Connects to:** [what it depends on and how]
- **Runs on:** [Cloud Run, Lambda, EC2, Vercel, mobile, etc.]
```

Keep each description to 5 lines max. If it needs more, the service is probably doing too much — note that.

---

## Step 5: Observations

After the diagrams and descriptions, write 2–5 observations about the architecture. Not a list of problems — observations about structure, coupling, failure modes, and scalability characteristics. Flag anything that should inform future decisions:

- Single points of failure
- Tight coupling between services that should be independent
- Data ownership ambiguities (two services writing to the same table)
- Missing resilience (no retry, no queue, synchronous chain of 4 services)
- Surprising complexity for the system's current scale

---

## Step 6: Save

Save to the project's existing docs location, or create it:

- `docs/architecture/system-context.md` — Level 1 diagram + context
- `docs/architecture/containers.md` — Level 2 diagram + component descriptions

If a `docs/architecture/` directory already exists with accurate content, update it rather than duplicate.

---

## Output Summary (CLI)

```
┌─ Architecture Map ──────────────────────────────────────┐
│ System: [name]                                          │
│ Containers: [N]  Data stores: [N]  External deps: [N]  │
├─────────────────────────────────────────────────────────┤
│ Diagrams                                                │
│   docs/architecture/system-context.md  (C4 Level 1)    │
│   docs/architecture/containers.md      (C4 Level 2)    │
├─────────────────────────────────────────────────────────┤
│ Observations                                            │
│   [!] [observation — e.g., single point of failure]    │
│   [i] [observation — e.g., auth service owns 3 DBs]    │
└─────────────────────────────────────────────────────────┘
```

## Delivery

If output exceeds the 40-line CLI budget, invoke `/atlas-report` with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.

当前收录版本

0.6.4

核对来源版本 ↗

质量评测

满分 100。前四项来自 DeepSkill 收录的质量报告。

场景价值85/100
评分依据

提供系统架构映射能力,帮助开发者快速理解复杂代码库结构

触发精准95/100
评分依据

触发词覆盖完整且边界清晰,有效避免误触或漏触

结构规范95/100
评分依据

步骤划分清晰(Step 0-6),输出格式规范,包含完整示例

执行可靠90/100
评分依据

工具使用合理,异常处理机制完善,保存逻辑具备幂等性

证据可验 (前四项均值)91/100
计算方式

取前四项原始分值的算术平均,四舍五入取整。可通过收录报告核对各项评分与说明,运行记录需单独查证。

权限与使用前检查

根据当前主文档自动整理,命中内容可能是示例或防护说明;不是实际权限声明,也未覆盖附件、外部依赖或运行行为。

未从主文档识别到上述常见操作,不能据此判断无需权限或没有风险。

本站展示提示不会授予权限。涉及文件改动、密钥、外部发送或费用时,仍由你使用的工具按需确认。

安全评级与访问范围

risk · 静态证据核验,不代表运行安全保证。

使用前请由宿主核对并授权实际文件读写、外部服务和联网目的地;本站的核验不会授予任何运行权限。

来源与使用声明 SkillPi 的部分技能资料来自公开来源或创作者提交。第三方内容的权利归各自权利人所有。安装或运行前,请查看原站的许可、权限要求和使用风险。

来源与使用

请按详情页的作者、原始来源和许可证核对使用条件,运行前检查技能需要的权限。目录收录不等于已验证安装或安全性。