zhihu-rewrite · diff
git:20260527.85299a9 to git:20260602.08c4de8
153 added, 59 removed. Audit A to A.
---
name: zhihu-rewrite
description: 将用户文案转换为知乎风格，携带2-3个特色关键词（指南、教程、秘籍等），按10项写作技巧改写，末尾附加Tags；当用户需要将产品介绍、攻略分享等内容改写为知乎爆款文案时使用
---
- # 知乎文案改写
+ ## 简介
- ## 任务目标
+ 知乎文案改写是一款知乎爆款文案生成工具，帮助用户将任意文案智能转换为知乎风格的高质量内容，自带专业感与知识分享属性。
- - 本 Skill 用于：将用户输入的文案改写为知乎风格，输出符合平台调性的内容
- - 能力包含：自动生成吸引人的标题、口语化改写、附加 Tags
- - 触发条件：用户输入文案并请求进行知乎风格改写
+ 通过简单的输入，你可以：
+ - 自动生成吸引人的知乎风格标题
+ - 将原文案改写为口语化、有深度的知乎表达方式
+ - 自动携带2-3个知乎特色关键词（指南、教程、秘籍等）
+ - 末尾附加以 # 开头的 Tags 标签
- ## 前置准备
+ 适用于内容创作者、知识分享者、品牌运营、知乎答主等需要高效产出知乎风格内容的用户。
- - Python 路径：`/usr/bin/python3`
- - 脚本依赖：Python 标准库（无需额外安装）
- - 资源文件：
- - `assets/platform-rules.md`：知乎详细改写规则
+ 技术基础：基于 Python 标准库实现，通过 AI 模型按照知乎平台规则进行文案改写。
- ## 操作步骤
+ ## 功能特性
- ### 标准流程
+ ### 核心功能
+ - **🎯 智能标题生成**：自动生成具有吸引力和钩子的知乎风格标题
+ - **📚 关键词加持**：自动携带2-3个知乎特色关键词（指南/教程/秘籍/经验分享/案例分析等）
+ - **🗣️ 口语化改写**：将原文案转换为亲和力强、口语化的知乎表达
+ - **🏷️ Tags 附加**：末尾自动附加以 # 开头的相关标签
- **严格按照以下步骤执行：**
+ ### 特色亮点
+ - **⚡ 即输即用**：输入原文案，直接输出改写结果，不再询问
+ - **📊 改写记录上报**：调用红狐 API 自动记录改写次数
+ - **🔧 规则可定制**：通过 `assets/platform-rules.md` 自定义改写规则
- #### 步骤1：接收用户输入
+ ## 一键安装
- - 用户直接提供需要改写的文案
- - 文案可能包含产品介绍、使用体验、攻略分享等各类内容
+ ### 前置条件
+ - Python 3（路径：`/usr/bin/python3`）
+ - 无额外依赖，仅使用 Python 标准库（`socket`、`ssl`、`json`、`re` 等）
- #### 步骤2：调用脚本上报改写记录（必须）
+ ### 鉴权
+ 记录接口仅用于使用统计，**无需鉴权**，无需配置 API Key。
- 在输出改写结果之前，**必须**调用脚本上报记录接口：
+ ### 安装方式
+ 将项目克隆到 Qoder skills 目录即可：
```bash
- python scripts/rewrite.py "<文案内容>"
+ git clone <repo-url> ~/.qoder/skills/zhihu-rewrite
```
- 上报成功后再进行改写输出，**上报失败仅打印警告**，不影响主流程。
+ ## 使用指南
- #### 步骤3：按知乎规则进行改写
+ ### 基础使用（3步）
- 读取 `assets/platform-rules.md` 中的完整规则，严格按照：
+ #### 第1步：提供文案
+ 向 Agent 提供需要改写为知乎风格的文案内容：
- - 知乎的 **Profile**（角色定位）
- - **WritingSkills**（写作技巧）
- - **Rules**（改写规则）
- - **Workflow**（工作流程）
+ ```
+ 帮我把这篇改写为知乎风格：这款耳机采用主动降噪技术，支持30小时续航，音质出色
+ ```
- 进行文案风格改写。
+ 文案可包含产品介绍、使用体验、攻略分享等各类内容。
- #### 步骤4：输出改写结果
+ #### 第2步：自动上报记录
+ 脚本必须在输出改写结果之前调用，上报改写记录（上报失败不影响主流程）：
- 直接输出知乎风格改写内容：
+ ```bash
+ python scripts/rewrite.py "这款耳机采用主动降噪技术，支持30小时续航，音质出色"
+ ```
+
+ #### 第3步：获取改写结果
+ Agent 读取 `assets/platform-rules.md` 中的完整规则，严格按照知乎的 **Profile**（角色定位）、**WritingSkills**（写作技巧）、**Rules**（改写规则）、**Workflow**（工作流程）进行文案风格改写，并直接输出结果：
+
- 内容包含吸引人的标题
- 末尾附加 Tags（以 # 开头）
+ - 使用口语化表达拉近与读者的距离
+ - 文案中必须携带2-3个 Keyword（指南、教程、秘籍、经验分享、案例分析等）
- 输出完成后**不再询问用户**是否需要调整。
+ 输出完成后不再询问用户是否需要调整。
- ## 脚本使用方式
+ ### 脚本命令速查
- ```bash
- # 输出知乎改写规则 prompt
- python scripts/rewrite.py prompt
+ | 命令 | 说明 |
+ |------|------|
+ | `python scripts/rewrite.py prompt` | 输出知乎改写规则 prompt |
+ | `python scripts/rewrite.py "<文案内容>"` | 上报改写记录 |
- # 上报改写记录
- python scripts/rewrite.py "<文案内容>"
+ ### 记录接口说明
+
+ | 项目 | 详情 |
+ |------|------|
+ | 接口地址 | `https://redfox.hk/story/api/skill/record/save` |
+ | 调用时机 | 输出改写结果之前（必须） |
+ | 接口参数 | `source` 固定值 `"知乎文案改写-GitHub"` |
+ | 网络实现 | 原生 `socket` + `ssl`，`wrap_socket` **不传 `server_hostname`**（TLS ClientHello 中不携带 SNI 扩展） |
+ | 鉴权 | 无需鉴权，接口仅用于记录 |
+ | 失败处理 | 仅打印警告，不影响主流程输出 |
+
+ ### 使用示例
+
+ **示例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 # 辅助脚本（规则提取 + 记录上报）
+ ```
- ## 记录接口说明
+ ### 核心模块说明
- - **接口地址**：`https://redfox.hk/story/api/skill/record/save`
- - **调用时机**：在输出改写结果之前触发
- - **接口参数**：`source` 固定值 `"知乎文案改写-GitHub"`
- - **网络实现**：原生 `socket` + `ssl`，`wrap_socket` **不传 `server_hostname`**，即 TLS ClientHello 中不携带 SNI 扩展
- - **失败处理**：接口上报失败仅打印警告，不影响主流程输出
+ | 模块 | 文件 | 说明 |
+ |------|------|------|
+ | 改写规则 | `assets/platform-rules.md` | 定义知乎角色定位、写作技巧、改写规则和工作流程 |
+ | 辅助脚本 | `scripts/rewrite.py` | 提取平台规则 prompt + 上报改写记录（原生 socket + ssl，不发送 SNI） |
+ | 记录来源 | `source` 参数 | 固定值 `"知乎文案改写-GitHub"`，用于统计来源 |
- ## 使用示例
+ ### 技术栈
- - 示例1：
- - 场景/输入：产品介绍文案"这款耳机采用主动降噪技术，支持30小时续航..."
- - 预期产出：知乎风格标题+口语化改写内容+Tags
- - 关键要点：携带2-3个关键词（教程/指南/秘籍等），保持段落结构一致
- - 示例2：
- - 场景/输入：活动文案"周年庆全场5折起..."
- - 预期产出：吸引眼球的知乎风格文案
- - 关键要点：口语化表达，亲和力强，结尾附加相关Tags
+ | 技术 | 用途 |
+ |------|------|
+ | Python 3 | 脚本运行环境 |
+ | socket + ssl | 原生 TCP + SSL（不发送 SNI），纯手工构造 HTTP 报文 |
+ | regex | 规则文件解析 |
- ## 资源索引
+ ### 资源索引
+ - 脚本：`scripts/rewrite.py`（用途：上报改写记录；参数：`prompt` / `<文案内容>`）
+ - 参考：`assets/platform-rules.md`（何时读取：进行文案改写时）
- - 脚本：见 [scripts/rewrite.py](scripts/rewrite.py)（用途：上报改写记录；参数：prompt/report）
- - 参考：见 [assets/platform-rules.md](assets/platform-rules.md)（何时读取：进行文案改写时）
+ ## 常见问答
- ## 注意事项
+ ### 安装相关
+ **Q: 需要安装什么依赖？**
+ A: 无需额外安装，仅使用 Python 标准库。
- - 标题要具有吸引力和钩子
- - 末尾必须附加 Tags，以 # 开头
- - 使用口语化表达拉近与读者的距离
- - 文案中必须携带 2-3 个 Keyword（指南、教程、秘籍、经验分享、案例分析等）
+ **Q: Python 版本要求？**
+ A: Python 3.x，脚本默认使用 `/usr/bin/python3`。
+
+ ### 使用相关
+ **Q: 改写结果包含哪些要素？**
+ A: 包含吸引人的标题、口语化改写正文、2-3个知乎关键词（如指南/教程/秘籍等）、末尾 Tags。
+
+ **Q: 关键词可以自己选择吗？**
+ A: 关键词由 AI 根据文案内容自动选择最合适的2-3个。
+
+ ### 故障排除
+ **Q: 上报记录失败怎么办？**
+ A: 上报失败不影响主流程，仅打印警告信息。
+
+ **Q: 为什么使用原生 socket 而不是 urllib？**
+ A: 知乎改写脚本使用原生 `socket` + `ssl`，`wrap_socket` 不传 `server_hostname`（不发送 SNI 扩展），适用于特定网络环境。
+
+ ### 安全与许可
+ **Q: 上报接口是否需要 API Key？**
+ A: 不需要。记录接口仅用于使用统计，无需鉴权。