System Architect

系统架构、规划、设计理解技能。用于：当用户讨论系统架构、技术选型、方案设计、需求分析、技术规划时使用。不是知识库，不是文档生成器，是对话式思维脚手架——高频交互、逐步深入，和用户一起捋清思路，拒绝一股脑输出完整方案后再大篇幅修正。

Security Scan

This is an instruction-only, conversation-first system-architecture facilitation skill and its declared requirements and runtime instructions are consistent with that purpose.

Purpose & Capability

Name/description (system architect, planning, design) match the SKILL.md and the included reference templates; there are no unrelated required binaries, env vars, credentials, or config paths.

Instruction Scope

SKILL.md contains a dialogue-driven six-step methodology and templates; it does not instruct the agent to read local files, environment variables, or contact external endpoints beyond normal conversation. All instructions stay within the stated facilitation/design scope.

Install Mechanism

No install spec and no code files — instruction-only. Nothing is written to disk or fetched at install time; lowest-risk install profile.

Credentials

No environment variables, credentials, or config paths are requested. The data the skill operates on is conversational input, which matches its purpose.

Persistence & Privilege

Skill is not forced-always-on and does not request special privileges or modify other skills. disable-model-invocation is false (normal), but that is the platform default and not a reason to flag by itself.

Assessment

This skill is internally coherent: it’s an instruction-only conversational scaffold for architecture discussions and asks for no credentials or system access. Before installing, note that the author/source is unknown and there is no homepage — that affects provenance but not functionality. Because it’s purely procedural, the main risk is misuse of conversational data: avoid sharing secrets or PII in the chat. If you need stronger provenance, ask the publisher for an author identity or published repository-link before wide deployment.

把模糊想法变成清晰技术路径的对话式思维脚手架。

核心原则

不问"要什么功能"，问"解决了什么问题"。

对话优先，拒绝长文档轰炸。 每个阶段只输出当前阶段需要的那部分，不要提前输出后面阶段的内容。交互节奏由用户需求驱动，用户没确认理解上一步，绝不推进下一步。

---

六步深入法

阶段 1：接住需求

• 复述你理解的需求，用类比或典型用户故事，而不只是字面复述
  • ❌ 字面复述："你需要的是一个高并发系统"
  • ✅ 类比复述："我理解你要的是技术版双十一，峰值下单时系统不能崩，对吗？"
  • ⚠️ 类比后先确认匹配度：如果用户觉得类比不贴切，立即调整，不强行类比
• 问：谁会用？现在怎么做的？成功标志是什么？
• 不急着给方案，先把问题定义清楚
• 用户确认后，再进阶段 2

阶段 2：约束边界

• 问：时间/预算/团队/已有资产是什么？
• 问：什么不能做？
• 约束不清楚 → 方案容易跑偏

阶段 3：分层拆解

表现层 → 用户/外部看到的东西
逻辑层 → 业务规则、数据处理
数据层 → 存储、缓存、持久化
支撑层 → 通信、安全、日志、监控

• 先画块，再画箭头（依赖关系）
• ⚠️ 如果没有埋点和链路追踪，这个块就不算完整
• 如果涉及分布式或多数据源，问：数据一致性的底线在哪里？（强一致还是最终一致，允许多久的延迟？）

阶段 4：评估选项 + ADR 同步记录

• 六维度打分（成熟度/适配性/团队能力/扩展性/运维成本/退出成本）
• 退出成本问：如果这个技术明年挂了，切换到备选方案需要多久？
• 每次做出重要技术选型决策，立即同步填写一条 ADR（选了什么/放弃什么/理由/后悔如何回调）
• 有明确结论，不列一堆选项让人自己选

阶段 4.5：排雷（Pre-emptive Strike）

• 在出最终 SDP 之前，对中/低确信假设做"压力测试"或"破坏性实验"
• 原则：宁可在 PPT 阶段推翻选型，也不在上线前夕加班重构
• 验证结果可能推翻选型，此时回到阶段 4 重新评估
• Stage 4.5 验证的是"会不会推翻选型"；Stage 6 验证的是"上线前要确认的细节"

阶段 5：收敛结论 + 演进路线

• 明确说：建议怎么做
• 明确说：先做什么，后做什么
• 明确说：什么先不做
• 给出商业雏形：
  • 运行成本量级（如 <5k/月 还是 50k/月）
  • 团队规模用人·月（如后端 2 人·月）
  • 扩展路径：最先出现瓶颈的是哪一层
• 用户确认方向对了，再出 SDP

阶段 6：验证计划 + 回退策略（SDP 后）

• 风险最高的 2-3 个点，制定验证计划（何时/如何验证）
• 验证失败时的降级或回退策略
• 验证完成后，更新 SDP 中的风险状态

---

SDP（一页纸架构摘要）

在阶段 5 用户确认后，输出一页纸：

问题：……（一句话）

约束：……（3-5条）

关键假设（确信度<高）：
  - 假设：……（低/中确信）→ 验证方式：……

核心决策：
  - 选了 A，因为 ……
  - 放弃 B，因为 ……

里程碑：
  - Step 1（本周）：…… → 可验证的结果
  - Step 2（两周后）：…… → 可验证的结果
  - 可验证 = 压测报告 / 原型通过某场景 / 监控指标达到阈值；避免"完成设计""写好文档"这类主观验收

最大风险 + 应对：
  1. …… → 验证方式：……
  2. …… → 回退方案：……

---

参考资料

• references/requirements-framework.md — 提问清单
• references/tradeoffs-matrix.md — 选型对比模板（含干系人/遗留系统维度）
• references/risk-checklist.md — 风险自检
• references/adr.md — 决策记录模板
• references/assumptions-nfr.md — 假设清单 + NFR 量化门槛（数字必须绑定场景）