메뉴
技术架构设计 Skill。根据产品需求文档（PRD）设计完整的技术架构方案，输出结构化的架构设计文档。覆盖技术栈选型、系统架构、数据模型、API 设计、部署方案、非功能需求、安全设计等。触发条件：(1) 设计技术架构，(2) 从 PRD 推导技术方案，(3) 系统设计/技术选型，(4) 数据库设计，(5) API 设计，(6) 部署架构设计。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | architect-doc |
| description | 技术架构设计 Skill。根据产品需求文档（PRD）设计完整的技术架构方案，输出结构化的架构设计文档。覆盖技术栈选型、系统架构、数据模型、API 设计、部署方案、非功能需求、安全设计等。触发条件：(1) 设计技术架构，(2) 从 PRD 推导技术方案，(3) 系统设计/技术选型，(4) 数据库设计，(5) API 设计，(6) 部署架构设计。 |
根据 PRD 或产品需求描述，生成结构化的技术架构设计文档。
按需加载 references/ 目录下的模板文件：
| 文件 | 内容 | 何时加载 |
|---|---|---|
| architecture-template.md | 架构文档标准模板（12 个章节 + 文档索引） | 所有架构设计任务 |
| module-architecture-template.md | 模块级架构文档模板 | PRD 采用模块化结构时 |
| adr-template.md | 架构决策记录（ADR）模板 | 记录关键技术选型决策时 |
| frontend-architecture-template.md | 前端架构详设子文档模板 | 分文档模式时加载 |
| backend-services-template.md | 后端服务详设子文档模板 | 分文档模式时加载 |
| database-design-template.md | 数据库设计子文档模板 | 分文档模式时加载 |
架构设计过程中可能需要加载以下 Skill 的参考资料：
| Skill | 路径 | 何时加载 |
|---|---|---|
microservices | .agents/skills/microservices/ | 当架构选择微服务风格时，加载 references/development.md 获取服务拆分和通信规范 |
feishu-docs | .agents/skills/feishu-docs/ | 用户要求将架构文档同步到飞书时 |
github-publish | .agents/skills/github-publish/ | 用户要求提交架构文档到 GitHub 时 |
requirement-to-issues | .agents/skills/requirement-to-issues/ | 用户要求将架构模块拆分为 GitHub Issues 时 |
加载主模板 — 读取 references/architecture-template.md
判断 PRD 是否模块化：
modules/ 目录modules/ 下是否存在 prd-{module_en_slug}.md判断主架构文档模式：
references/frontend-architecture-template.md、references/backend-services-template.md、references/database-design-template.md解读 PRD：
v1.0.0），用于填充架构文档头docs/ 目录下已有的 architecture-*.md，如存在则作为迭代基线分析原型图（如存在） — 在 PRD 同级目录查找 wireframes/ 和 hifi-wireframes/，按类型区分分析深度：
module_en_slug 归类，为模块级架构提供输入MVP 规模校准 — 根据 PRD 目标用户量和业务定位，确定架构复杂度等级，避免过度设计：
| 规模等级 | 判定条件 | 推荐架构风格 | 约束 |
|---|---|---|---|
| L1（轻量级） | 目标 DAU ≤ 1K 或 MVP 验证阶段 或 功能模块 ≤ 3 | 单体应用（Monolith） | 禁用微服务、K8s；优先 SQLite/PostgreSQL 单库；部署用单容器或 PaaS |
| L2（标准级） | 目标 DAU 1K-50K 且功能模块 4-8 | 模块化单体（Modular Monolith） | 可用消息队列但不拆服务；单库或读写分离；部署用 Docker Compose 或托管服务 |
| L3（复杂级） | 目标 DAU > 50K 或 功能模块 > 8 或 有明确的多团队并行开发需求 | 微服务（Microservices） | 可使用 K8s、服务网格、分库分表；需论证拆分必要性 |
校准规则：
规模等级: L1/L2/L3 字段，供 Gate 2 评审核验评估架构风格 — 根据规模校准结果和业务需求选择单体 / 微服务 / Serverless / 混合架构
技术栈选型 — 前端、后端、数据库、缓存、消息队列、搜索、AI/ML、DevOps，每项附选型理由
设计主架构总纲：
设计模块级架构（仅模块化模式）：
references/module-architecture-template.mdprojects/prd-{项目名}/architecture-{项目名}.mdprojects/prd-{项目名}/architecture-{项目名}-{module_en_slug}.mdv1.0.0projects/prd-{项目名}/frontend-architecture-{项目名}.mdprojects/prd-{项目名}/backend-services-{项目名}.mdprojects/prd-{项目名}/database-design-{项目名}.md启动前执行：
node scripts/workflow-manifest.js check {项目} architecture
校验通过后产出主架构 / 模块级架构文档，落盘后写入：
echo '{
"agent": "architect",
"doc": "projects/prd-{项目}/architecture-{项目}.md",
"version": "v{X.Y.Z}",
"linked_prd": "v{X.Y.Z}",
"module_arch_count": {N}
}' | node scripts/workflow-manifest.js set {项目} architecture
规范见 docs/workflow-manifest-spec.md。
架构文档生成后，可触发后续流程：
github-publish Skillfeishu-docs Skillrequirement-to-issues Skill；若存在模块级架构文档，优先让下游消费模块级架构microservices Skill 的 references/deployment.md当检测到 projects/prd-{项目名}/modules/ 目录时，以下规则默认生效：
projects/prd-{项目名}/architecture-{项目名}.mdprojects/prd-{项目名}/architecture-{项目名}-{module_en_slug}.mdv1.0.0| 评估维度 | 权重 | 单体架构 | 微服务架构 | Serverless | 混合架构 |
|---|---|---|---|---|---|
| 团队规模 | 20% | ≤5人 ✅ | >10人 ✅ | 不限 | 5-15人 ✅ |
| 交付时间 | 15% | 快 ✅ | 慢 | 中 | 中 |
| 弹性需求 | 15% | 低 | 中 | 高 ✅ | 中 |
| 运维复杂度 | 15% | 低 ✅ | 高 | 中 | 中 |
| 独立部署 | 15% | 不支持 | 支持 ✅ | 支持 ✅ | 部分支持 |
| 技术异构性 | 10% | 不支持 | 支持 ✅ | 支持 | 部分支持 |
| 成本（初期） | 10% | 低 ✅ | 高 | 按用量 | 中 |
快速判断：MVP/小团队→单体 | 多团队/独立部署→微服务 | 事件驱动/高弹性→Serverless | 渐进演进→混合
必检项（所有项目必须通过）：
prd-xxx.md v1.0.0）条件检项（满足条件时必须通过）：
wireframes/，低保真分析提取了页面清单和导航结构hifi-wireframes/，高保真分析额外提取了设计系统和交互动效microservices Skill 规范architecture-{项目名}-{module_en_slug}.md工作流度量仪表盘 Skill。一条命令扫描 pm-assistant 项目目录的本地产物（gate-results JSON、PRD 文档、wireframes、hifi-wireframes），生成含 Chart.js 图表的自包含 HTML 仪表盘（dashboard.html）。展示：7 阶段流程进度时间轴、产物统计卡片（Module PRD 数 / 低保真原型数 / 高保真原型数 / Gate 评审轮次）、Gate 评审雷达图 + 堆叠条形图（pass/warn/fail）、待改进事项清单。触发条件：(1) 查看/生成项目指标或度量，(2) 生成工作流仪表盘，(3) 可视化 Gate 评审结果，(4) 流程健康检查，(5) 产物覆盖率统计，(6) 生成 dashboard，(7) 查看评审进度或产物状态。
文档质量 Lint 检查 Skill。对 PRD、架构文档进行结构化 Lint 检查，自动生成需求追溯矩阵（RTM），追踪 Gate Warning 闭环。触发条件：(1) PRD Lint/文档检查，(2) 架构文档 Lint，(3) 生成 RTM/需求追溯矩阵，(4) Warning 追踪/扫描，(5) 文档质量检查，(6) Gate 预检，(7) doc-lint。
通过飞书远程 MCP 服务查询和操作飞书云文档。支持搜索文档、读取文档内容、创建/更新文档、查看知识库目录、获取评论等。触发条件：(1) 查询飞书文档，(2) 搜索飞书云文档内容，(3) 读取飞书文档/知识库，(4) 创建或更新飞书文档，(5) 同步飞书文档内容到本地，(6) 查看飞书文档评论。
工作流度量仪表盘 Skill。一条命令扫描 pm-assistant 项目目录的本地产物（gate-results JSON、PRD 文档、wireframes、hifi-wireframes），生成含 Chart.js 图表的自包含 HTML 仪表盘（dashboard.html）。展示：7 阶段流程进度时间轴、产物统计卡片（Module PRD 数 / 低保真原型数 / 高保真原型数 / Gate 评审轮次）、Gate 评审雷达图 + 堆叠条形图（pass/warn/fail）、待改进事项清单。触发条件：(1) 查看/生成项目指标或度量，(2) 生成工作流仪表盘，(3) 可视化 Gate 评审结果，(4) 流程健康检查，(5) 产物覆盖率统计，(6) 生成 dashboard，(7) 查看评审进度或产物状态。
代码审查规范 Skill。对代码进行系统化审查，按 MUST/SHOULD/NIT 三级分类输出审查意见，覆盖正确性、安全性、可维护性、性能、规范性五大维度。触发条件：(1) 代码审查/Code Review，(2) PR Review/Pull Request 审查，(3) 审查代码质量，(4) MUST/SHOULD/NIT 分级审查，(5) 代码走查，(6) 审查这个 PR。
LLM-as-Judge 文档质量评估 Skill。利用大模型对 PRD 和架构文档进行深层语义质量评估，超越结构 Lint 检测「写了但写得不好」的问题。触发条件：(1) 文档质量评估/评审，(2) LLM-as-Judge，(3) PRD 语义审查，(4) 架构文档深度评审，(5) doc-quality-judge，(6) 文档语义评分。