MakeContents Agent 技能

概述

MakeContents 是一个本地运行的 RSS 资讯聚合与内容创作应用。此技能让 Agent 能够自主完成以下工作：

拉取资讯 — 从配置的 RSS/RSSHub 信源获取最新内容
筛选推送 — 根据学习到的规律选择有价值的资讯，直接生成推送内容并分发到微信和飞书知识库
内容创作 — 为选定资讯生成小红书风格的图文内容，自动渲染封面和详情图
内容归档 — 将创作结果保存到飞书多维表，通知人类审核

配置

在开始前确认以下配置（通过应用系统配置页面或 .env 设置）：

MakeContents 服务地址：默认 http://localhost:3710
各功能所需的 API Key（飞书、微信）已在应用配置页填写
飞书多维表 URL 已配置（用于内容归档，可选）
飞书机器人 Webhook 已配置（用于完成通知）
小红书 Cookie 已配置 + 发布开关已开启（用于发布笔记，默认关闭，需人类主动开启）

重要提示

必须使用 exec + curl 调用 API，不要使用 web_fetch（后者用于抓取外部网页，无法访问本地服务）
所有 API 请求需包含 Header：Content-Type: application/json 和 Accept: application/json
执行前建议先检查服务健康：curl -s http://localhost:3710/api/health 应返回 {"status":"ok"}

API 参考

完整 API 文档见 references/api.md，包含所有接口的请求/响应格式。

选择规律记忆

Agent 的学习规律存储在技能文件路径下 references/agent-rules.md，每次学习后更新此文件。

执行流程

流程一：学习选择规律(可选)

先读取文件references/agent-rules.md文档，如果包含内容筛选规律则使用此规律作为后续任务的选择标准，跳过此步骤；无可参考的规律内容时按顺序执行：

调用 GET /api/news/agent-summary 获取学习数据
分析数据：
- saved_news：用户推送过的资讯（含 push_type）
- all_news_in_period：对应时段所有资讯
- 对比两个列表，提炼被选中资讯的共同特征
将分析的规律追加到 references/agent-rules.md中

分析角度：

被选中资讯的来源分布（哪些信源更受偏好）
被选中资讯的主题特征（关键词、话题类型）
推送类型分布（用户倾向于哪类推送）
内容创作选题特征（哪类话题被创作）

流程二：资讯推送

To execute the news push workflow:

调用 POST /api/news/fetch 拉取最新资讯
调用 GET /api/news/grouped?agent=1 获取资讯列表（已推送条目自动排除，无需手动去重）
使用 references/agent-rules.md 中的筛选规律
根据规律从列表中筛选 0-5 条有价值的资讯（无有价值资讯可直接结束此流程）
对每条资讯：
- 判断推送类型（ainews / aitopics / aitools）
- 生成 news_title（≤30字，精炼有力）和 news_summary（100-200字，符合对应风格）
- 调用对应推送接口（注意：接口路径为 /api/news/{id}/ainews 等，不是 /{id}/ainews/）：
```
POST /api/news/{id}/ainews
POST /api/news/{id}/aitopics
POST /api/news/{id}/aitools
```
- 请求体示例：{"news_title":"标题","news_summary":"摘要内容"}
完成后调用 POST /api/content/notify-bot 通知人类

推送类型判断原则：

ainews：客观事实类资讯，速报风格
aitopics：有争议或引人思考的话题，末尾加引导性问题
aitools：新工具/新产品发布，突出功能和使用场景

流程三：内容创作

To execute the content creation workflow:

从资讯列表选定 0-3 条适合内容创作的资讯（通常是有深度或有趣的话题，无有价值资讯可直接结束此流程）
对每条资讯，构造以下参数并调用 POST /api/content/agent-render：
- news_id：资讯 ID
- source_url：原始链接（description中的链接，不是资讯的链接；有则填，服务会自动截图）
- cover_word：1-2个英文单词，概括核心主题
- cover_title：≤15字，有冲击力的中文标题
- cover_description：≤20字，补充说明
- cover_emoji：1个相关 Emoji
- content_type：news/tools/topics/default（决定配色）
- title：≤20字，小红书风格标题
- content：正文，500-800字，小红书风格，有观点有情感
- tags：3-5个标签，逗号分隔
获取渲染结果的 saved_content_id、cover_url、detail_urls
（可选，未明确则跳过）调用 POST /api/content/save-to-bitable 存入飞书多维表（传 saved_content_id）
调用 POST /api/content/publish-xhs将笔记内容发布到小红书：
```
{
  "title": "{title（≤20字）}",
  "desc": "{content}",
  "cover_url": "{cover_url}",
  "detail_urls": ["{detail_urls[0]}", "..."],
  "is_private": true
}
```
- Agent 必须传 "is_private": true，笔记将以「仅自己可见」发布，由人类在小红书 App 中审核后手动设为公开
- 成功后从响应中取 note_url
- 若接口返回错误"小红书发布功能未开启"，不重试、不报错，跳过此步骤即可

调用 POST /api/content/notify-bot 发送通知，消息格式：

✅ 内容创作完成

标题：{title}
类型：{content_type}
标签：{tags}

已存入飞书多维表，请审核。
{如已发布到小红书：🔗 小红书笔记（仅自己可见，请在 App 审核后设为公开）：{note_url}}

注意事项

截图详情图可能因目标网站防爬而失败，失败时静默跳过，只生成封面
推送接口会自动标记资讯为已保存，无需手动调用 save 接口
Agent 生成内容时，news_title 和 news_summary 直接作为推送内容，需保证质量
每次执行完整流程后，建议执行一次学习流程以更新规律记忆
小红书发布：发布开关默认关闭，由人类决定是否授权。Agent 应尊重此开关，收到"未开启"错误时静默跳过，不得反复重试或提示人类开启
服务不可用：调用 API 前建议先 GET /api/health。若请求返回 5xx 错误，可能是服务临时故障，可等待数秒后重试一次；若仍失败则终止流程并通知人类

makecontents