yuwen-publish-precheck 详细部署与使用教程

这是一个专门为国内自媒体（抖音、小红书、视频号）设计的发布前AI审稿工具，能帮你找出稿子里的违规风险并直接给出修改方案。

下面我会从零开始，带你完成安装、配置和首次使用。

第一步：准备工作

在开始安装前，请确保你的电脑满足以下条件：

操作系统：macOS、Linux 或 Windows。
Python 环境：需要安装 Python 3（项目本身无其他依赖）。
AI 编程助手：你需要有一个支持 Agent Skills 的客户端，例如：
- Cursor
- Claude Code
- Codex
- 其他支持该规范的工具。

国内用户特别注意：如果使用 Claude Code，由于网络原因，你可能需要额外配置 API 代理才能正常使用。可以将 ANTHROPIC_BASE_URL 等环境变量指向可用的 API 服务。

你可以选择 一键自动安装 或 手动克隆安装。

这是最简单的方法。直接在你的 AI 助手（如 Cursor 或 Claude Code）对话框中，发送以下指令：

1	请安装这个 skill：https://github.com/yuwen-cool/yuwen-publish-precheck.git

你的 AI 助手会自动理解并执行安装过程。

部分支持 npx 命令的工具，也可以尝试在终端中执行：

1	npx skills add https://github.com/yuwen-cool/yuwen-publish-precheck --skill yuwen-publish-precheck

如果你偏好手动操作或自动安装失败，可以将项目克隆到本地对应的技能目录。

对于 Cursor（用户级安装，全局可用）：

1	git clone https://github.com/yuwen-cool/yuwen-publish-precheck.git ~/.cursor/skills/yuwen-publish-precheck

对于 Claude Code（用户级安装，全局可用）：

1	git clone https://github.com/yuwen-cool/yuwen-publish-precheck.git ~/.claude/skills/yuwen-publish-precheck

提示：项目级安装通常将 skills 放在项目根目录下的 .cursor/skills/ 或 .claude/skills/ 文件夹中，这样可以与团队共享。

安装完成后，你的技能目录下会有一个包含 SKILL.md 文件的 yuwen-publish-precheck 文件夹。AI 助手在启动时会自动发现并加载它。

安装成功后，你就可以开始使用它了。

说出第一句话：在 AI 助手的对话框中，直接输入以下任一指令：

1	用 yuwen-publish-precheck 审一下这篇口播稿能不能发抖音：（贴上你的稿子）

1	帮我把这篇文案改成小红书能发的版本

1	我这条视频被限流了，帮我复盘一下为什么

首次建档：当你第一次使用审稿功能时，Skill 会主动引导你完成一个简单的 “建档” 流程。它会问你几个基础问题，例如：
- 你常发布的平台（抖音、小红书、视频号等）
- 你所在的行业（通用、医疗健康、金融理财等）
- 你的商业模式（纯分享、带货、知识付费等）
完成这一步后，它能结合你的个人档案进行更精准的审核。

这个 Skill 的核心工作流是先审后改、改完复检，下面是它处理一篇稿子的典型过程。

提交原稿：你给它一篇带货口播稿。
词面预检：它会快速扫描出“瘦了八斤”、“全网最低价”、“加我微信”等需要关注的词汇。
语义判定：结合上下文和平台规则，判定这些问题属于“极高风险”、“红线”还是“仅提示”。
生成报告：输出详细的审核结论，包括：
- 问题位置：具体是哪句话有问题。
- 违规依据：引用哪条广告法或平台规则原文。
- 修改建议：给出可直接替换的句子。
保意修复：在原稿基础上进行修改，重点保留你的语气和“钩子”，只拆掉违规的实质。例如，它会将“吃了两周瘦了八斤”改为“最近两周，我把下午那杯奶茶换成了它……体重的事我不打包票，管住嘴迈开腿才是根本”。
自动复检：修改完成后，它会自动对修改稿再次进行审核，确认没有问题后，给出“发布前检查单”。

这是该工具最核心的特性之一——它能记住你的偏好和踩过的坑，所有数据都存储在你电脑的 data/ 目录下，纯文本格式，永不上传。

你可以通过自然语言直接教它“新知识”：