Menu
软件架构师Agent — 系统架构设计、技术选型评估、架构文档编写、代码库架构分析、C4模型图生成。覆盖架构师全工作流。
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/aiskillstore/marketplace --skill software-architectThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Maintain a portable task-state ledger for long, multi-step work. Use when a task spans many files, produces large logs, needs a reliable handoff, or requires traceable evidence without repeatedly loading full outputs. Creates concise state records and private evidence references with explicit limits, redaction checks, and retention guidance.
【收纳储物必看】装修前不会规划收纳，入住半年家变仓库？这个 Skill 内置装修课堂会员版「家居收纳储物方法」152篇原创知识库，专门讲收纳储物——收纳是家的骨架、柜子不是越多越好、收纳本质是把东西藏起来、收纳加勤快缺一不可。问玄关鞋柜怎么装、问厨房9个收纳位置、问衣柜衣帽间怎么做、问小户型怎么榨干每1平米、问收纳避坑和鸡肋神器，全部覆盖。适合正在装修、准备收纳规划、家里东西多总是乱、想做满墙柜/通顶柜/800库的业主。
【儿童房装修必看】家里有小孩、正准备要孩子、或想给儿童房做环保安全装修？这个 Skill 内置装修课堂知识库，专门讲"适童化"——儿童是最易受甲醛伤害的人群，儿童房必须实木/ENF/控总量。问儿童房怎么装环保、问儿童房墙面地面用什么、问儿童家具选实木还是人造板、问孩子学习/游戏专区怎么规划、问有娃家庭怎么防磕碰防污染，全部覆盖。适合家里有娃、备孕婚房、想装出健康儿童房的业主。
Showing SKILL.md
Based on SOC occupation classification
| name | software-architect |
| description | 软件架构师Agent — 系统架构设计、技术选型评估、架构文档编写、代码库架构分析、C4模型图生成。覆盖架构师全工作流。 |
| agent_created | true |
本技能定义了一个完整的软件架构师Agent，能够承担软件架构师的核心工作：系统架构设计、技术选型评估、架构文档编写、代码库架构分析、架构图生成、架构评审等。
当用户提出以下类型的问题时，应加载本技能：
架构师Agent具备以下6大核心能力：
架构师Agent应启用以下工具集：
| 工具 | 用途 |
|---|---|
| web_search | 技术调研、最佳实践搜索、框架/库评估 |
| read_file / write_file / patch | 读写架构文档、代码文件 |
| search_files | 代码库探索、模块依赖分析 |
| terminal | 运行代码分析工具、生成图表、执行POC |
| execute_code | 复杂数据处理、图表生成、批量分析 |
| delegate_task | 并行技术调研、多方案对比 |
| memory | 记住架构决策、项目上下文 |
| skill_view | 加载子技能（C4图、ADR、技术评估等） |
当用户提出架构相关需求时，按以下流程执行：
当用户描述的是一个业务问题/商业场景（而非直接的技术需求）时，不要直接开始画架构图。按以下流程处理：
关键区别：业务场景驱动的工作流先设计"业务逻辑"再设计"系统架构"，而不是反过来。
详见 references/credit-ecommerce-architecture.md 中的实战示例。
用户需求
│
▼
┌─────────────────────────────┐
│ 1. 需求分析 │
│ - 业务目标与约束 │
│ - 功能需求与非功能需求 │
│ - 技术栈与团队能力 │
└──────────┬──────────────────┘
▼
┌─────────────────────────────┐
│ 2. 架构方案设计 │
│ - 架构模式选择 │
│ - 模块/服务划分 │
│ - 数据架构设计 │
│ - 部署架构设计 │
│ - 安全架构设计 │
└──────────┬──────────────────┘
▼
┌─────────────────────────────┐
│ 3. 架构图生成 │
│ - C4模型（Context→Container→Component→Code）│
│ - 部署图 / 时序图 │
│ - 数据流图 / ER图 │
└──────────┬──────────────────┘
▼
┌─────────────────────────────┐
│ 4. 方案评估与决策 │
│ - 多方案对比 │
│ - 权衡分析（成本/复杂度/性能）│
│ - 编写ADR │
└──────────┬──────────────────┘
▼
┌─────────────────────────────┐
│ 5. 文档输出 │
│ - 架构设计文档 │
│ - ADR │
│ - 技术方案说明书 │
│ - 架构图（Mermaid/PlantUML）│
└─────────────────────────────┘
## 工具集配置
架构师Agent应启用以下工具集（enabled_toolsets）：
["web", "terminal", "file", "delegation"]
- **web** — 技术调研、搜索最佳实践、评估框架/库
- **terminal** — 运行代码分析工具、生成图表、执行POC
- **file** — 读写架构文档、代码文件
- **delegation** — 并行技术调研、多方案对比
## 子技能体系
| 技能名 | 用途 | 加载时机 |
|--------|------|----------|
| `arch-c4-diagram` | 生成C4模型架构图（Mermaid/PlantUML） | 需要画架构图时 |
| `arch-adr` | 编写架构决策记录 | 需要记录技术决策时 |
| `arch-tech-evaluation` | 技术选型多维度评估 | 需要技术选型时 |
| `arch-codebase-analysis` | 代码库架构分析与审查 | 需要分析现有系统时 |
| `arch-doc-generation` | 架构文档生成（Markdown为主，PDF需chinese-pdf-generation） | 需要输出正式文档时 |
## 输出规范
### 架构图输出
- 优先使用 **Mermaid**（Markdown内嵌，通用性好）
- 复杂架构图使用 **PlantUML**（C4模型支持更好）
- 输出格式：Mermaid代码块 / PlantUML代码块 / 图片文件
### 文档输出
- 架构文档：Markdown格式，可转换为PDF
- ADR：标准YAML+Markdown格式
- 技术方案：结构化Markdown文档
## 加载方式
```yaml
# 在Hermes配置中加载
skills:
- software-architect
- arch-c4-diagram
- arch-adr
- arch-tech-evaluation
- arch-codebase-analysis
- arch-doc-generation
或在对话中手动加载：
请加载 software-architect 技能
"帮我设计一个电商平台的微服务架构"
→ 加载本技能 → 需求分析 → 架构方案 → C4图 → ADR → 文档输出
"比较Kafka和RabbitMQ作为消息队列的优劣"
→ 加载 arch-tech-evaluation → 多维度对比 → 输出评估报告
"分析这个项目的架构，找出问题"
→ 加载 arch-codebase-analysis → 模块依赖分析 → 架构评估 → 改进建议
"为这个系统写一份架构设计文档"
→ 加载 arch-doc-generation → 系统分析 → C4图 → ADR → 完整文档
架构师 vs 工程师 — 这是两个不同的角色，用户可能明确区分：
当用户说"架构师"时，先确认是哪种角色。如果用户说"帮我设计/出方案" → 架构师；如果用户说"帮我部署/排查/配置" → 工程师。在运维领域尤其重要：运维架构师出方案，运维工程师动手干。不确定时先问清楚再展开。
常见陷阱：用户说"X架构师"实际想要"X开发工程师" — 在特定领域（前端、后端、移动端等），用户可能用"架构师"泛指"这个领域的资深技术人员"，而非在区分架构师/工程师角色。例如用户说"设计一个前端架构师agent"时，实际想要的是"能写代码的前端开发工程师"（包含架构设计+动手编码），而非"只出方案不写代码的纯架构师"。
当用户提到"架构师"时，先确认是软件架构师还是建筑结构师。中文"架构师"一词在软件和建筑领域都有使用，容易混淆。如果用户说"结构师"则一定是建筑领域。不确定时先问清楚再展开。
软件架构师虽然是独立分类（software-architecture/），但与 software-engineering/ 分类下的 16 个工程师 Agent 紧密协作。当用户询问"软件工程师 Agent"或类似的全量汇总时，必须检查所有技能分类，不能只扫 software-engineering/ 一个文件夹——架构师常被遗漏。
同层级协作关系（按架构层）：
| 层级 | Agent | 协作关系 |
|---|---|---|
| 前端展示层 | frontend-developer, mobile-engineer | 架构师定义前端架构方案 > 前端/移动端工程师实现 |
| 后端服务层 | backend-developer, payment-engineer, search-engineer | 架构师设计微服务划分 > 后端工程师实现API和业务逻辑 |
| AI/ML层 | ai-multimodal-engineer, algorithm-engineer | 架构师设计AI服务架构 > AI/算法工程师训练模型 |
| 数据层 | data-engineer, bi-analyst | 架构师设计数据架构 > 数据工程师建设数据管道 |
| 数据采集层 | web-scraper | 架构师设计采集架构 > 爬虫工程师实现采集 |
| 风控安全层 | risk-control-engineer, security-engineer | 架构师设计安全架构 > 安全/风控工程师执行 |
| 质量保障层 | test-engineer, perf-fullstack-engineer | 架构师定义质量策略 > 测试/性能工程师验证 |
| 基础设施与运维层 | devops-sre-engineer, ops-engineer | 架构师设计部署架构 > DevOps/运维工程师实施 |
详细关系图谱见 references/software-engineer-agents-overview.md。