一个强大的集成，使 AI 代理能够使用 Structurizr 的代码即数据方法对软件架构进行可视化、文档化和管理。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install structurizr
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 structurizr。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Structurizr AI Skill？
针对 Openclaw Skills 的 Structurizr 技能使开发人员和架构师能够以编程方式与其软件模型进行交互。通过利用 Membrane 框架，此技能允许 AI 代理在复杂的系统层级结构中导航——从高级软件系统到单个组件——而无需手动的身份验证开销。它专为在开发生命周期中将架构视为一等公民的团队而设计。
使用此技能，您的 AI 代理可以直接在 Structurizr 生态系统内查询现有工作空间、更新架构图并记录技术决策。它缩小了原始代码与视觉文档之间的差距，确保系统图通过自动化工作流与实际实现保持同步。
Structurizr AI Skill 应用场景
- 自动架构映射：根据代码库分析自动生成并更新 C4 模型图。
- 系统文档：以编程方式管理工作空间文档和架构决策记录 (ADRs)。
- 可视化部署：映射不同环境中的部署节点和基础设施节点。
- 架构审计：查询现有模型以识别软件系统中的结构不一致或缺失的关系。
Structurizr AI Skill 工作原理
- CLI 初始化：代理使用 Membrane CLI 建立针对特定环境定制的安全会话。
- 连接建立：创建到 Structurizr API 的连接，由 Membrane 处理 OAuth 或 API 密钥握手。
- 操作发现：代理对特定操作（如创建容器视图或更新模型）执行自然语言搜索。
- 执行：代理运行带有 JSON 参数的结构化操作以修改架构工作空间。
- Proxy 回退：对于小众 API 端点，代理使用 Membrane proxy 向 Structurizr 发送直接的身份验证请求。
Structurizr AI Skill 配置指南
要在 Openclaw Skills 中开始使用此技能，请按照以下步骤操作：
安装 Membrane CLI：
npm install -g @membranehq/cli@latest
登录并指定您的代理类型：
membrane login --tenant --clientName=openclaw
创建到 Structurizr 的连接：
membrane connection ensure "https://structurizr.com/" --json
Structurizr AI Skill 数据架构与分类体系
该技能根据官方 Structurizr 层级结构组织数据。下表描述了可用的主要数据实体：
| Level | Description |
|---|---|
| Workspace | 模型、视图和文档的顶级容器。 |
| Model | 包含软件系统、容器和组件。 |
| Relationships | 定义模型中不同元素如何交互。 |
| Views | 视觉呈现（系统上下文、容器、组件、部署）。 |
| Documentation | 包括决策 (ADRs) 在内的 Markdown 或 AsciiDoc 内容。 |
Structurizr AI Skill 高级特性
- 透明身份验证刷新：无需手动处理过期的令牌；Openclaw Skills 通过 Membrane 在服务器端管理完整生命周期。
- 自然语言意图映射：使用类人查询搜索功能，以找到所需的精确 API 操作。
- 多代理协作：支持各种代理类型（openclaw、claude、windsurf），并具有优化的工具调整。
- 长轮询连接状态：内置逻辑以等待异步连接构建和客户端操作。
SKILL.md
加载中
Openclaw 相关技能
精选*
