# martiny9/agent-notes architecture

> Architecture diagram of the GitHub repository martiny9/agent-notes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martiny9/agent-notes
- Repository: https://github.com/martiny9/agent-notes

## Overview

This repository is a Chinese AI Agent learning and practical-use guide, not an executable software system. Its principal reader journey is to understand Agent concepts, survey the product landscape, compare options, then read a product-specific guide or explore Skills and research workflows. The graph represents that documented learning path and the collection’s major topic branches. Relationships are based on the README’s stated recommendations and linked contents; article-internal relationships were not inspected.

Main entry points: [`README.md`](https://github.com/martiny9/agent-notes/blob/main/README.md) (文集导览), [`02-主流Agent产品/08-横向对比与选型.md`](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/08-%E6%A8%AA%E5%90%91%E5%AF%B9%E6%AF%94%E4%B8%8E%E9%80%89%E5%9E%8B.md) (横向对比与选型), [`02-主流Agent产品/01-Agent产品全景.md`](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/01-Agent%E4%BA%A7%E5%93%81%E5%85%A8%E6%99%AF.md) (产品全景), [`02-主流Agent产品/05-Hermes-Agent.md`](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/05-Hermes-Agent.md) (Hermes Agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundations["背景与原理"]
  node_agent_intro["Agent是什么<br/>[01-什么是AI-Agent.md]"]
  node_agent_architecture["核心概念与架构<br/>[02-Agent核心概念与架构.md]"]
end

subgraph group_products["产品认知与选型"]
  node_product_overview["产品全景<br/>[01-Agent产品全景.md]"]
  node_product_selection["横向对比与选型<br/>[08-横向对比与选型.md]"]
end

subgraph group_product_guides["产品实操指南"]
  node_claude_code["Claude Code<br/>[02-Claude-Code.md]"]
  node_openai_codex["OpenAI Codex<br/>[03-OpenAI-Codex.md]"]
  node_openclaw["OpenClaw<br/>[04-OpenClaw.md]"]
  node_hermes_product["Hermes Agent<br/>[05-Hermes-Agent.md]"]
  node_open_source_agents["开源Agent合集<br/>[06-开源Agent合集.md]"]
  node_domestic_products["国内编程产品<br/>[07-国内AI编程产品.md]"]
  node_hermes_example["Hermes实例<br/>[Hermes.md]"]
end

subgraph group_skills["Skill与科研"]
  node_skill_mcp["Skill与MCP入门<br/>[01-Skill与MCP入门.md]"]
  node_research_workflow["科研工作流<br/>[02-科研工作流.md]"]
  node_skill_collection["实用Skill合集<br/>[03-有意思的Skill.md]"]
end

node_reader(("学习者"))
node_readme["文集导览<br/>[README.md]"]

node_reader -->|"starts with"| node_readme
node_readme -->|"suggests first"| node_agent_intro
node_readme -->|"introduces"| node_agent_architecture
node_readme -->|"read first"| node_product_overview
node_readme -->|"recommends"| node_product_selection
node_readme -->|"quick-start option"| node_claude_code
node_readme -->|"quick-start option"| node_domestic_products
node_readme -->|"assistant option"| node_openclaw
node_readme -->|"covers"| node_skill_mcp
node_readme -->|"covers"| node_research_workflow
node_readme -->|"covers"| node_skill_collection
node_product_overview -->|"supports choosing"| node_product_selection
node_product_selection -->|"selects product"| node_claude_code
node_product_selection -->|"selects product"| node_openai_codex
node_product_selection -->|"selects product"| node_openclaw
node_product_selection -->|"selects product"| node_hermes_product
node_product_selection -->|"selects product"| node_open_source_agents
node_product_selection -->|"selects product"| node_domestic_products
node_hermes_product -->|"continues with"| node_hermes_example

click node_readme "https://github.com/martiny9/agent-notes/blob/main/README.md"
click node_agent_intro "https://github.com/martiny9/agent-notes/blob/main/01-%E8%83%8C%E6%99%AF%E4%B8%8E%E5%8E%9F%E7%90%86/01-%E4%BB%80%E4%B9%88%E6%98%AFAI-Agent.md"
click node_agent_architecture "https://github.com/martiny9/agent-notes/blob/main/01-%E8%83%8C%E6%99%AF%E4%B8%8E%E5%8E%9F%E7%90%86/02-Agent%E6%A0%B8%E5%BF%83%E6%A6%82%E5%BF%B5%E4%B8%8E%E6%9E%B6%E6%9E%84.md"
click node_product_overview "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/01-Agent%E4%BA%A7%E5%93%81%E5%85%A8%E6%99%AF.md"
click node_product_selection "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/08-%E6%A8%AA%E5%90%91%E5%AF%B9%E6%AF%94%E4%B8%8E%E9%80%89%E5%9E%8B.md"
click node_claude_code "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/02-Claude-Code.md"
click node_openai_codex "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/03-OpenAI-Codex.md"
click node_openclaw "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/04-OpenClaw.md"
click node_hermes_product "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/05-Hermes-Agent.md"
click node_open_source_agents "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/06-%E5%BC%80%E6%BA%90Agent%E5%90%88%E9%9B%86.md"
click node_domestic_products "https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/07-%E5%9B%BD%E5%86%85AI%E7%BC%96%E7%A8%8B%E4%BA%A7%E5%93%81.md"
click node_skill_mcp "https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/01-Skill%E4%B8%8EMCP%E5%85%A5%E9%97%A8.md"
click node_research_workflow "https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/02-%E7%A7%91%E7%A0%94%E5%B7%A5%E4%BD%9C%E6%B5%81.md"
click node_skill_collection "https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/03-%E6%9C%89%E6%84%8F%E6%80%9D%E7%9A%84Skill.md"
click node_hermes_example "https://github.com/martiny9/agent-notes/blob/main/04-Hermes%E5%AE%9E%E4%BE%8B/Hermes.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agent_intro,node_agent_architecture toneBlue
class node_product_overview,node_product_selection toneAmber
class node_claude_code,node_openai_codex,node_openclaw,node_hermes_product,node_open_source_agents,node_domestic_products,node_hermes_example toneMint
class node_skill_mcp,node_research_workflow,node_skill_collection toneRose
class node_reader toneIndigo
class node_readme toneTeal
```

## Components

### 背景与原理

- [Agent是什么](https://github.com/martiny9/agent-notes/blob/main/01-%E8%83%8C%E6%99%AF%E4%B8%8E%E5%8E%9F%E7%90%86/01-%E4%BB%80%E4%B9%88%E6%98%AFAI-Agent.md): `01-背景与原理/01-什么是AI-Agent.md`
- [核心概念与架构](https://github.com/martiny9/agent-notes/blob/main/01-%E8%83%8C%E6%99%AF%E4%B8%8E%E5%8E%9F%E7%90%86/02-Agent%E6%A0%B8%E5%BF%83%E6%A6%82%E5%BF%B5%E4%B8%8E%E6%9E%B6%E6%9E%84.md): `01-背景与原理/02-Agent核心概念与架构.md`

### 产品认知与选型

- [产品全景](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/01-Agent%E4%BA%A7%E5%93%81%E5%85%A8%E6%99%AF.md): `02-主流Agent产品/01-Agent产品全景.md`
- [横向对比与选型](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/08-%E6%A8%AA%E5%90%91%E5%AF%B9%E6%AF%94%E4%B8%8E%E9%80%89%E5%9E%8B.md): `02-主流Agent产品/08-横向对比与选型.md`

### 产品实操指南

- [Claude Code](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/02-Claude-Code.md): `02-主流Agent产品/02-Claude-Code.md`
- [OpenAI Codex](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/03-OpenAI-Codex.md): `02-主流Agent产品/03-OpenAI-Codex.md`
- [OpenClaw](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/04-OpenClaw.md): `02-主流Agent产品/04-OpenClaw.md`
- [Hermes Agent](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/05-Hermes-Agent.md): `02-主流Agent产品/05-Hermes-Agent.md`
- [开源Agent合集](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/06-%E5%BC%80%E6%BA%90Agent%E5%90%88%E9%9B%86.md): `02-主流Agent产品/06-开源Agent合集.md`
- [国内编程产品](https://github.com/martiny9/agent-notes/blob/main/02-%E4%B8%BB%E6%B5%81Agent%E4%BA%A7%E5%93%81/07-%E5%9B%BD%E5%86%85AI%E7%BC%96%E7%A8%8B%E4%BA%A7%E5%93%81.md): `02-主流Agent产品/07-国内AI编程产品.md`
- [Hermes实例](https://github.com/martiny9/agent-notes/blob/main/04-Hermes%E5%AE%9E%E4%BE%8B/Hermes.md): `04-Hermes实例/Hermes.md`

### Skill与科研

- [Skill与MCP入门](https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/01-Skill%E4%B8%8EMCP%E5%85%A5%E9%97%A8.md): `03-Skill与科研技巧/01-Skill与MCP入门.md`
- [科研工作流](https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/02-%E7%A7%91%E7%A0%94%E5%B7%A5%E4%BD%9C%E6%B5%81.md): `03-Skill与科研技巧/02-科研工作流.md`
- [实用Skill合集](https://github.com/martiny9/agent-notes/blob/main/03-Skill%E4%B8%8E%E7%A7%91%E7%A0%94%E6%8A%80%E5%B7%A7/03-%E6%9C%89%E6%84%8F%E6%80%9D%E7%9A%84Skill.md): `03-Skill与科研技巧/03-有意思的Skill.md`

### Other components

- **学习者**
- [文集导览](https://github.com/martiny9/agent-notes/blob/main/README.md): `README.md`

## Connections

- 学习者 → 文集导览: starts with
- 文集导览 → Agent是什么: suggests first
- 文集导览 → 核心概念与架构: introduces
- 文集导览 → 产品全景: read first
- 文集导览 → 横向对比与选型: recommends
- 文集导览 → Claude Code: quick-start option
- 文集导览 → 国内编程产品: quick-start option
- 文集导览 → OpenClaw: assistant option
- 文集导览 → Skill与MCP入门: covers
- 文集导览 → 科研工作流: covers
- 文集导览 → 实用Skill合集: covers
- 产品全景 → 横向对比与选型: supports choosing
- 横向对比与选型 → Claude Code: selects product
- 横向对比与选型 → OpenAI Codex: selects product
- 横向对比与选型 → OpenClaw: selects product
- 横向对比与选型 → Hermes Agent: selects product
- 横向对比与选型 → 开源Agent合集: selects product
- 横向对比与选型 → 国内编程产品: selects product
- Hermes Agent → Hermes实例: continues with