# Makecontents

> MakeContents AI 资讯 Agent 技能。当用户需要自动执行资讯拉取、筛选推送（AINews/AITopics/AITools）、内容创作、内容发布、内容归档等任务时使用此技能。此技能调用本地运行的 MakeContents 应用 API，无需人工干预即可完成完整的内容创作和分发流程。

- Skill: `comeonzhj/makecontents` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add comeonzhj/makecontents`
- Raw SKILL.md: https://api.skillmd.com/api/skills/comeonzhj/makecontents/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: comeonzhj (https://skillmd.com/u/comeonzhj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/comeonzhj/makecontents

---


# MakeContents Agent 技能

## 概述

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

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

## 配置

在开始前确认以下配置（通过应用系统配置页面或 `.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`文档，如果包含内容筛选规律则使用此规律作为后续任务的选择标准，跳过此步骤；无可参考的规律内容时按顺序执行：

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

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

### 流程二：资讯推送

To execute the news push workflow:

1. 调用 `POST /api/news/fetch` 拉取最新资讯
2. 调用 `GET /api/news/grouped?agent=1` 获取资讯列表（已推送条目自动排除，无需手动去重）
3. 使用 `references/agent-rules.md` 中的筛选规律
4. 根据规律从列表中筛选 0-5 条有价值的资讯（无有价值资讯可直接结束此流程）
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":"摘要内容"}`
6. 完成后调用 `POST /api/content/notify-bot` 通知人类

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

### 流程三：内容创作

To execute the content creation workflow:

1. 从资讯列表选定  0-3 条适合内容创作的资讯（通常是有深度或有趣的话题，无有价值资讯可直接结束此流程）
2. 对每条资讯，构造以下参数并调用 `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个标签，逗号分隔
3. 获取渲染结果的 `saved_content_id`、`cover_url`、`detail_urls`
4. （可选，未明确则跳过）调用 `POST /api/content/save-to-bitable` 存入飞书多维表（传 `saved_content_id`）
5. 调用 `POST /api/content/publish-xhs`将笔记内容发布到小红书：
   ```json
   {
     "title": "{title（≤20字）}",
     "desc": "{content}",
     "cover_url": "{cover_url}",
     "detail_urls": ["{detail_urls[0]}", "..."],
     "is_private": true
   }
   ```
   - **Agent 必须传 `"is_private": true`**，笔记将以「仅自己可见」发布，由人类在小红书 App 中审核后手动设为公开
   - 成功后从响应中取 `note_url`
   - 若接口返回错误"小红书发布功能未开启"，**不重试、不报错**，跳过此步骤即可
6. 调用 `POST /api/content/notify-bot` 发送通知，消息格式：
   ```
   ✅ 内容创作完成
   
   标题：{title}
   类型：{content_type}
   标签：{tags}
   
   已存入飞书多维表，请审核。
   {如已发布到小红书：🔗 小红书笔记（仅自己可见，请在 App 审核后设为公开）：{note_url}}
   ```

---

## 注意事项

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