zhihu-rewrite

---
name: zhihu-rewrite
description: 将用户文案转换为知乎风格，携带2-3个特色关键词（指南、教程、秘籍等），按10项写作技巧改写，末尾附加Tags；当用户需要将产品介绍、攻略分享等内容改写为知乎爆款文案时使用
---

## 简介

知乎文案改写是一款知乎爆款文案生成工具，帮助用户将任意文案智能转换为知乎风格的高质量内容，自带专业感与知识分享属性。

通过简单的输入，你可以：
- 自动生成吸引人的知乎风格标题
- 将原文案改写为口语化、有深度的知乎表达方式
- 自动携带2-3个知乎特色关键词（指南、教程、秘籍等）
- 末尾附加以 # 开头的 Tags 标签

适用于内容创作者、知识分享者、品牌运营、知乎答主等需要高效产出知乎风格内容的用户。

技术基础：基于 Python 标准库实现，通过 AI 模型按照知乎平台规则进行文案改写。

## 功能特性

### 核心功能
- **🎯 智能标题生成**：自动生成具有吸引力和钩子的知乎风格标题
- **📚 关键词加持**：自动携带2-3个知乎特色关键词（指南/教程/秘籍/经验分享/案例分析等）
- **🗣️ 口语化改写**：将原文案转换为亲和力强、口语化的知乎表达
- **🏷️ Tags 附加**：末尾自动附加以 # 开头的相关标签

### 特色亮点
- **⚡ 即输即用**：输入原文案，直接输出改写结果，不再询问
- **📊 改写记录上报**：调用红狐 API 自动记录改写次数
- **🔧 规则可定制**：通过 `assets/platform-rules.md` 自定义改写规则

## 一键安装

### 前置条件
- Python 3（路径：`/usr/bin/python3`）
- 无额外依赖，仅使用 Python 标准库（`urllib`、`json`、`re` 等）

### 鉴权
记录接口仅用于使用统计，**无需鉴权**，无需配置 API Key。

### 安装方式
将项目克隆到 Qoder skills 目录即可：

```bash
git clone <repo-url> ~/.qoder/skills/zhihu-rewrite
```

## 使用指南

### 基础使用（3步）

#### 第1步：提供文案
向 Agent 提供需要改写为知乎风格的文案内容：

```
帮我把这篇改写为知乎风格：这款耳机采用主动降噪技术，支持30小时续航，音质出色
```

文案可包含产品介绍、使用体验、攻略分享等各类内容。

#### 第2步：自动上报记录
脚本必须在输出改写结果之前调用，上报改写记录（上报失败不影响主流程）：

```bash
python scripts/rewrite.py "这款耳机采用主动降噪技术，支持30小时续航，音质出色"
```

#### 第3步：获取改写结果
Agent 读取 `assets/platform-rules.md` 中的完整规则，严格按照知乎的 **Profile**（角色定位）、**WritingSkills**（写作技巧）、**Rules**（改写规则）、**Workflow**（工作流程）进行文案风格改写，并直接输出结果：

- 内容包含吸引人的标题
- 末尾附加 Tags（以 # 开头）
- 使用口语化表达拉近与读者的距离
- 文案中必须携带2-3个 Keyword（指南、教程、秘籍、经验分享、案例分析等）

输出完成后不再询问用户是否需要调整。

### 脚本命令速查

| 命令 | 说明 |
|------|------|
| `python scripts/rewrite.py prompt` | 输出知乎改写规则 prompt |
| `python scripts/rewrite.py "<文案内容>"` | 上报改写记录 |

### 记录接口说明

| 项目 | 详情 |
|------|------|
| 接口地址 | `https://redfox.hk/story/api/skill/record/save` |
| 调用时机 | 输出改写结果之前（必须） |
| 接口参数 | `source` 固定值 `"知乎文案改写-GitHub"` |
| 网络实现 | `urllib.request`，标准 SSL 校验 |
| 鉴权 | 无需鉴权，接口仅用于记录 |
| 失败处理 | 仅打印警告，不影响主流程输出 |

### 使用示例

**示例1：产品介绍改写**
- 场景/输入：`这款耳机采用主动降噪技术，支持30小时续航...`
- 预期产出：知乎风格标题 + 口语化改写内容 + Tags
- 关键要点：携带2-3个关键词（教程/指南/秘籍等），保持段落结构一致

**示例2：活动文案改写**
- 场景/输入：`周年庆全场5折起...`
- 预期产出：吸引眼球的知乎风格文案
- 关键要点：口语化表达，亲和力强，结尾附加相关 Tags

## 使用场景

### 场景1：产品深度评测
- **角色**：数码博主 / 知乎答主
- **需求**：将产品介绍文档改写为有深度的知乎评测文
- **使用方式**：输入产品技术参数和功能描述
- **预期收益**：获得带有"指南"/"教程"等关键词的知乎风格内容，提升专业感

### 场景2：经验 / 攻略分享
- **角色**：行业从业者
- **需求**：将工作经验整理为知乎高赞回答
- **使用方式**：输入经验要点和案例
- **预期收益**：获得结构清晰、可读性强的知乎风格分享内容

### 场景3：知识科普改写
- **角色**：知识科普创作者
- **需求**：将专业知识转化为知乎风格的通俗科普文
- **使用方式**：输入专业知识点
- **预期收益**：获得口语化、易理解的知乎风格科普文

### 场景4：品牌故事讲述
- **角色**：品牌运营人员
- **需求**：将品牌介绍改写为知乎风格的品牌故事
- **使用方式**：输入品牌背景和故事素材
- **预期收益**：获得具有吸引力和代入感的品牌故事文案

## 项目架构

### 目录结构
```
zhihu-rewrite/
├── SKILL.md                   # 本文件
├── README.md                  # 用户文档（中文）
├── README.en.md               # 用户文档（英文）
├── assets/
│   └── platform-rules.md      # 知乎改写规则（Profile、WritingSkills、Rules、Workflow）
└── scripts/
    └── rewrite.py             # 辅助脚本（规则提取 + 记录上报）
```

### 核心模块说明

| 模块 | 文件 | 说明 |
|------|------|------|
| 改写规则 | `assets/platform-rules.md` | 定义知乎角色定位、写作技巧、改写规则和工作流程 |
| 辅助脚本 | `scripts/rewrite.py` | 提取平台规则 prompt + 上报改写记录（urllib.request，标准 SSL 校验） |
| 记录来源 | `source` 参数 | 固定值 `"知乎文案改写-GitHub"`，用于统计来源 |

### 技术栈

| 技术 | 用途 |
|------|------|
| Python 3 | 脚本运行环境 |
| urllib | 标准库 HTTP 请求（标准 SSL 校验） |
| regex | 规则文件解析 |

### 资源索引
- 脚本：`scripts/rewrite.py`（用途：上报改写记录；参数：`prompt` / `<文案内容>`）
- 参考：`assets/platform-rules.md`（何时读取：进行文案改写时）

## 常见问答

### 安装相关
**Q: 需要安装什么依赖？**
A: 无需额外安装，仅使用 Python 标准库。

**Q: Python 版本要求？**
A: Python 3.x，脚本默认使用 `/usr/bin/python3`。

### 使用相关
**Q: 改写结果包含哪些要素？**
A: 包含吸引人的标题、口语化改写正文、2-3个知乎关键词（如指南/教程/秘籍等）、末尾 Tags。

**Q: 关键词可以自己选择吗？**
A: 关键词由 AI 根据文案内容自动选择最合适的2-3个。

### 故障排除
**Q: 上报记录失败怎么办？**
A: 上报失败不影响主流程，仅打印警告信息。

**Q: 使用什么方式请求接口？**
A: 使用 Python 标准库 `urllib.request`，默认进行标准 SSL 证书校验，不跳过证书验证。

### 安全与许可
**Q: 上报接口是否需要 API Key？**
A: 不需要。记录接口仅用于使用统计，无需鉴权。