# 原子级动作模块库

> 创建时间：2026-03-07 09:00  
> 维护人：阿福  
> 版本：V1.0  
> 状态：🟡 动态维护中

---

## 📊 总览

**模块总数：** 18 个原子动作  
**已固化：** 9 个 ✅  
**待规范：** 9 个 🟡

**分类：**
- 📁 **01-data** - 数据层（4 个）
- 🎨 **02-visual** - 呈现层（5 个）
- 📤 **03-delivery** - 交付层（4 个）
- 🧠 **04-analysis** - 分析层（4 个）

---

## 📁 目录结构

`
atomic-actions/
├── README.md (本文件)
├── 01-data/ (数据层)
│   ├── ATOM-DATA-001-保存豆包会话.md ✅
│   ├── ATOM-DATA-002-更新 worklog.md ✅
│   ├── ATOM-DATA-003-读取项目卡片.md 🟡
│   └── ATOM-DATA-004-更新项目进度.md 🟡
├── 02-visual/ (呈现层)
│   ├── ATOM-VISUAL-005-生成 HTML 文件.md ✅
│   ├── ATOM-VISUAL-006-生成 Mermaid 图表.md 🟡
│   ├── ATOM-VISUAL-007-生成专家评分.md 🟡
│   ├── ATOM-VISUAL-008-生成 TTS 语音.md ✅
│   └── ATOM-VISUAL-009-Chrome 打开文件.md ✅
├── 03-delivery/ (交付层)
│   ├── ATOM-DELIVERY-010-飞书发送文字.md ✅
│   ├── ATOM-DELIVERY-011-飞书发送语音.md ✅
│   ├── ATOM-DELIVERY-012-飞书发送文件.md ✅
│   ├── ATOM-DELIVERY-013-本地播放语音.md ✅
│   └── ATOM-DELIVERY-014-飞书发送交互卡片.md ✅
└── 04-analysis/ (分析层)
    ├── ATOM-ANALYSIS-015-识别项目关键词.md 🟡
    ├── ATOM-ANALYSIS-016-提取工作内容.md 🟡
    ├── ATOM-ANALYSIS-017-专家视角分析.md 🟡
    └── ATOM-ANALYSIS-018-优先级排序.md 🟡
`

---

## 🎯 如何使用

### 1. 查找原子动作

按分类查找：
- 数据操作 → 1-data/
- 视觉呈现 → 2-visual/
- 消息发送 → 3-delivery/
- 分析处理 → 4-analysis/

### 2. 读取模块文件

每个模块文件包含：
- 📋 动作定义
- 🎯 输入输出
- ⚙️ 偏好设置
- 📝 操作步骤
- 🔄 使用场景
- 🔗 关联动作
- ✅ 检查清单

### 3. 执行动作

按模块文件中的 PowerShell 脚本执行

### 4. 记录使用

复杂任务完成后，标注用了哪些原子动作

---

## 📋 已固化模块（9 个）

### 数据层（2 个）
- ✅ ATOM-DATA-001 - 保存豆包会话
- ✅ ATOM-DATA-002 - 更新 worklog

### 呈现层（2 个）
- ✅ ATOM-VISUAL-005 - 生成 HTML 文件（科学杂志风格 V1.0）
- ✅ ATOM-VISUAL-008 - 生成 TTS 语音
- ✅ ATOM-VISUAL-009 - Chrome 打开文件

### 交付层（5 个）
- ✅ ATOM-DELIVERY-010 - 飞书发送文字
- ✅ ATOM-DELIVERY-011 - 飞书发送语音（filePath 参数）
- ✅ ATOM-DELIVERY-012 - 飞书发送文件
- ✅ ATOM-DELIVERY-013 - 本地播放语音
- ✅ ATOM-DELIVERY-014 - 飞书发送交互卡片

---

## 🟡 待规范模块（9 个）

### 数据层（2 个）
- 🟡 ATOM-DATA-003 - 读取项目卡片
- 🟡 ATOM-DATA-004 - 更新项目进度

### 呈现层（3 个）
- 🟡 ATOM-VISUAL-006 - 生成 Mermaid 图表
- 🟡 ATOM-VISUAL-007 - 生成专家评分

### 分析层（4 个）
- 🟡 ATOM-ANALYSIS-015 - 识别项目关键词
- 🟡 ATOM-ANALYSIS-016 - 提取工作内容
- 🟡 ATOM-ANALYSIS-017 - 专家视角分析
- 🟡 ATOM-ANALYSIS-018 - 优先级排序

---

## 🔄 动态维护

### 新增原子动作

1. 定义动作（输入/输出/偏好）
2. 编号（ATOM-分类 - 序号）
3. 创建模块文件
4. 测试执行
5. 更新本 README

### 纠正原子动作

1. 发现问题
2. 标注用户偏好
3. 更新模块文件
4. 更新版本号
5. 通知用户

### 固化原子动作

1. 测试通过
2. 更新状态（🟡→✅）
3. 记录固化时间
4. 更新主数据清单

---

## 📚 关联文档

- 主数据清单：../原子级动作主数据清单.md
- HTML 标准：../skills/html-expert-review/HTML-STANDARD.md
- Skill 目录：../skills/

---

_模块化库 | 可独立调用 | 动态维护 | 2026-03-07_
