# 🏗️ 原子动作 - Skills - 工作流 架构图

三层架构 | 复用关系 | 调用链路

原子动作（Atomic Actions）
Skills（技能）
工作流（Workflows）- 待扩展
共享原子动作
graph TB subgraph Layer3["上层：工作流层 - 待扩展"] WF1["豆包会话处理"] WF2["优先级提醒"] WF3["周报生成"] end subgraph Layer2["中层：Skills 层"] S1["SKILL-GLOSSARY-001
统一专业词汇"] S2["SKILL-DOC-SYNC-001
文档同步"] S3["SKILL-PROJECT-EXPERT
项目专家"] S4["SKILL-HTML-REVIEW
HTML 点评"] end subgraph Layer1["下层：原子动作层 - 共享"] A29["ATOM-DOC-029
更新飞书文档"] A28["ATOM-FEISHU-028
写入飞书"] A10["ATOM-DELIVERY-010
飞书文字"] A11["ATOM-DELIVERY-011
飞书语音"] A13["ATOM-DELIVERY-013
本地播放"] A5["ATOM-VISUAL-005
生成 HTML"] A8["ATOM-VISUAL-008
生成 TTS"] A1["ATOM-DATA-001
保存豆包"] A2["ATOM-DATA-002
更新 worklog"] end S1 --> A29 S1 --> A28 S2 --> A29 S2 --> A28 S3 --> A28 S3 --> A5 S4 --> A5 S4 --> A8 WF1 -.-> S4 WF1 -.-> S1 WF2 -.-> S4 WF2 -.-> A11 WF2 -.-> A13 WF3 -.-> S2 style A29 fill:#ef4444,stroke:#333,stroke-width:2px,color:#fff style A28 fill:#ef4444,stroke:#333,stroke-width:2px,color:#fff style Layer3 fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,stroke-dasharray:5 5 style Layer2 fill:#e0e7ff,stroke:#667eea,stroke-width:2px style Layer1 fill:#d1fae5,stroke:#10b981,stroke-width:2px style S1 fill:#667eea,stroke:#333,stroke-width:2px,color:#fff style S2 fill:#667eea,stroke:#333,stroke-width:2px,color:#fff style S3 fill:#667eea,stroke:#333,stroke-width:2px,color:#fff style S4 fill:#667eea,stroke:#333,stroke-width:2px,color:#fff

### 📊 复用关系详解

🔴 共享原子动作（被多个 Skills 复用）

ATOM-DOC-029（更新飞书原子动作清单）

- 被 SKILL-GLOSSARY-001（统一专业词汇）调用 ✅
- 被 SKILL-DOC-SYNC-001（原子动作文档同步）调用 ✅
- 复用场景：任何需要更新飞书文档的场景

ATOM-FEISHU-028（写入飞书文档）

- 被 SKILL-GLOSSARY-001（统一专业词汇）调用 ✅
- 被 SKILL-DOC-SYNC-001（原子动作文档同步）调用 ✅
- 被 SKILL-PROJECT-EXPERT-001（项目知识专家）调用 ✅
- 复用场景：分块写入飞书文档

💡 典型调用链路

场景：更新专业词汇库

1. 生成 HTML 专家点评 → 遇到新词汇"PE"
2. 调用 SKILL-GLOSSARY-001（统一专业词汇）
3. SKILL-GLOSSARY-001 调用 ATOM-DOC-029（更新飞书文档）
4. ATOM-DOC-029 调用 ATOM-FEISHU-028（分块写入）
5. ✅ 三线同步完成（飞书 + MD + TXT）

### 🏗️ 三层架构说明

层级 | 职责 | 示例 | 状态
--- | --- | --- | ---
🔝 上层：工作流 | 复杂业务流程编排 | 豆包会话处理、周报生成 | 🟡 待扩展（虚线框）
🎯 中层：Skills | 特定领域能力封装 | 统一专业词汇、文档同步 | ✅ 已创建 4 个
⚛️ 下层：原子动作 | 单一职责原子操作 | 写入飞书、生成 HTML、播放语音 | ✅ 已创建 30 个

### 💡 核心原则

原子动作是共享基础设施，Skills 是领域能力封装，工作流是业务流程编排。

下层为上层提供服务，上层组合下层能力。原子动作越稳定，上层越灵活。