# 原子级动作主数据清单

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

---

## 📊 总览

| 分类 | 原子动作数量 | 已固化 | 待规范 | 新建 |
|------|-------------|--------|--------|------|
| **数据层** | 4 | 4 | 0 | 0 |
| **呈现层** | 5 | 1 | 4 | 0 |
| **交付层** | **6** | **5** | 0 | **1** |
| **分析层** | 4 | 0 | 4 | 0 |
| **总计** | **19** | **10** | **8** | **1** |

---

## 📁 数据层原子动作

### 原子动作 001：保存豆包会话

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DATA-001 |
| **名称** | 保存豆包会话 |
| **输入** | 豆包聊天记录（文本） |
| **输出** | \doubao-sessions/YYYY-MM-DD-主题.md\ |
| **偏好设置** | UTF-8 编码、Markdown 格式、日期 + 序号命名 |
| **出现 Skills** | 豆包会话归档 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 生成文件名（日期 + 序号）
2. 保存原始内容
3. 飞书确认

---

### 原子动作 002：更新 worklog

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DATA-002 |
| **名称** | 更新 worklog |
| **输入** | 工作内容（[完成]/[进行中]/[待办]） |
| **输出** | \worklog.txt\ 更新 |
| **偏好设置** | 追加模式、日期分组、状态标记 |
| **出现 Skills** | 豆包会话归档 Skill、周报生成 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 查找今日记录
2. 追加工作内容
3. 保存文件

---

### 原子动作 003：读取项目卡片

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DATA-003 |
| **名称** | 读取项目卡片 |
| **输入** | 项目名称 |
| **输出** | 项目卡片内容（Markdown） |
| **偏好设置** | 路径：\knowledge-base/projects/项目名/项目卡片.md\ |
| **出现 Skills** | 项目进度同步 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 识别项目名称
2. 读取项目卡片文件
3. 返回内容

---

### 原子动作 004：更新项目进度

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DATA-004 |
| **名称** | 更新项目进度 |
| **输入** | 项目名 + 工作进展 |
| **输出** | 项目卡片更新 |
| **偏好设置** | 增量更新、日期标注、状态标识 |
| **出现 Skills** | 项目进度同步 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 读取项目卡片
2. 添加新进展（带日期）
3. 更新状态（🟢🟡🔴）
4. 保存文件

---

## 🎨 呈现层原子动作

### 原子动作 005：生成 HTML 文件

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-VISUAL-005 |
| **名称** | 生成 HTML 文件 |
| **输入** | 内容（Markdown）+ 图表（Mermaid） |
| **输出** | \expert-review-日期 - 主题.html\ |
| **偏好设置** | **科学杂志风格**（白底黑字 + 小红书红 #FE2C55、微软雅黑 14px、6 章节结构） |
| **出现 Skills** | HTML 专家点评 Skill |
| **状态** | ✅ 已固化（V1.0） |
| **标准文档** | \skills/html-expert-review/HTML-STANDARD.md\ |
| **最后更新** | 2026-03-07 08:55 |

**操作说明：**
1. 生成 HTML 结构（6 章节）
2. 插入 Mermaid 图表
3. 应用科学杂志风格 CSS
4. 保存文件（UTF-8）
5. Chrome 打开预览

**禁止事项：**
- ❌ 花哨背景
- ❌ 过多颜色（≤5 种）
- ❌ 手绘风格图表
- ❌ 无结构堆砌

---

### 原子动作 006：生成 Mermaid 图表

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-VISUAL-006 |
| **名称** | 生成 Mermaid 图表 |
| **输入** | 知识点关系（文本描述） |
| **输出** | Mermaid 代码 |
| **偏好设置** | 专业绘制（非手绘）、配色标准（核心节点小红书红） |
| **出现 Skills** | HTML 专家点评 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 分析知识关系
2. 选择图表类型（graph TD/flowchart LR）
3. 生成 Mermaid 代码
4. 应用配色标准

---

### 原子动作 007：生成专家评分

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-VISUAL-007 |
| **名称** | 生成专家评分 |
| **输入** | 内容（待评估） |
| **输出** | 评分表格（完整性/正确性/缺失项） |
| **偏好设置** | 3 维度评分（百分比 + 说明） |
| **出现 Skills** | HTML 专家点评 Skill、项目知识专家 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 评估完整性（%）
2. 评估正确性（%）
3. 识别缺失项（%）
4. 生成评分表格

---

### 原子动作 008：生成 TTS 语音

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-VISUAL-008 |
| **名称** | 生成 TTS 语音 |
| **输入** | 文字稿（≤1500 字符） |
| **输出** | `workspace/tts/voice-时间戳.mp3` |
| **偏好设置** | 阿福声音、自动播放、**workspace/tts 统一归档** |
| **出现 Skills** | 飞书消息自动化 Skill、优先级提醒 |
| **状态** | ✅ 已固化（**V2.0**） |
| **最后更新** | **2026-03-07 15:18** |

**操作说明：**
1. 确保 tts 文件夹存在
2. 生成文件名（voice-时间戳.mp3）
3. 调用 TTS 工具
4. 保存到 `workspace/tts/` 文件夹
5. 返回文件路径

**🆕 V2.0 升级（2026-03-07 15:18）：**
- ✅ 存储位置：Temp/tts-*/voice-*.mp3 → workspace/tts/voice-时间戳.mp3
- ✅ 统一归档：所有 TTS 文件集中管理
- ✅ 已移动 27 个历史文件到新位置

---

### 原子动作 009：Chrome 打开文件

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-VISUAL-009 |
| **名称** | Chrome 打开文件 |
| **输入** | 文件路径（HTML/PDF 等） |
| **输出** | Chrome 浏览器窗口 |
| **偏好设置** | 独立窗口、前台显示 |
| **出现 Skills** | HTML 专家点评 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 确认文件存在
2. Start-Process chrome.exe
3. 传入文件路径

---

## 📤 交付层原子动作

### 原子动作 010：飞书发送文字

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DELIVERY-010 |
| **名称** | 飞书发送文字 |
| **输入** | Markdown 内容 |
| **输出** | 飞书消息（messageId） |
| **偏好设置** | Markdown 格式、emoji 点缀、结构化排版 |
| **出现 Skills** | 所有 Skills |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 格式化内容（Markdown）
2. 调用 message 工具
3. 返回 messageId

---

### 原子动作 011：飞书发送语音

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DELIVERY-011 |
| **名称** | 飞书发送语音 |
| **输入** | MP3 文件路径 + 文字稿 |
| **输出** | 飞书消息（含语音附件） |
| **偏好设置** | **filePath 参数**（不用 buffer）、文字稿≤1500 字符 |
| **出现 Skills** | 飞书消息自动化 Skill、优先级提醒 |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-07 |

**操作说明：**
1. 确认 MP3 文件存在
2. 调用 message 工具（filePath 参数）
3. 附带文字稿
4. 返回 messageId

**关键：** 必须用 \ilePath\ 参数，不用 \uffer\！

---

### 原子动作 012：飞书发送文件

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DELIVERY-012 |
| **名称** | 飞书发送文件 |
| **输入** | 文件路径 + 说明文字 |
| **输出** | 飞书消息（含文件附件） |
| **偏好设置** | 文件大小<20MB、说明文字简洁 |
| **出现 Skills** | 飞书消息自动化 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 确认文件存在
2. 编写说明文字
3. 调用 message 工具
4. 返回 messageId

---

### 原子动作 013：本地播放语音

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DELIVERY-013 |
| **名称** | 本地播放语音 |
| **输入** | MP3 文件路径（自动查找最新） |
| **输出** | 系统播放（无返回值） |
| **偏好设置** | Start-Process、**workspace/tts/voice-*.mp3**、**锁屏时不播放** |
| **出现 Skills** | 飞书消息自动化 Skill、优先级提醒 |
| **状态** | ✅ 已固化（**V2.0**） |
| **最后更新** | **2026-03-07 15:18** |

**操作说明：**
1. 在 `workspace/tts/` 文件夹查找最新 MP3
2. 检测锁屏状态（LockApp 进程）
3. 锁屏时：跳过播放（记录日志）
4. 活跃时：Start-Process 播放
5. 确认播放成功

**🆕 V2.0 升级（2026-03-07 15:18）：**
- ✅ 查找路径：Temp/tts-*/voice-*.mp3 → workspace/tts/voice-*.mp3
- ✅ 智能播放：锁屏时不播放，活跃时自动播放
- ✅ 已移动 27 个历史文件到新位置

---

### 原子动作 014：飞书发送交互卡片

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-DELIVERY-014 |
| **名称** | 飞书发送交互卡片 |
| **输入** | 卡片 JSON + 按钮配置 |
| **输出** | 飞书消息（interactive 类型） |
| **偏好设置** | msg_type: interactive、wide_screen_mode: true |
| **出现 Skills** | 飞书消息自动化 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 设计卡片 JSON
2. 配置按钮（tag/button/type）
3. 调用 message 工具
4. 返回 messageId

---

### 原子动作 028：写入飞书文档

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-FEISHU-028 |
| **名称** | 写入飞书文档 |
| **输入** | Markdown 内容 + 文档 Token |
| **输出** | 飞书文档（已写入） |
| **偏好设置** | **分块写入（≤200 blocks/块）**、第 1 块 write 后续 append、避免 400 错误 |
| **出现 Skills** | 统一专业词汇 Skill、原子动作文档同步 Skill、项目知识专家 Skill |
| **状态** | ✅ 已固化 |
| **最后更新** | **2026-03-07 14:48** |

**操作说明：**
1. 创建空白文档（`create -title`）
2. 分块（≤200 blocks/块，每块 30-50 blocks）
3. 第 1 块：`write` 模式（覆盖）
4. 第 2 块及以后：`append` 模式（追加）
5. 确认写入成功

**⚠️ 关键教训（2026-03-07 14:48）：**
- ❌ **禁止**：`create -content "长内容"`（会空白文档）
- ✅ **正确**：`create` → `write` → `append`（分块写入）
- **原因**：create 动作不支持直接写入长内容

**错误示例：**
```powershell
❌ feishu_doc -action create -content "101 blocks 内容"
   结果：返回 document_id，但文档空白
```

**正确示例：**
```powershell
✅ 第 1 步：feishu_doc -action create -title "文档标题"
   获取 doc_token

✅ 第 2 步：feishu_doc -action write -doc_token $token -content "第 1 块（34 blocks）"

✅ 第 3 步：feishu_doc -action append -doc_token $token -content "第 2 块（67 blocks）"
```

---

### 原子动作 030：飞书文档加序号（领导汇报版）

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-FEISHU-030 |
| **名称** | 飞书文档加序号（领导汇报版） |
| **输入** | 飞书文档 Token |
| **输出** | 飞书文档（已加序号） |
| **偏好设置** | **仅领导汇报时使用**、移除所有 emoji、添加标准序号（1. / 1.1 / 1.1.1） |
| **出现 Skills** | 项目知识专家 Skill |
| **状态** | 🆕 新建 |
| **最后更新** | **2026-03-07 14:51** |

**触发词：**
- "标题加序号"
- "给领导汇报"
- "加工文档"
- "整理成正式格式"

**操作说明：**
1. 读取飞书文档内容
2. 移除所有 emoji icons（⭐💡🔍📊📋🎯等）
3. 添加标题序号：
   - H1：`1. 标题` / `2. 标题`
   - H2：`1.1 标题` / `1.2 标题`
   - H3：`1.1.1 标题` / `1.1.2 标题`
4. 分块写入飞书文档（≤200 blocks/块）

**⚠️ 重要原则：**
- ✅ **仅当**用户明确说"给领导汇报"时使用
- ❌ **日常文档**不需要加序号

**处理前示例：**
```
# ⭐ 专家评分
## 💡 核心观点
### 🔍 深度洞察
```

**处理后示例：**
```
1. 专家评分
1.1 核心观点
1.1.1 深度洞察
```

---

## 🧠 分析层原子动作

### 原子动作 015：识别项目关键词

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-ANALYSIS-015 |
| **名称** | 识别项目关键词 |
| **输入** | 文本内容 |
| **输出** | 项目名称列表 |
| **偏好设置** | 关键词匹配（感知/行动中心/产能/豆包等） |
| **出现 Skills** | 项目进度同步 Skill、豆包会话归档 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 提取关键词
2. 匹配项目库
3. 返回项目名称

---

### 原子动作 016：提取工作内容

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-ANALYSIS-016 |
| **名称** | 提取工作内容 |
| **输入** | 文本内容 |
| **输出** | [完成]/[进行中]/[待办] 列表 |
| **偏好设置** | 识别状态标记、提取核心内容 |
| **出现 Skills** | 豆包会话归档 Skill、周报生成 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 识别状态标记
2. 提取工作内容
3. 分类整理

---

### 原子动作 017：专家视角分析

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-ANALYSIS-017 |
| **名称** | 专家视角分析 |
| **输入** | 内容（待分析） |
| **输出** | Critical Thinking 点评 |
| **偏好设置** | 质疑假设、验证逻辑、指出缺失、提出改进 |
| **出现 Skills** | HTML 专家点评 Skill、项目知识专家 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 分析内容逻辑
2. 质疑假设
3. 指出缺失
4. 提出改进建议

---

### 原子动作 018：优先级排序

| 字段 | 内容 |
|------|------|
| **编号** | ATOM-ANALYSIS-018 |
| **名称** | 优先级排序 |
| **输入** | 任务列表 |
| **输出** | 四象限排序结果 |
| **偏好设置** | 紧急重要→重要不紧急→紧急不重要→不紧急不重要 |
| **出现 Skills** | 优先级提醒、任务管理 Skill |
| **状态** | 🟡 待规范 |
| **最后更新** | 2026-03-06 |

**操作说明：**
1. 评估紧急程度
2. 评估重要程度
3. 四象限分类
4. 排序输出

---

## 🔄 版本历史

| 版本 | 日期 | 变更内容 |
|------|------|----------|
| V1.3 | **2026-03-07 15:42** | **新增 SKILL-TTS-001**（TTS 自动化 Skill）+ 原子动作说明 TXT 文件（04-skills 分类） |
| V1.2 | 2026-03-07 15:18 | **TTS 存储位置升级**：Temp/tts-*/voice-*.mp3 → workspace/tts/voice-时间戳.mp3，已移动 27 个历史文件 |
| V1.1 | 2026-03-07 14:54 | 新增 ATOM-FEISHU-028（写入飞书文档）+ ATOM-FEISHU-030（加序号），交付层 6 个动作 |
| V1.0 | 2026-03-07 08:59 | 初始版本，18 个原子动作（9 已固化/8 待规范） |

---

## 📋 使用指南

### 如何复用原子动作

1. **查找**：在清单中查找所需动作
2. **确认**：查看偏好设置和状态
3. **执行**：按操作说明执行
4. **记录**：在任务回复中标注用了哪些原子动作

### 如何新增原子动作

1. **定义**：明确输入/输出/偏好
2. **编号**：按分类编号（ATOM-分类 - 序号）
3. **记录**：添加到本清单
4. **测试**：执行一次验证效果
5. **固化**：确认无误后标记为✅已固化

### 如何纠正原子动作

1. **发现问题**：执行结果不符合预期
2. **标注偏好**：明确用户偏好
3. **更新清单**：修改偏好设置
4. **通知用户**：确认已更新
5. **应用新标准**：后续执行按新标准

---

## 🎯 Skills（技能组合）

### SKILL-TTS-001：TTS 自动化

| 字段 | 内容 |
|------|------|
| **编号** | SKILL-TTS-001 |
| **名称** | TTS 自动化（文本转语音 + 自动播放） |
| **触发词** | "生成语音" / "转语音" / "朗读这段" |
| **输入** | 文本（≤1500 字符） |
| **输出** | MP3 文件 + 自动播放 |
| **工作流程** | 文本 → 阿里云 TTS → workspace/tts/ → 自动播放 |
| **复用原子动作** | ATOM-VISUAL-008 + ATOM-DELIVERY-013 |
| **状态** | 🆕 新建 |
| **最后更新** | 2026-03-07 15:42 |

**核心功能：**
1. 调用阿里云 TTS API（cosyvoice-v1）
2. 生成 MP3 文件（voice-时间戳.mp3）
3. 保存到 workspace/tts/（统一归档）
4. 检测锁屏状态
5. 屏幕活跃时自动播放
6. 锁屏时跳过（记录日志）

**文件位置：**
- Skill：`skills/tts-automation/SKILL.md`
- TXT：`原子动作说明/04-skills/001-TTS 自动化.txt`

---

## 🎯 命名规范

**原则：** 统一命名，不要改来改去

**格式：** `动作 + 对象`
- ✅ 生成 HTML 文件
- ✅ 保存豆包会话
- ✅ 更新 worklog
- ❌ 创建 HTML/输出 HTML/HTML 生成（不统一）

**分类前缀：**
- ATOM-DATA-*：数据层
- ATOM-VISUAL-*：呈现层
- ATOM-DELIVERY-*：交付层
- ATOM-ANALYSIS-*：分析层

---

_动态维护 | 阿福生成 | 2026-03-07_
