SA 的工作，
照单显形。
OpenArch 是面向 Solutions Architect（售前全栈架构师）的开源工具箱：把岗位工作显性化为可审计的技能资产与可执行工作流。新手跟练入职，在岗梳理标准，资深沉淀传承。第一张已交付的工作单：架构设计。
| 支柱 | 核验 | 综合评分 |
|---|---|---|
卓越运营 OPERATIONAL EXCELLENCE |
98 | |
安全性 SECURITY |
94 | |
可靠性 RELIABILITY |
91 | |
性能效率 PERFORMANCE EFFICIENCY |
95 | |
成本优化 COST OPTIMIZATION |
92 |
一
岗位全景
SA 的工作从来不止画架构图。OpenArch 按售前生命周期把岗位展开成连续的工作单：红色的是已经闭环交付的，其余在路线图上，逐张补齐。
客户洞察ROADMAP
需求澄清工作单 01 · 已交付
方案设计工作单 01 · 已交付
架构评审工作单 01 · 已交付
PoC 验证ROADMAP
投标与交付ROADMAP
复盘沉淀ROADMAP
OA-P01新手 SANEWCOMER · 0 → 1
岗位地图 + 逐步 SOP + 可跑通的示例项目。跟着第一张工作单完整走一遍，看一个 SA 怎么把一句业务需求变成可交付的方案，跑通了就知道这个岗位每天在做什么。
亲手跑出的五件套交付物与完整演示工程，直接作为面试作品。入职证据，自己生成
OA-P02在岗 SAIN ROLE · 标准化
把个人交付习惯梳理成版本化的技能包与清单。需求怎么问、方案怎么选型、评审怎么过，每一单按同一套标准执行，经验不再只存在自己脑子里。
隐性经验升级为可审计、可复用的团队资产。工作流，从个人到标准
OA-P03资深 SASENIOR · 传承
把最佳实践写成可执行的技能资产。方法论以 Markdown 沉淀在仓库里，Agent 照它执行，新人照它上手，团队的标准有了唯一的出处。
提交一个技能包，就是完成一次沉淀与传承。资产进仓库，方法留得下
三类角色，同一套机制：技能包承载方法论，工具保证结构化，工件落盘可校验。你的阶段决定你怎么用它，不决定它能给你什么。
二
第一张工作单：架构设计
岗位全景里第一张闭环交付的工作单。它把一次架构设计固定为五个可校验的步骤，每一步由一个结构化工具承担，产出落盘的工件，而不是留在聊天记录里。新手从这张单入门，老 SA 用它校准自己的流程。
01
需求澄清把对话提炼成结构化需求卡：业务场景、规模/并发、可用性目标、预算区间、合规约束。必填项缺失时主动追问。
structure_requirementsOA-T01 · 需求卡 schema
需求卡 JSON缺失必填项列表
02
方案生成Agent 按需读取 arch-design 技能：场景模式识别 → 参考架构选型 → 组件选型，产出方案文档。
skill: arch-designOA-SK-01 · 原生 Skill 接入
方案文档选型依据可追溯
03
架构图输出生成 Mermaid 架构图，语法校验失败自动修正重试（上限 2 次），并导出可编辑的 draw.io 文件。
validate_diagram · export_drawioOA-T02 / OA-T03 · 纯逻辑工具
Mermaid + .drawio校验通过才交付
04
WAF 评审按 aliyun-waf 五支柱清单逐项评估，校验覆盖完整性，计算评分表与高风险项清单。
review_with_wafOA-T04 · 机读清单
五支柱评分表 + 风险清单覆盖完整性校验
05
交付物打包把需求卡、方案、架构图、评审结果组装为一份 Markdown 交付文档，写入 ./deliverables/。
export_deliverableOA-T05 · 落盘交付
Markdown 交付文档五件套归档
三
终端实录
MVP 的界面就是你的终端：流式输出、工具调用确认、Ctrl+C 中断。下面是一次完整跑通第一张工作单的演示会话，每个工具调用都是真实链路。
openarch · launch_console
演示会话
$ openarch AgentScope Console · OpenArch v0.1 · 就绪 你 › 给一个日均 10 万订单的电商设计一套架构 agent › 调用 structure_requirements … ⚠ 缺失必填项：可用性目标、预算区间。请补充 你 › 可用性 99.95%，预算每月 3 万以内 agent › structure_requirements → 需求卡 [OA-REQ-0001] ✓ [工具确认] 允许执行 review_with_waf ？(y/n) y agent › 读取技能 arch-design · 场景模式：电商交易主链路 agent › 方案生成完成 · 选型依据 6 条已写入方案文档 agent › validate_diagram → Mermaid 语法通过 ✓ agent › export_drawio → deliverables/oa-0001.drawio ✓ agent › review_with_waf → 五支柱 91.4 · 高风险 2 项 · 卓越运营 92 / 安全性 88 / 可靠性 95 / 性能 93 / 成本 89 agent › export_deliverable → deliverables/oa-0001.md ✓ 交付完成：5 件套已归档 → ./deliverables/
四
技能资产
工作显性化的载体就是技能包：方法论文档是产品本体，Agent 是执行器。每个技能包是一个目录：SKILL.md + 知识正文 + 交付模板，经 AgentScope Toolkit 原生接入，Agent 按需读取。
OA-SK-01
arch-designskills/arch-design
需求分析框架、常见场景模式（Web 应用 / 数据平台 / AI 推理服务等）、选型决策树。
自研方法论 + 公开最佳实践
OA-SK-02
aliyun-wafskills/aliyun-waf
Well-Architected 五支柱检查清单与问卷条目，结构化供 review_with_waf 机读。
阿里云公开 WAF 文档 · 逐条可溯源
OA-SK-03
sa-playbooksskills/sa-playbooks
上云评估、迁移、成本优化等交付 SOP 与模板。
通用 SA 交付实践
技能内容面向开源社区：不含任何内部资料或客户敏感信息，每一条知识公开可溯源。想换成自己团队的方法论？改 Markdown 就行：知识、模型、端点全部可插拔。
五
边界与证据
这是开源项目，能力边界写在明面上：哪些工作单已经闭环，哪些还在路上。给评估者、未来的自己，和每一位考虑投入时间的 SA 一张诚实的表。
现在就能用MVP · 已实现
- OA-C01第一张工作单：架构设计需求澄清到交付打包五步闭环，工具自动修正重试
- OA-C02AgentScope 2.0 运行时ReActAgent + Toolkit + launch_console
- OA-C03三个技能包Markdown 承载，框架原生接入，可改写可扩充
- OA-C04模型可换DashScope 默认，任意 OpenAI 兼容端点
- OA-C05Docker 交互式运行docker compose run openarch
在路线图上NOT YET · 别当现状
- OA-R01售前其余工作环节客户洞察 / PoC 验证 / 投标支持 / 交付复盘
- OA-R02学习路径与技能树新手成长地图，按阶段定位能力缺口
- OA-R03产品级浏览器 Web UI基于 Agent Service + 官方 Web UI 扩展
- OA-R04客户管理与交付沉淀客户档案、交付记录、复盘积累
- OA-R05Runtime 服务化与多云知识包容器化多用户部署，AWS / Azure 选型知识
TESTING单元测试 CI 必跑Mermaid 校验器、drawio 转换、需求卡 schema、WAF 评分逻辑、技能包 lint，无需 API Key。
E2E端到端冒烟真实 Key 跑通五件套断言：需求卡 → 方案 → Mermaid → WAF 评分 → 交付文档。
SPEC设计规格先行MVP 设计文档与需求方逐节确认后实施，仓库内可查。