Build or update the BlueBubbles external channel plugin for Moltbot (extension package, REST...
npx skills add nickhou1983/copilot-orchestra-demo --skill "architect"
Install specific skill from multi-skill repository
# Description
技术架构设计 Skill。根据产品需求文档(PRD)设计完整的技术架构方案,输出结构化的架构设计文档。覆盖技术栈选型、系统架构、数据模型、API 设计、部署方案、非功能需求、安全设计等。触发条件:(1) 设计技术架构,(2) 从 PRD 推导技术方案,(3) 系统设计/技术选型,(4) 数据库设计,(5) API 设计,(6) 部署架构设计。
# SKILL.md
name: architect
description: "技术架构设计 Skill。根据产品需求文档(PRD)设计完整的技术架构方案,输出结构化的架构设计文档。覆盖技术栈选型、系统架构、数据模型、API 设计、部署方案、非功能需求、安全设计等。触发条件:(1) 设计技术架构,(2) 从 PRD 推导技术方案,(3) 系统设计/技术选型,(4) 数据库设计,(5) API 设计,(6) 部署架构设计。"
技术架构设计 Skill
根据 PRD 或产品需求描述,生成结构化的技术架构设计文档。
参考文件
按需加载 references/ 目录下的模板文件:
| 文件 | 内容 | 何时加载 |
|---|---|---|
| architecture-template.md | 架构文档标准模板(10 个章节) | 所有架构设计任务 |
外部 Skill 依赖
架构设计过程中可能需要加载以下 Skill 的参考资料:
| Skill | 路径 | 何时加载 |
|---|---|---|
microservices |
.claude/skills/microservices/ |
当架构选择微服务风格时,加载 references/development.md 获取服务拆分和通信规范 |
feishu-docs |
.claude/skills/feishu-docs/ |
用户要求将架构文档同步到飞书时 |
github-publish |
.claude/skills/github-publish/ |
用户要求提交架构文档到 GitHub 时 |
requirement-to-issues |
.claude/skills/requirement-to-issues/ |
用户要求将架构模块拆分为 GitHub Issues 时 |
工作流
架构设计(主流程)
- 加载模板 — 读取
references/architecture-template.md - 解读 PRD — 提取业务目标、用户画像、功能需求(P0/P1/P2)、非功能需求、技术约束
- 评估架构风格 — 根据业务规模选择单体 / 微服务 / Serverless / 混合架构
- 技术栈选型 — 前端、后端、数据库、缓存、消息队列、搜索、AI/ML、DevOps,每项附选型理由
- 设计核心架构 — 系统架构图(Mermaid)、模块职责、服务划分
- 数据模型设计 — ER 图(Mermaid)、关键表结构、索引策略
- API 设计 — RESTful 接口列表、认证鉴权方案、限流策略
- 部署架构 — 部署拓扑图(Mermaid)、环境规划、CI/CD、容器编排
- 非功能与安全 — 性能方案、高可用、监控告警、安全设计(OWASP)
- 输出文档 — 写入
docs/architecture-{项目名}.md
后续操作
架构文档生成后,可触发后续流程:
- 提交 GitHub: 加载
github-publishSkill - 同步飞书: 加载
feishu-docsSkill - 拆分 Issues: 加载
requirement-to-issuesSkill - 部署详设: 加载
microservicesSkill 的references/deployment.md
快速参考
架构风格选择矩阵
| 条件 | 推荐风格 |
|---|---|
| MVP / 小团队(≤5人)/ 简单业务 | 单体架构 |
| 中大型系统 / 多团队 / 独立部署需求 | 微服务架构 |
| 事件驱动 / 高弹性 / 低运维 | Serverless |
| 核心单体 + 辅助服务 / 渐进演进 | 混合架构 |
文档质量检查清单
- [ ] 10 个章节全部填写
- [ ] 每个技术选型都有选型理由
- [ ] 架构图使用 Mermaid 且语法正确
- [ ] 非功能需求有可量化指标
- [ ] 安全设计覆盖 OWASP Top 10 核心项
- [ ] 与 PRD 需求无矛盾
- [ ] 术语表覆盖所有专业术语
# Supported AI Coding Agents
This skill is compatible with the SKILL.md standard and works with all major AI coding agents:
Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.