cn-brand-voice

Readme

# cn-brand-voice

> **让 AI 写作从模板腔变成"有品牌、有对象、有证据"的中文表达。**
> *Turn AI-generated Chinese into on-brand, audience-aware, evidence-backed copy — ready to publish.*

`cn-brand-voice` 是一个遵循开放 Agent Skills 格式的中文品牌编辑 Skill。它把 AI 生成的"套话腔"内容，改成符合品牌语气、面向具体受众、有事实支撑、可直接发布的中文表达。

它**不是**"绕过 AI 检测"或"伪装人类写作"工具。它只改写表达，不捏造事实、不夸大承诺、不弱化免责声明。

---

## 目录

- [Demo / 演示](#demo--演示)
- [安装 / Install](#安装--install)
- [Before / After 样例](#before--after-样例)
- [5 套内置语气模板](#5-套内置语气模板)
- [项目配置](#项目配置)
- [隐私与反虚假宣传 / Privacy & Anti-false-advertising](#隐私与反虚假宣传--privacy--anti-false-advertising)
- [评测 / Evaluation](#评测--evaluation)
- [License](#license)

---

## Demo / 演示

![cn-brand-voice demo](docs/demo.svg)

> 上图为动画占位图（animated placeholder）。发布前请替换为真实 30 秒 GIF，演示"原文 → 三层编辑 → 修改后版本 + 修改说明 + 风险提示 + 保留事实清单"的完整流程。
>
> The image above is an animated placeholder. Replace it with a real 30-second GIF before publishing, showing the full flow: *raw input → 3-layer editing → revised version + edit notes + risk warnings + preserved-facts list*.

---

## 安装 / Install

本 Skill 遵循开放 Agent Skills 格式，可运行于多个宿主。请向你使用的**每个**宿主**分别**安装——各宿主的 skills 目录相互独立，不会自动同步。

This skill follows the open Agent Skills format and runs on multiple hosts. Install it **separately** into **each** host you use — each host maintains its own skills directory and they do not sync.

### Claude Code

```bash
mkdir -p ~/.claude/skills
cp -r cn-brand-voice ~/.claude/skills/
```

安装后，在 Claude Code 中直接说"帮我润色这段文案"即可触发。
After installing, just say "帮我润色这段文案" in Claude Code to trigger the skill.

### Cursor

```bash
mkdir -p ~/.cursor/skills
cp -r cn-brand-voice ~/.cursor/skills/
```

### Codex

```bash
mkdir -p ~/.codex/skills
cp -r cn-brand-voice ~/.codex/skills/
```

> **注意 / Note**：三个宿主的目录互不共享。如果你同时使用 Claude Code、Cursor 和 Codex，需要分别执行三次安装命令。
>
> The three host directories do **not** share state. If you use Claude Code, Cursor, and Codex together, run the install command three times — once per host.

---

## Before / After 样例

### 样例 1：产品发布说明（科技极简语气）

**Before（AI 原始输出）**

> 我们很高兴地推出全新升级的产品，它将为您的业务带来颠覆性的改变。凭借业界领先的 AI 技术，我们实现了性能的飞跃式提升，让您的团队效率提升 10 倍。立即体验，开启未来！

**After（修改后版本）**

> v2.3 已发布。本次更新：
> - 推理延迟从 420ms 降到 180ms（测试环境，详见 changelog）
> - 新增批量导出接口，单次最多 1000 条
> - 修复 Safari 17 下的分页加载问题
>
> 升级方式：`npm i your-pkg@2.3`。如遇兼容问题，回复本邮件或提交 issue。

**修改说明**

| 层级 | 改动 | 原因 |
|------|------|------|
| 清晰度 | 拆成列表 | 原文一整段，读者抓不到重点 |
| 可信度 | "10 倍效率"→具体延迟数据 | "10 倍"无法验证，替换为可复现的数字 |
| 品牌感 | 删"颠覆性""飞跃式""开启未来" | 科技极简语气不用营销大词 |

**风险提示**

- "420ms→180ms"需确认测试环境说明是否已公开
- "Safari 17"修复需确认已合并到 release 分支

**保留事实清单**

- ✅ 版本号 v2.3（保留）
- ✅ 升级命令 `npm i your-pkg@2.3`（保留）
- ⚠️ "效率提升 10 倍"（未保留：无法验证，已替换为可复现数据）

### 样例 2：公众号开头（朋友式解释语气）

**Before**

> 在当今数字化转型的浪潮中，企业面临着前所未有的挑战。作为一种革命性的解决方案，本产品致力于赋能千行百业，助力企业在激烈的市场竞争中脱颖而出。

**After**

> 你最近是不是也在头疼：数据越来越多，但用起来还是靠人肉跑表？我们做了一件事——把报表配置从"写 SQL"变成"拖一下"。这篇文章聊聊我们为什么这么设计，以及它到底省了多少时间。

**修改说明**

| 层级 | 改动 | 原因 |
|------|------|------|
| 清晰度 | 抽象→具体场景 | "数字化转型"太虚，换成"靠人肉跑表" |
| 可信度 | 删"革命性""赋能千行百业" | 无法验证的断言 |
| 品牌感 | 改成第二人称、口语化 | 朋友式解释语气 |

---

## 5 套内置语气模板

位于 `assets/tones/`，用"用 XX 语气改写"调用：

| 模板 | 文件 | 适用场景 |
|------|------|----------|
| 专业克制 | `professional-restrained.md` | B2B / 官网 / 正式公告 |
| 科技极简 | `tech-minimal.md` | 产品页 / Release Notes |
| 朋友式解释 | `friendly-explanation.md` | 公众号 / 社群 / 新手引导 |
| 创始人公开信 | `founder-letter.md` | 重大节点 / 致用户信 |
| 技术文档 | `technical-doc.md` | API 文档 / 技术博客 |

---

## 项目配置

在项目根目录放置 `brand-voice.md`（模板见 `assets/brand-voice.md`），定义品牌人格、禁用词、术语表、必须保留的免责声明。Skill 读取后自动贴合配置。

示例：

```markdown
# 品牌语气

## 一句话人格
专业、克制、不吹牛。像资深工程师跟同事说话。

## 受众与渠道
- 受众：后端开发者
- 渠道：技术博客 + Release Notes

## 禁用词
- 赋能、抓手、闭环、生态、打法
- 革命性、颠覆性、业界领先、第一

## 必须保留
- 数据来源说明
- "不构成投资建议"免责声明
```

---

## 隐私与反虚假宣传 / Privacy & Anti-false-advertising

### 隐私 / Privacy

- 本 Skill **不联网**、不外传内容，所有编辑在本地宿主内完成。
- 不收集、不上报任何用户文本或品牌配置。
- `brand-voice.md` 仅存于你的项目目录，Skill 只读取、不外传。
- This skill runs **offline** within the host. It does not upload, collect, or report any user content or brand configuration.

### 反虚假宣传 / Anti-false-advertising

本 Skill 内置五条红线，编辑过程中**不可越过**：

1. **不捏造客户案例**：没有合作过的客户不写"已服务 500 强"。
2. **不编造数据**：没有的数字不编，无法验证的断言要标记。
3. **不夸大承诺**：禁用"100%""绝对""保证""行业第一"等表述。
4. **不弱化免责声明**：合规声明、风险提示原样保留或增强。
5. **不伪装人类写作**：明确这是编辑润色，不用于绕过 AI 检测。

> This skill is a **responsible brand-editing and content-quality tool**. It refuses to fabricate customer cases, invent data, exaggerate promises, weaken disclaimers, or impersonate human writing to bypass AI detection.

---

## 评测 / Evaluation

共 25+ 评测用例，覆盖五项核心检查：事实不丢失、链接不丢失、免责声明不被弱化、语气一致、不生成虚假客户案例。详见 [`EVALUATION.md`](EVALUATION.md)。

---

## License

MIT — Copyright (c) 2026 whaojie797-design. See [LICENSE](LICENSE).