Article Workflow Skill
描述
文章分析工作流自动化 Skill。提供从文章抓取、分析、归档到质量评分的完整流程，支持 URL 去重、Heartbeat 自动触发、监控日志等功能。
注意： 本 Skill 已合并原 article-analyzer 功能，推荐使用本 Skill。🔒 安全说明
数据边界：
- ✅ 所有数据文件在
skills/article-workflow/data/内 - ✅ 所有日志文件在
skills/article-workflow/logs/内 - ✅ 不访问工作区外文件
- ✅ 路径验证确保所有操作在 Skill 目录内
凭证要求：
- ✅ 需要
BITABLE_APP_TOKEN和BITABLE_TABLE_ID - ✅ 凭证通过
config.json或环境变量提供 - ✅ 敏感信息不会被提交到版本控制（.gitignore）
运行模式：
- 独立模式 - 仅 CLI 功能（去重检查、状态查看）
- 集成模式 - 需要 OpenClaw 环境（完整功能）
使用场景
当用户需要：
- 分析文章 URL（微信、知乎、GitHub 等）
- 自动生成摘要、标签、分析报告
- 将分析结果归档到飞书多维表格和文档
- 对文章进行质量评分（S/A/B/C/D）
- 自动检查重复 URL
- 定时自动处理群聊中的文章链接
- 批量分析多篇文章（并发执行）
🚀 智能路由模式
单篇模式（默认）
触发： 单篇文章 URL
分析这篇文章：https://example.com/article执行方式： 主 Agent 一次性执行（1 次流式请求）
主 Agent（机器人）
├─ 流式请求开始 ─────┐
│ 1. web_fetch 抓取 │
│ 2. 自己分析内容 │ ← 同一次流式请求
│ 3. 生成完整报告 │
│ 4. feishu_create_doc│
│ 5. feishu_bitable │
└─ 流式请求结束 ─────┘
模型请求次数：1 次 ✅批量模式（自动）
触发： 多篇文章 URL
批量分析这些文章：
- https://example.com/article1
- https://example.com/article2
- https://example.com/article3执行方式： SubAgent 并发执行（N 次但并行）
主 Agent（机器人）
├─ 创建 3 个 SubAgent（并发）
│ ├─ SubAgent-1: 分析 url1 → 1 次流式请求
│ ├─ SubAgent-2: 分析 url2 → 1 次流式请求
│ └─ SubAgent-3: 分析 url3 → 1 次流式请求
└─ 汇总结果
模型请求次数：3 次（但并发执行，总时间 ≈ 1 次）✅并发控制
- 最大并发数： 5 个 SubAgent
- 超过限制： 自动分批处理
- 流式优化： 工具调用不中断流式，算 1 次请求
工作流程
单篇模式
输入：文章 URL
↓
主 Agent 智能路由（单篇模式）
├─ web_fetch 抓取内容
├─ 分析内容 + 质量评分
├─ 生成详细报告
├─ feishu_create_doc 创建文档
└─ feishu_bitable 归档到多维表格
↓
输出：摘要 + 报告链接 + 评分批量模式
输入：多篇文章 URL
↓
主 Agent 智能路由（批量模式）
├─ 创建 SubAgent #1 ─→ 分析文章 1
├─ 创建 SubAgent #2 ─→ 分析文章 2
├─ 创建 SubAgent #3 ─→ 分析文章 3
└─ 等待所有 SubAgent 完成
↓
汇总所有结果
↓
输出：汇总报告 + 各文章链接🔧 配置管理
配置保护机制
重要： config.json 包含敏感信息，已加入 .gitignore，不会被 Git 提交。
在修改/升级 Skill 前：
cd skills/article-workflow
# 1. 备份配置（修改前必做）
python3 scripts/config_manager.py backup
# 或使用脚本
./scripts/backup-config.sh修改/升级后：
# 恢复配置
python3 scripts/config_manager.py restore
# 或使用脚本
./scripts/restore-config.sh首次使用配置
方式 1：配置向导（推荐）
python3 scripts/config_manager.py guide方式 2：手动创建
# 复制示例配置
cp config.example.json config.json
# 编辑配置
vim config.json方式 3：环境变量
export BITABLE_APP_TOKEN=your_token
export BITABLE_TABLE_ID=your_table_id配置参数
在 config.json 中配置：
{
"bitable": {
"app_token": "YOUR_BITABLE_TOKEN",
"table_id": "YOUR_TABLE_ID"
},
"workflow": {
"check_interval_hours": 6,
"batch_limit": 10,
"enable_quality_score": true,
"enable_url_dedup": true
},
"paths": {
"data": "./data",
"logs": "./logs"
}
}命令
分析单篇文章
飞书单聊（推荐）：
分析这篇文章：https://example.com/article飞书群聊：
分析这篇文章：https://example.com/article单聊时无需@机器人，直接发送即可。
查看状态
cd skills/article-workflow
./scripts/monitor.sh status生成周报
./scripts/monitor.sh report清理数据
./scripts/monitor.sh cleanup输出格式
群聊消息
✅ 文章分析完成
📌 [文章标题]
🔗 [URL]
📝 简短摘要
[3-5 句摘要]
🏷️ 标签：[标签 1] [标签 2] [标签 3]
⭐ 重要程度：[高/中/低]
📊 质量评分：[85/100] (A 级)
📄 详细报告：[飞书文档链接]
📊 已录入：[Bitable 链接]Bitable 字段映射
必填字段：
| 字段名 | 说明 | 来源 |
|---|---|---|
| 文章标题（主） | 主字段（显示用） | 文章标题 |
| 标题 | 副标题（兼容用） | 文章标题（与主字段相同） |
| 简短摘要 | 3-5 句摘要 | LLM 生成 |
| 阅读日期 | 分析日期 | 当前时间戳 |
| 来源 | 文章来源 | 微信/GitHub/知乎等 |
| 关键词标签 | 多选标签 | LLM 提取 + 匹配现有选项 |
| 重要程度 | 高/中 | 根据质量评分 |
| 状态 | 已完成 | 固定值 |
| 创建方式 | 手动触发/自动分析 | 根据触发方式 |
| URL 链接 | 原文链接 | 用户提供的 URL |
| 详细报告链接 | 飞书文档链接 | feishu_create_doc 返回 |
注意： "文章标题（主）"和"标题"都需要填写，确保数据完整性。
质量评分
| 总分 | 等级 | 重要程度 | 处理策略 |
|---|---|---|---|
| 85-100 | S 级 | 极高 | 立即处理 + 团队分享 |
| 70-84 | A 级 | 高 | 优先处理 + 详细分析 |
| 55-69 | B 级 | 中 | 正常处理 + 标准报告 |
| 40-54 | C 级 | 低 | 简略处理 + 基础摘要 |
| 0-39 | D 级 | 极低 | 跳过或仅存档 |
依赖
- Python 3.7+
- 飞书开放平台 API
- OpenClaw 框架
安装
cd ~/.openclaw/workspace/skills
git clone <repo_url> article-workflow
cd article-workflow
./install.sh文件结构
article-workflow/
├── SKILL.md # 本文件
├── README.md # 详细文档
├── install.sh # 安装脚本
├── config.example.json # 配置模板
├── scripts/ # 可执行脚本
│ ├── check_url_dup.py # URL 去重
│ ├── monitor.sh # 监控
│ └── workflow.py # 主流程
├── docs/ # 文档
│ ├── config.md # 配置说明
│ ├── quality-score.md # 评分标准
│ └── automation.md # 自动化
├── data/ # 运行时数据
│ └── url_cache.json
└── logs/ # 日志
├── workflow.log
└── error.log注意事项
- 首次使用需要配置
config.json - 飞书授权需要完成 OAuth 流程
- Heartbeat 自动触发需要在 HEARTBEAT.md 中配置
- 日志文件建议定期清理（>30 天）
- URL 缓存保留最近 1000 条记录
故障排查
URL 去重不生效
- 检查
data/url_cache.json是否存在 - 验证 Python 脚本权限：
chmod +x scripts/check_url_dup.py
监控脚本报错
- 检查 Bash 版本：需要 4.0+
- 验证路径配置
质量评分偏差
- 调整
docs/quality-score.md中的权重 - 优化 LLM 提示词
版本
- 当前版本： 1.0.0
- 最后更新： 2026-03-14
- 作者： Nox（DongNan 的 AI 助理）
License
MIT License