当前位置：首页 > news >正文

【system-architect】：一个让 AI 做架构建议时“说得清依据“的 Skill

news 2026/6/30 5:36:06

开源地址：github.com/cptzzt/system-architect

这个 Skill 解决什么问题

用通用 AI（ChatGPT、Copilot 等）问架构问题，有三个具体的问题：

建议没有依据。AI 给出方案后，无法说明这个方案来自教材、来自工程实践、还是来自它自己的推断。用户无法判断可信度。
只讲收益不讲代价。架构设计本质是权衡，但 AI 倾向给出"看起来正确"的单一答案，回避代价分析。
备考与实战需求冲突。备考「系统架构设计师」需要按教材原文判卷、做考点对齐；真实项目需要工程经验和团队上下文。同一套行为无法同时满足。

system-architect 针对这三点设计了一套约束机制：强制溯源、强制权衡、按场景区分行为。本质上是一个 Claude Code skill，但知识层（core/knowledge/）是纯 Markdown，可以迁移到 Cursor / Windsurf / Cline / Copilot 等任意工具。

核心机制

1. 强制溯源——每条建议必须标注来源

AI 给建议时按来源分类标注：

来源类型	标注方式
内置知识层	“按知识体系，应…”
教材（接入教材时）	“教材第 X 章 / 第 N 页指出…”
工程经验	“⚠️ 工程经验，非权威依据，需结合项目判断”
不确定	直接说"不确定"

这条规则把"AI 编一个听起来对的答案"这条路堵死了。架构领域 AI 自身的知识可能过时或不准，强制标注来源等于把判断权交还给用户。

2. 内置知识层——10 章 35 个知识文件

core/knowledge/下覆盖系统架构设计师考试综合知识：

章	内容	状态
02	计算机系统（硬件/OS/网络/嵌入式/UML）	已校验
03	信息系统（TPS/MIS/DSS/ERP/电子政务）	已校验
04	信息安全（加密/签名/访问控制/抗攻击）	已校验
05	软件工程（过程模型/需求/测试/CBSE）	已校验
06	数据库（三级模式/范式/E-R/设计流程）	已校验
07	架构设计（架构风格/ABSD/DSSA）	未校验
08	质量评估（质量属性/ATAM/SAAM/CBAM）	未校验
09	软件可靠性（MTTF/MTBF/容错）	未校验
10	架构演化维护	未校验
11	未来信息（CPS/边缘计算/AI/数字孪生）	未校验

重要：知识层不含教材原文（版权属于出版社）。它是"读完权威教材后用自己的话重组的知识体系"，类似读完书写博客，可以独立工作。

每个知识文件是四层结构：

1. 核心知识体系 ← 知识本身 2. 顾问指引 ← 这块知识在真实项目里怎么用 3. 常见误区 ← AI 自检红线（防典型错误） 4. 自检清单 ← 给建议前过一遍

第三层"误区红线"是关键。光告诉 AI 正确答案不够，还要告诉它"最容易在哪犯错"。举一个真实的例子，数据库章节里写的：

❌ 两级映象方向搞反：外/概映象 =逻辑独立性，概/内映象 =物理独立性（不是反过来）
❌ 以为 SQL 操作内模式：应用操作的是外模式
❌ 故障恢复原理说成"备份"：教材原意是"建立冗余数据"

这三条是 AI 和初学者都容易踩的坑。在知识文件里固化成红线后，AI 给建议前会先自检，避开了这些典型错误。

3. 教材边界——有教材更强，无教材也能用

教材有版权，不能塞进开源项目。这个 skill 的处理方式：

默认（无教材）：靠知识层 + 工程经验工作。涉及工程经验会显式标注"非权威依据"。
接入教材（可选）：把教材电子版（推荐 Markdown；PDF 可用 MinerU 转成带页码的 md）放进textbook/目录，或改配置里的路径。这时 AI 能引用教材出处（标文件名 + 章节/页码），判卷以教材原文为唯一标准，做考点对齐。
降级机制：教材路径失效时，自动降级到"无教材"状态，并告知用户。不会假装有教材、不会编页码。

这套设计不绑死使用方式——纯白嫖知识层的、接教材做强溯源的，都能用。

4. 用户上下文——改几行配置，AI 适配个人

SKILL.md顶部有一段可编辑的"用户上下文"：

技术栈：[如 Java/Spring Boot, MySQL/MariaDB, Docker, React] 项目方向：[如 Web 后端 / 数据平台 / 移动端] 关注的质量属性：[如 性能 / 可用性 / 成本] 是否备考系统架构设计师：[是/否] 教材路径：[无 / textbook/ / 自定义路径]

AI 每次会话读这段配置来适配用户。备考用户和实战用户、不同技术栈、不同关注的质量属性——给的建议会不一样。这影响的是举例方式和行为路由（按"是否备考"判断主场景）。

三种模式，无需手动切换

模式不是状态机，是 AI 根据问题自然匹配的行为指引。

架构顾问模式（默认）

触发：真实项目问题（“我的项目表怎么设计”）。

流程：澄清场景（规模/约束/技术栈/质量目标）→ 关联知识层 → 给建议带依据 → 讲权衡 → 暴露不确定性。

自检红线防典型错误：不凭自身知识编造、不混淆"表结构设计（逻辑层）“和"建库运行（实施层）”、不把单表内"传递依赖"和跨表外键搞混。

学习导师模式（备考用户）

触发：用户上下文"备考=是"，或问考试/真题/论文。

学习流程：提取目录 → 出学前引导题 → 讲解（原理 + 类比 + 考点 + 挂钩用户技术栈）→ 用户提问 → 出学后验证题 → 收尾（一页纸总结 + 进度更新）。

判卷红线：判卷前必须回教材核实；不拿 AI 领域知识纠正教材已有的正确说法；记录用户原话，不编造用户回答。

配套复习体系：学习后建复习看板，追踪每章的重要度、学完日期、掌握度、薄弱点。明确"掌握度颜色是自测结果，不是学完自动变绿"。

技术选型模式

触发：“A vs B 怎么选”、“评审这个方案”。

产出结构化对比表（候选方案 × 决策维度），结合用户上下文，给倾向但说清"什么情况下推荐失效"。架构评审 checklist 覆盖：质量属性需求是否明确、架构风格是否匹配场景、关键权衡是否识别（CAP、一致性 vs 可用性）、是否有单点故障、是否过度设计（YAGNI）。

目录结构

system-architect/ ├── SKILL.md ← 主体（架构师内核 + 用户上下文 + 教材边界 + 行为路由） ├── README.md ├── LICENSE ← MIT ├── core/ │ ├── 教材边界.md ← 有/无教材各能做什么（AI 必读） │ └── knowledge/ ← 内置知识层（10 章，按需加载） │ ├── README.md ← 三层索引 + 主题导航 │ ├── 02-计算机系统/ … 06-数据库/ （已校验） │ └── 07-架构设计/ … 11-未来信息/ （未校验） ├── modes/ ← 可选模式（架构顾问/学习导师/技术选型） └── textbook/ ← 用户教材（自备，.gitignore，不入库）

SKILL.md只做精简路由（不超过 500 行），知识按主题按需加载（progressive disclosure）。AI 根据问题两次跳转定位相关知识，不全量读 35 个文件。

与现有方案的差异

方案	局限
软考 GitHub 题库项目	静态资料库，无 AI 互动、无溯源
Copilot / ChatGPT 通用 AI	基于自身知识，无 grounding、无溯源、可能过时
英文架构 Skill（Clean/DDD 类）	英文体系，非中文软考知识体系
system-architect	权威知识 grounding + 可溯源 + AI 互动 + 学习→顾问延续 + 无教材也能用

"学习→顾问延续"指：备考用户学完教材后，AI 自然从导师过渡到顾问——学到的架构知识正是 AI 给实战建议时的知识层，学和用是同一套体系。