# 三线更新 Skill - 文档同步更新

> 版本：V1.7  
> 状态：✅ 已固化  
> 最后更新：**2026-03-09 14:27**（新增技能使用备注/主动 TODO 追踪）  
> 触发词：**"三线更新" / "同步更新"** + **自动触发**

---

## 📋 Skill 定义

**名称：** 三线更新 Skill  
**编号：** SKILL-SYNC-001  
**触发：** 
- 手动触发：用户说"三线更新" / "同步更新"
- **自动触发（2026-03-07 16:12）：** 聊天内容涉及以下任一主题时自动触发

**自动触发条件 🆕：**
当聊天内容涉及以下任一主题时，**必须自动触发三线更新**：
- ✅ **工作流**（Workflow）- 新增或修改工作流
- ✅ **Skill** - 新增或修改 Skill
- ✅ **原子级动作**（Atomic Action）- 新增或修改原子动作
- ✅ **Project 项目** - 新增或修改项目卡片/项目知识
- ✅ **专业术语** - 新增或修改术语定义/命名规范
- ✅ **HTML 专家点评** - 生成新的 HTML 专家点评
- ✅ **Worklog** - 新增或修改 worklog 记录规则
- ✅ **微信转账/支付/红包** - 新增支付相关功能（2026-03-08 12:48 新增）

**一句话描述：** 同步更新 MD 模块 + TXT 说明 + 飞书文档（原子动作主数据清单）

---

## 🎯 目标

**解决什么问题：**
- ✅ 避免忘记更新某一线
- ✅ 保证文档一致性
- ✅ 标准化更新流程

**核心价值：**
- 一次修改，三线同步
- 避免遗漏
- 文档始终一致

---

## 🔄 三线定义

### 第 1 线：MD 模块文件

**位置：** `atomic-actions/{分类}/ATOM-XXX-名称.md`

**内容：**
- 原子动作完整定义
- 输入输出
- 偏好设置
- 操作步骤
- 使用场景
- 关联动作
- 检查清单
- 常见错误

**特点：**
- ✅ 详细完整
- ✅ Markdown 格式
- ✅ 机器可读

---

### 第 2 线：TXT 说明文件

**位置：** `原子动作说明/{分类}/XXX-名称.txt`

**内容：**
- 大白话说明
- 这个动作是干啥的
- 什么时候用
- 操作步骤（简化版）
- 举个例子
- 常见错误
- 核心原则

**特点：**
- ✅ 通俗易懂
- ✅ 纯文本格式
- ✅ 人类可读

---

### 第 3 线：飞书文档（主数据清单）

**位置：** `原子级动作主数据清单.md`
**完整链接：** https://scns3ak4jrto.feishu.cn/docx/GeG0dywMxof8dLx1tcUckSFNndh

**内容：**
- 原子动作清单表格
- 版本历史
- Skills 组合列表

**特点：**
- ✅ 总览视图
- ✅ 快速查阅
- ✅ 版本追踪
- ✅ **提及文档时必须附上完整链接**（2026-03-09 14:32 新增）

---

## 📝 更新流程

### 步骤 1：更新 MD 模块

```powershell
# 修改原子动作 MD 文件
$mdPath = "atomic-actions/02-visual/ATOM-VISUAL-008-生成 TTS 语音.md"

# 更新内容：
# - 版本号（V1.0 → V2.0）
# - 输出路径
# - 操作步骤
# - 偏好设置
```

### 步骤 2：更新 TXT 说明

```powershell
# 修改或创建 TXT 文件
$txtPath = "原子动作说明/02-呈现层/008-生成 TTS 语音.txt"

# 更新内容：
# - 大白话说明
# - 核心变化
# - 操作步骤（简化）
# - 示例
```

### 步骤 3：更新飞书文档（调用 ATOM-FEISHU-028）

```powershell
# 飞书文档 Token
$docToken = "GeG0dywMxof8dLx1tcUckSFNndh"

# 分章节写入（每章≤200 blocks）
# 第 1 块：版本记录表
$versionBlock = @"
## 📝 版本记录
| V1.5 | 2026-03-08 12:12 | HTML 链接显示完整标题（非文件名） | 阿福 |
| V1.4 | 2026-03-08 12:10 | 新增项目卡片和 HTML 专家点评同步 | 阿福 |
"@
Invoke-FeishuDoc -action insert -doc_token $docToken -content $versionBlock

# 第 2 块：Skills 章节
$skillsBlock = @"
## 🎯 Skills（技能组合）
### SKILL-SYNC-001：三线更新
[表格内容...]
"@
Invoke-FeishuDoc -action append -doc_token $docToken -content $skillsBlock
```

**关键点：**
- ✅ 调用 ATOM-FEISHU-028（写入飞书文档）
- ✅ 分章节写入（≤200 blocks/次）
- ✅ 避免 400 错误
- ✅ 文档 Token：GeG0dywMxof8dLx1tcUckSFNndh

### 步骤 4：记录触发日志

```powershell
# 日志文件路径
$logPath = "memory/triple-line-sync-log.md"

# 获取当前时间
$currentTime = Get-Date -Format "yyyy-MM-dd HH:mm"

# 生成日志行
$logEntry = "| $currentTime | $triggerReason | $updateContent | $oldVersion → $newVersion | ✅ 完成 |"

# 读取日志文件
$logContent = Get-Content $logPath -Raw

# 找到"## 📝 更新历史记录"下的第一个日期分组
$dateGroup = "### $(Get-Date -Format 'yyyy-MM-dd（ddd）')"

# 在日期分组下插入日志行
if ($logContent -match $dateGroup) {
    # 日期分组已存在，插入到该分组下
    $logContent = $logContent -replace "($dateGroup\s*\n)", "`$1$logEntry`n"
} else {
    # 日期分组不存在，创建新分组
    $newGroup = "`n$dateGroup`n`n$logEntry`n"
    $logContent = $logContent -replace "(## 📝 更新历史记录\s*\n)", "`$1$newGroup"
}

# 保存日志文件
$logContent | Set-Content $logPath -Encoding UTF8

# 更新统计概览
Update-LogStatistics -logPath $logPath
```

**关键点：**
- ✅ 日志文件：`memory/triple-line-sync-log.md`
- ✅ 自动追加到当日分组下
- ✅ 自动更新统计概览
- ✅ 必填字段：时间、触发原因、更新内容、版本号、状态

**⚠️ 严重警告（2026-03-07 16:08）：**
> **绝对不要用 `write` 覆盖文档头部！**
> `write` 模式会覆盖整个文档，导致所有内容丢失！

**正确做法：**
- ✅ 版本记录更新：用 `insert` 在表头后插入新行
- ✅ 文档内容追加：用 `append` 追加新章节
- ✅ 单个 block 更新：用 `update_block` 更新指定 block
- ❌ **禁止用 `write` 更新单个字段**（会覆盖全文档！）

---

## ✅ 检查清单

### MD 模块检查
- [ ] 版本号已更新
- [ ] 最后更新时间已修改
- [ ] 输出路径已更新
- [ ] 操作步骤已更新
- [ ] 偏好设置已更新
- [ ] 状态标识正确（🟡待规范/✅已固化）

### TXT 说明检查
- [ ] 文件已创建/更新
- [ ] 大白话说明清晰
- [ ] 示例准确
- [ ] 核心变化突出
- [ ] 关联动作列出

### 飞书文档检查
- [ ] 原子动作表格已更新
- [ ] 版本历史新增一行
- [ ] Skills 章节已添加（如适用）
- [ ] 版本号递增
- [ ] **⚠️ 确认没有误用 `write` 模式**（会覆盖全文档！）
- [ ] 版本记录用 `insert` 插入
- [ ] 内容追加用 `append`
- [ ] 单个 block 更新用 `update_block`

### 自动触发检查
- [ ] **检测聊天内容是否涉及：** 工作流/Skill/原子动作/项目/术语/HTML/Worklog
- [ ] **判断是否有增量内容：** 新增/修改/删除
- [ ] **有增量 → 立即执行三线更新**
- [ ] **无增量 → 记录日志，跳过**

### 触发日志检查
- [ ] **日志文件存在：** `memory/triple-line-sync-log.md`
- [ ] **记录时间：** 精确到分钟（如：2026-03-08 12:10）
- [ ] **触发原因：** 错误修复/用户约定/专家建议/新功能
- [ ] **更新内容：** 简要描述（如：新增项目卡片和 HTML 专家点评同步）
- [ ] **版本号：** 旧版本 → 新版本（如：V1.3 → V1.4）
- [ ] **状态：** ✅ 完成
- [ ] **统计概览：** 自动更新（总次数/本月/本周/今日）

---

## 🎯 示例：TTS 存储位置升级

### 变更内容
- 旧路径：Temp/tts-*/voice-*.mp3
- 新路径：workspace/tts/voice-时间戳.mp3

### 第 1 线：MD 模块
```markdown
# ATOM-VISUAL-008 - 生成 TTS 语音

> 版本：V2.0  
> 状态：✅ 已固化  
> 最后更新：2026-03-07 15:18

### 输出
- **路径：** `workspace/tts/voice-时间戳.mp3`
```

### 第 2 线：TXT 说明
```
===========================================
ATOM-VISUAL-008 - 生成 TTS 语音（V2.0）
===========================================

【核心变化 V2.0】
- ✅ 存储位置：Temp/tts-*/voice-*.mp3 → workspace/tts/voice-时间戳.mp3
- ✅ 统一归档：所有 TTS 文件集中管理
```

### 第 3 线：飞书文档
```markdown
### 原子动作 008：生成 TTS 语音

| 字段 | 内容 |
|------|------|
| **输出** | `workspace/tts/voice-时间戳.mp3` |
| **状态** | ✅ 已固化（V2.0） |
| **最后更新** | 2026-03-07 15:18 |

## 🔄 版本历史
| V1.2 | 2026-03-07 15:18 | TTS 存储位置升级 |
```

---

## 💡 核心原则

> **一次修改，三线同步！**

**关键点：**
1. ✅ MD 模块（详细定义）
2. ✅ TXT 说明（大白话）
3. ✅ 飞书文档（总览清单）

**触发词：**
- "三线更新"
- "同步更新"
- "更新文档"

**🆕 自动触发规则（2026-03-08 12:48 更新）：**
> **聊天内容涉及工作流/Skill/原子动作/项目/术语/HTML/Worklog/微信转账 → 自动触发三线更新！**

**检测关键词：**
- 工作流 / Workflow
- Skill / 技能
- 原子动作 / 原子级动作 / Atomic Action
- Project / 项目 / 项目卡片
- 术语 / 专业术语 / 命名规范
- HTML / 专家点评
- Worklog / 工作日志
- **微信 / 转账 / 红包 / 支付 / 发钱**（2026-03-08 12:48 新增）

**执行流程：**
```
1. 检测到关键词
2. 判断是否有增量内容
3. 有增量 → 立即执行三线更新
4. 无增量 → 记录日志，跳过
```

---

## ⚠️ 常见错误

### 错误 1：只更新 MD，忘记 TXT

```
❌ 错误：MD 改了，TXT 还是旧内容
✅ 正确：MD + TXT + 飞书文档 同步更新
```

### 错误 2：版本号不一致

```
❌ 错误：MD 是 V2.0，TXT 是 V1.0
✅ 正确：三线版本号一致
```

### 错误 3：忘记更新版本历史

```
❌ 错误：改了内容，没加版本历史记录
✅ 正确：版本历史新增一行（版本 + 日期 + 变更内容）
```

### 错误 4：误用 `write` 模式覆盖文档

```
❌ 错误：用 write 更新版本号 → 覆盖整个文档，500 blocks → 只剩 1 block
✅ 正确：
  - 版本记录更新：用 insert 在表头后插入新行
  - 文档内容追加：用 append 追加新章节
  - 单个 block 更新：用 update_block 更新指定 block
  - 禁止用 write 更新单个字段！
```

### 错误 5：忘记自动触发三线更新

```
❌ 错误：聊天涉及 Skill/原子动作/项目/术语，但没有触发三线更新
✅ 正确：
  - 检测到关键词 → 立即判断是否有增量内容
  - 有增量 → 自动执行三线更新
  - 无增量 → 记录日志，跳过
```

---

## 🔗 关联动作

### 核心原子动作
- **ATOM-FEISHU-028**：写入飞书文档（第三线核心）
  - 分章节写入（≤200 blocks/次）
  - 避免 400 错误
  - 文档 Token：GeG0dywMxof8dLx1tcUckSFNndh

### 常组合使用
- MD 更新 + TXT 更新 + **ATOM-FEISHU-028**
  （三线同步更新）

---

## 📚 参考文档

- MD 模块：`atomic-actions/` 目录
- TXT 说明：`原子动作说明/` 目录
- 飞书文档：https://scns3ak4jrto.feishu.cn/docx/GeG0dywMxof8dLx1tcUckSFNndh
- 原子动作：`ATOM-FEISHU-028 - 写入飞书文档`

---

_三线同步 | 文档一致 | 2026-03-08_
