nickhou1983

architect

0
1
# Install this skill:
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 时

工作流

架构设计(主流程)

  1. 加载模板 — 读取 references/architecture-template.md
  2. 解读 PRD — 提取业务目标、用户画像、功能需求(P0/P1/P2)、非功能需求、技术约束
  3. 评估架构风格 — 根据业务规模选择单体 / 微服务 / Serverless / 混合架构
  4. 技术栈选型 — 前端、后端、数据库、缓存、消息队列、搜索、AI/ML、DevOps,每项附选型理由
  5. 设计核心架构 — 系统架构图(Mermaid)、模块职责、服务划分
  6. 数据模型设计 — ER 图(Mermaid)、关键表结构、索引策略
  7. API 设计 — RESTful 接口列表、认证鉴权方案、限流策略
  8. 部署架构 — 部署拓扑图(Mermaid)、环境规划、CI/CD、容器编排
  9. 非功能与安全 — 性能方案、高可用、监控告警、安全设计(OWASP)
  10. 输出文档 — 写入 docs/architecture-{项目名}.md

后续操作

架构文档生成后,可触发后续流程:

  • 提交 GitHub: 加载 github-publish Skill
  • 同步飞书: 加载 feishu-docs Skill
  • 拆分 Issues: 加载 requirement-to-issues Skill
  • 部署详设: 加载 microservices Skill 的 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.