| name | ai-expert-analyst |
| version | 1.7.0 |
| description | 先让人看懂，再让人惊艳。清晰为本，金句添彩，对比穿插，丰满有力。咨询框架做后台分析，不用进文章结构。写完自动保存到成果归档，在聊天窗口呈现，不再遗忘。 |
| metadata | {"openclaw":{"emoji":"✍️","category":"writing","tags":["AI写作","内容创作","公众号"]}} |
⚠️ 根本原则（违反则重写）
- 清晰度第一：读者看完第一段，必须知道文章在讲什么
- 背景先于悬念：先交代事件背景，再抛悬念，不能倒置
- 丰满为王：有场景、有数据、有对比、有判断，少任何一样文章就薄了
- 咨询框架做后台：框架只用于写前分析，不进文章结构，不进段落标签
版本历史
v1.5.0（2026-04-05 11:28）✅ 当前版本
变更原因：用户确认"清晰优先"路线有效，skill需要固化这次经验
核心发现：
- 纯悬念开头=读者不知道在讲什么
- 自己的自然风格比套框架写法更流畅
- "先用简单的话让人看懂"比"用漂亮的话让人惊艳"更重要
- GEN-1这篇文章验证了：清晰+丰满+对比=有效写法
v1.4.0（2026-04-05 11:15）
v1.3.0（2026-04-05 11:06）
v1.2.0（2026-04-05 10:55）
一，开头规范（最优先）
背景优先原则
第一段必须包含三个要素：谁、做了什么、为什么重要。
❌ 错误（纯悬念，读者不知道在讲什么）：
"波士顿动力三十二年，Figure AI十年，它凭什么？"
→ 读者不知道"它"是谁，不知道这篇文章要讲什么
✅ 正确（背景+悬念）：
"波士顿动力做了三十二年人形机器人，Figure AI做了十年。一家叫Generalist的硅谷AI公司，成立两年，就把机器人任务成功率从64%做到了99%。这到底是怎么做到的？"
→ 读者立刻知道：这篇文章讲Generalist GEN-1
✅ 正确（旧版特斯拉Optimus开头）：
"2021年8月20日，特斯拉AI日。马斯克宣布了一个震惊全球的计划……然后一个人穿着机器人服装上台跳了一段舞。五年过去了，Optimus，一台都没对外卖出去过。"
→ 读者立刻知道：这篇文章讲特斯拉Optimus+有背景+有悬念
开头检查（每篇必须做）
写完第一段，问自己：
- 读者知道这篇文章在讲什么公司/什么人/什么事吗？
- 读者知道这件事为什么重要吗？
- 不知道 → 重写
二，文章结构（自然段落，不用标记）
三段式（不用P·D·C·A标记）
第一段：背景铺垫
中间段：论点展开
- 每个论点 = 问题 + 数据 + 对比 + 解释
- 每段有核心信息，一句话能说清
- 对比穿插：时间/对手/数字/逻辑对比
结尾段：判断+留白
三，段落丰满规范（最关键）
每段四层结构
背景 → 数据 → 对比 → 解释
❌ 单薄（只有数据和解释）：
"GEN-1成功率达99%，比上一代提升35个百分点，在工业场景中具有重要意义。"
✅ 丰满（四层全有）：
"GEN-1成功率达99%。但上一代只有64%——每做3次就可能失败1次。在工厂里，这意味着产品报废、产线停工。99%意味着连续折200个纸箱，没有一次失误。"
❌ 单薄（只有数据）：
"折一个纸箱，GEN-1只需12.1秒，上一代需要34秒。"
✅ 丰满（数据+意义+对比）：
"折一个纸箱，上一代最优模型需要34秒，GEN-1只需要12.1秒。快了将近两倍。这意味着机器人第一次在效率上接近了人类工人的水平。在工厂里，如果机器人一直比人慢，它永远只是辅助工具。但一旦比人快了，人就变成了辅助。效率临界点一旦跨过去，整个生产关系就变了。"
四，对比穿插（必须用，每段至少1个）
四种对比方式：
- 时间对比：2021年→2026年，五年做了什么
- 对手对比：A公司 vs B公司
- 数字对比：64%→99%，34秒→12.1秒
- 逻辑对比：不可用 vs 可用，辅助工具 vs 主角
五，金句规范
每1-2段至少1句金句。
金句来源：
- 反常识事实
- 震撼数字
- CEO原话
- 一句话判断
- 类比句
✅ 金句示例：
- "这就是数据规模带来的路径碾压。"
- "效率临界点一旦跨过去，整个生产关系就变了。"
- "一家做模型的，无意间点燃了一个新赛道。"
- "它不只是做自己的产品，它定义了下一个战场在哪里。"
六，具体场景规范
每篇至少3-5个具体数字场景。
✅ 示例：
- "连续折叠纸箱200次，最后一个和第一个一样稳"
- "折叠T恤86件，一次没失误"
- "积木装箱1800次以上"
- "覆盖全球数千个家庭、仓库、工厂、面包房"
- "Figure AI花了五年才积累了几万小时数据，波士顿动力三十年积累了几十万小时"
七，咨询框架用法（只用后台，写前用，写时隐去）
写前分析（5分钟）
每篇写前做三件事：
- SMART校验：每条判断有没有数据支撑？有没有时间节点？
- 对比清单：这场事件有哪些对比可以用？（对手/时间/数字/逻辑）
- 场景清单：有哪些具体数字/画面可以放进文章？
PEST快速扫描（至少覆盖3个维度）：
- E（经济）：市场规模、成本结构、盈利模式
- S（社会）：用户接受度、替代争议
- T（技术）：技术路线、数据壁垒、迭代速度
- P（政策）：监管框架、行业标准
写时不调用任何框架
❌ 不能在文章里写："P（背景）"、"E（经济）"、"T（技术）"
✅ 框架的输出变成：自然段落中的论点、数据、判断
八，写作流程v1.5.0
写前（后台，5分钟）
- SMART校验判断（不通过的不写）
- 列出对比清单（至少3个）
- 列出场景清单（至少3个）
- PEST扫描（至少覆盖3个维度）
构思（5分钟）
- 开头：谁+做了什么+为什么重要+抛出问题
- 中间段：论点1（问题+数据+对比+解释）
- 中间段：论点2（问题+数据+对比+解释）
- 中间段：论点3（问题+数据+对比+解释）
- 结尾：我的判断（2条）+ 开放性问题
写作
- 每段四层：背景+数据+对比+解释
- 对比穿插，每段至少1个
- 金句点缀，每1-2段1句
写后检查
- 读者看完第一段知道在讲什么吗？
- 每段核心信息能用一句话说清吗？
- 有对比吗？有金句吗？有具体场景吗？
九，禁止事项
- ❌ 开头纯悬念，不知道在讲什么
- ❌ 读者看完第一段不知道在讲什么公司/事件
- ❌ 段落只有数据没有解释
- ❌ 没有对比的段落
- ❌ 全篇少于3个具体场景
- ❌ 讲故事（要碎片化场景感）
- ❌ 文章出现"PDCA"、"PEST"等框架标签
- ❌ 把咨询框架当文章结构用
十，自动保存（强制执行）
写完立即保存，不依赖对话历史
根本原因：对话压缩会丢失完整文章内容。
保存触发条件
文章符合以下任一条件时，写完立即保存：
| 条件 | 说明 |
|---|
| ✅ 有明确标题 | 文章包含 # 一级标题 |
| ✅ 字数达标 | 文章字数 ≥ 500字 |
| ✅ 内容完整 | 有开头、正文、结尾 |
保存流程
[写作完成]
↓
1. 调用 auto-doc-saver skill
2. 内容质量检查（字数、金句、数据、配图）
3. 自动编号并保存到 成果归档/文章/
4. 如有短视频文案，保存到 成果归档/文案/
5. 自动更新索引 README.md
6. 在聊天窗口呈现完整文章 ← 新增
7. 返回保存报告和统计信息
保存命令
方式一：直接说
用户：保存这篇文章
系统：
━━━━━━━━━━━━━━━━━━━━━━━━
📄 文章：标题
━━━━━━━━━━━━━━━━━━━━━━━━
[完整文章内容]
━━━━━━━━━━━━━━━━━━━━━━━━
📊 文章统计
━━━━━━━━━━━━━━━━━━━━━━━━
字数：2200字 | 金句：6条 | 数据：5个
📁 已保存到：成果归档\文章\06-标题.md
📑 索引已更新
━━━━━━━━━━━━━━━━━━━━━━━━
方式二：自动保存
系统：文章已完成，正在保存...
[在聊天窗口呈现完整文章]
━━━━━━━━━━━━━━━━━━━━━━━━
📊 文章统计
━━━━━━━━━━━━━━━━━━━━━━━━
字数：2800字 | 金句：5条 | 数据：8个
📁 已保存到：成果归档\文章\08-文章标题.md
📑 索引已更新
━━━━━━━━━━━━━━━━━━━━━━━━
保存位置
| 类型 | 保存路径 | 命名规则 |
|---|
| 公众号文章 | 成果归档/文章/ | 序号-标题.md |
| 短视频文案 | 成果归档/文案/ | 日期_主题_文案.md |
保存前检查清单
系统会自动检查：
检查未通过时：
- 提示具体问题
- 可选择"强制保存"跳过检查
- 或修改后再保存
禁止事项
- ❌ 写完后不保存，依赖对话历史
- ❌ "记一下"、"回头再存"等拖延行为
- ❌ 手动复制粘贴保存
- ❌ 忘记保存导致文章丢失
历史教训
2026-04-05 事件：多篇文章因对话压缩丢失完整内容，只能通过memory文件重建摘要。
教训固化：写完立即保存，不依赖对话历史，不依赖"记住"。
十一，与 auto-doc-saver 集成
集成方式
写作完成后，自动调用 auto-doc-saver skill：
const saveResult = saveArticle(title, content);
if (saveResult.success) {
console.log(`✅ 已保存到 ${saveResult.path}`);
console.log(`📊 字数：${saveResult.wordCount}字`);
console.log(`📑 索引已更新`);
} else {
console.log(`⚠️ 内容检查未通过：${saveResult.check.issues.join(', ')}`);
console.log(`提示：使用"强制保存"跳过检查`);
}
保存报告示例
✅ 文章保存成功
━━━━━━━━━━━━━━━━━━━━━
📄 文件信息
━━━━━━━━━━━━━━━━━━━━━
路径：C:\Users\mengf\.qclaw\成果归档\文章\08-有线耳机回潮.md
序号：08
标题：有线耳机回潮
━━━━━━━━━━━━━━━━━━━━━
📊 质量报告
━━━━━━━━━━━━━━━━━━━━━
字数：2200字 ✓
金句：5条 ✓
数据：4个 ✓
配图：有 ✓
━━━━━━━━━━━━━━━━━━━━━
📑 索引状态
━━━━━━━━━━━━━━━━━━━━━
索引文件：已更新
最后更新：2026-04-06 14:30
最后更新：2026-04-06
版本：v1.5.0 + auto-save集成
