AgentSkillsCN

architecture-design

复杂系统架构建模与方法论工具。适用于 architecture、system design、software architecture、架构设计、系统设计、架构建模、架构分析、架构评审、架构决策、architecture review、architecture decision、system modeling、形式化架构等场景。集成 C4 模型、形式化方法、ADR 记录、第一性原理分析等多种能力。

SKILL.md
--- frontmatter
name: architecture-design
description: 复杂系统架构建模与方法论工具。USE WHEN architecture, system design, software architecture, 架构设计, 系统设计, 架构建模, 架构分析, 架构评审, 架构决策, architecture review, architecture decision, system modeling, 形式化架构. 整合C4模型、形式化方法、ADR记录、第一性原理分析等能力。
implements: Architect
context: fork

Customization

Before executing, check for user customizations at: ~/.claude/skills/PAI/USER/SKILLCUSTOMIZATIONS/architecture-design/

If this directory exists, load and apply any PREFERENCES.md, configurations, or resources found there. These override default behavior. If the directory does not exist, proceed with skill defaults.

🚨 MANDATORY: Voice Notification (REQUIRED BEFORE ANY ACTION)

You MUST send this notification BEFORE doing anything else when this skill is invoked.

  1. •

    Send voice notification:

    bash
    curl -s -X POST http://localhost:8888/notify \
  -H "Content-Type: application/json" \
  -d '{"message": "Running architecture design workflow"}' \
  > /dev/null 2>&1 &
  2. •

    Output text notification:

    code
    🔧 Running the **ArchitectureDesign** skill for [purpose]...

This is not optional. Execute this curl command immediately upon skill invocation.

Architecture Design Skill

复杂系统架构建模与方法论工具，整合多种架构设计方法。

核心能力

能力工具适用场景
概念建模第一性原理分析新系统从零设计
架构描述C4 Model系统全景可视化
形式化验证TLA+/Alloy关键逻辑正确性
决策记录ADR架构决策可追溯
架构评审多角度分析方案审查与改进

Workflow Routing

Route to the appropriate workflow based on the request.

场景路由

场景工作流说明
新系统设计 / 从零开始Workflows/NewSystemDesign.md第一性原理+能力建模
现有系统分析Workflows/SystemAnalysis.md架构理解+文档化
架构决策Workflows/ArchitectureDecision.md多方案评估+ADR
架构评审Workflows/ArchitectureReview.md风险识别+改进建议
微服务拆分Workflows/MicroserviceDesign.md领域驱动拆分
架构演进Workflows/ArchitectureEvolution.md渐进式改进

方法路由

需求调用技能
追本溯源分析FirstPrinciples skill
C4图表绘制c4-modeling skill
形式化建模formal-methods skill
ADR记录adr-management skill
多角度评审Council skill
对抗性分析RedTeam skill

架构设计框架

第一性原理架构建模

code
┌─────────────────────────────────────────────────────────────┐
│  步骤1: 能力抽取                                          │
│  └── 系统需要哪些核心能力？                                  │
│       → 认知、记忆、决策、演化、身份                         │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  步骤2: 约束识别                                            │
│  └── 什么是真正的硬约束？                                   │
│       → 资源有限性、技术边界、哲学原则                        │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│  步骤3: 架构构建                                            │
│  └── 从本质出发，重新组合子系统                              │
│       → 不预设形式，只解决问题                               │
└─────────────────────────────────────────────────────────────┘

C4建模流程

code
Context (系统上下文) → Container (容器) → Component (组件) → Code (代码)

形式化验证流程

code
需求抽取 → TLA+/Alloy建模 → 模型检查 → 问题修复 → 验证通过

输出格式

架构设计文档模板

markdown
# 架构设计: [系统名称]

## 1. 设计目标
- 核心目标: [是什么]
- 成功标准: [如何衡量]

## 2. 能力模型
| 能力 | 描述 | 优先级 |
|------|------|--------|
|      |      |        |

## 3. 约束分析
| 约束类型 | 约束描述 | 能否变更 |
|----------|----------|----------|
| 硬约束   |          | 否       |
| 软约束   |          | 是       |

## 4. 架构视图
### 4.1 C4 Context
[系统上下文图]

### 4.2 C4 Container
[容器图]

### 4.3 C4 Component
[组件图]

## 5. 关键决策
| ID | 决策 | 理由 | 替代方案 |
|----|------|------|----------|
|    |      |      |          |

## 6. 风险与缓解
| 风险 | 影响 | 概率 | 缓解措施 |
|------|------|------|----------|
|      |      |      |          |

## 7. 形式化验证
[如有] TLA+ Spec / Alloy Model 验证结果

集成模式

与其他Skills的协作

markdown
## 架构设计流程

1. **需求分析**
   → 使用 FirstPrinciples 追本溯源

2. **方案生成**
   → 使用 BeCreative 发散思维
   → 使用 Council 多角度讨论

3. **方案评估**
   → 使用 RedTeam 对抗分析
   → 使用 c4-modeling 可视化

4. **决策记录**
   → 使用 adr-management 记录

5. **形式验证** (关键系统)
   → 使用 formal-methods 验证

适用场景示例

场景1: 设计AI数字生命系统

  1. •使用 NewSystemDesign 工作流
  2. •能力建模: 认知、记忆、决策、演化、身份
  3. •约束分析: Token限制、时间约束、L0哲学
  4. •C4建模: 4层架构
  5. •ADR记录关键决策
  6. •TLA+验证Protocol状态机

场景2: 评审现有架构

  1. •使用 ArchitectureReview 工作流
  2. •分析现有架构文档
  3. •识别风险点
  4. •提出改进建议

场景3: 架构演进规划

  1. •使用 ArchitectureEvolution 工作流
  2. •分析当前架构
  3. •规划演进路径
  4. •制定迁移策略

质量标准

  • •每个架构决策必须有ADR记录
  • •关键逻辑必须经过形式化验证
  • •C4图必须保持一致性和可追溯性
  • •架构文档必须版本化

整合能力: FirstPrinciples, c4-modeling, formal-methods, adr-management, Council, RedTeam