$git clone https://github.com/snowmays/style-alchemyEnglish | 中文
| 1 | [English](README.en.md) | **中文** |
| 2 | |
| 3 | <p align="center"> |
| 4 | <img src="assets/banner.png" alt="写作风格炼金术 · Style Alchemy" width="100%"> |
| 5 | </p> |
| 6 | |
| 7 | # 写作风格炼金术 · Style Alchemy |
| 8 | |
| 9 |  |
| 10 |  |
| 11 |  |
| 12 |  |
| 13 |  |
| 14 | |
| 15 | > **写作风格炼金术(Style Alchemy)是一个 [Claude Code](https://claude.com/claude-code) skill** —— 把一批文章样本自动炼化成可复用的写作风格档案,并生成一个按该风格写作的专属 Claude skill。 |
| 16 | |
| 17 | 不只是写一段提示词 —— 而是把"风格"沉淀成**可编辑、可迁移、可校验**的结构化资产。 |
| 18 | |
| 19 | 适用于任意中长文样本:博客、公众号、知乎、小红书、Twitter/X、学术期刊、个人散文…… |
| 20 | |
| 21 | ### 输入 / 输出 |
| 22 | |
| 23 | ``` |
| 24 | 输入:5-15+ 篇文章样本(.md / .txt / .html) |
| 25 | |
| 26 | 输出: |
| 27 | 1. <作者>风格分析报告.md 人读的深度报告(标题术、动词库、节奏、语气色板…) |
| 28 | 2. style_profile.yaml 机器读的结构化风格档案 |
| 29 | 3. write-as-<id> Claude skill 一键生成的专属写作助手(可选) |
| 30 | ``` |
| 31 | |
| 32 | --- |
| 33 | |
| 34 | ## 这是什么 |
| 35 | |
| 36 | "风格"是个模糊的词 —— 你能感受到某个作者的文字"对味",却没法直接复用。本 skill 做三件事: |
| 37 | |
| 38 | 1. **拆解** —— 把"风格"拆成 5 个通用维度(标题/开篇/节奏/语言/结尾)+ 若干场景增量维度(公众号/知乎/小红书…),每个维度都用样本原文做例证。 |
| 39 | 2. **固化** —— 把拆解结果浓缩成一份 `style_profile.yaml` 风格档案,机器可读、可编辑、可融合。 |
| 40 | 3. **再造** —— 把档案变成一个独立的 `write-as-<id>` skill,下次你需要按这种文体写作时直接调用。 |
| 41 | |
| 42 | --- |
| 43 | |
| 44 | ## 适用场景 |
| 45 | |
| 46 | - **内容创作者**:研究公开文本的写作特征,沉淀自己的写作工具箱 |
| 47 | - **公众号 / 自媒体团队**:拆解标杆账号的内容结构,建立团队风格规范 |
| 48 | - **法律 / 学术写作**:把某种文体(如判决书摘要、学术摘要、研究综述)固化成可复用的写作助手 |
| 49 | - **企业品牌方**:把 brand voice / tone guideline 编译成可执行的 skill,而不是一份永远没人看的 PDF |
| 50 | - **AI / Agent 开发者**:把"写作风格"作为可移植的资产 —— 一份 yaml 走天下 |
| 51 | - **文体迁移研究**:同一个人在公众号和知乎的写法差异,可以分别建档对比 |
| 52 | |
| 53 | > ⚠️ **使用边界**:本工具用于提炼公开文本的写作特征以辅助创作或研究。生成内容若涉及商业用途、公开发布、或与在世真人/特定品牌产生混淆可能,请自行评估姓名权、商标、反不正当竞争等合规风险。Roadmap 中规划了"相似度检查"功能以辅助去重。 |
| 54 | |
| 55 | --- |
| 56 | |
| 57 | ## Quick Start |
| 58 | |
| 59 | ### 1. 安装 |
| 60 | |
| 61 | 把仓库 clone 到 Claude Code 的 skills 目录: |
| 62 | |
| 63 | ```bash |
| 64 | # Linux / macOS |
| 65 | cd ~/.claude/skills |
| 66 | git clone https://github.com/snowmays/style-alchemy.git |
| 67 | |
| 68 | # Windows (PowerShell) |
| 69 | cd $env:USERPROFILE\.claude\skills |
| 70 | git clone https://github.com/snowmays/style-alchemy.git |
| 71 | ``` |
| 72 | |
| 73 | > 也可以下载 zip 解压到 `~/.claude/skills/style-alchemy/`。 |
| 74 | |
| 75 | ### 2. 准备样本 |
| 76 | |
| 77 | 把目标作者的文章放到任意文件夹(支持 `.md` / `.txt` / `.html`): |
| 78 | |
| 79 | ``` |
| 80 | my_workspace/ |
| 81 | └── raw/ |
| 82 | ├── article1.md |
| 83 | ├── article2.html |
| 84 | ├── article3.txt |
| 85 | └── ... |
| 86 | ``` |
| 87 | |
| 88 | 样本数建议: |
| 89 | |
| 90 | | 样本数 | 能做什么 | |
| 91 | |--------|----------| |
| 92 | | 5-9 篇 | 🟡 风格速写(不建议生成写作 skill) | |
| 93 | | 10-14 篇 | 🟢 标准分析 | |
| 94 | | 15+ 篇 | 🟢🟢 深度分析 + 生成写作 skill | |
| 95 | |
| 96 | ### 3. 启动 skill |
| 97 | |
| 98 | 在 Claude Code 里说人话即可: |
| 99 | |
| 100 | ``` |
| 101 | 分析 ./raw 里这些文章的写作特征,最后帮我生成一个同款文体的写作 skill。 |
| 102 | ``` |
| 103 | |
| 104 | Claude 会先跟你确认参数(路径、作者、平台、交付目标),然后按 9 步工作流执行: |
| 105 | |
| 106 | ``` |
| 107 | [0] 接案确认 → [1] 归一化样本 → [2] 场景识别 → [3] 素材分类 |
| 108 | ↓ |
| 109 | [8] 一键生成写作 skill ← [7] 对比分析 ← [6] 写报告+yaml ← [5] 场景增量维度 ← [4] 通用 5 维 |
| 110 | ``` |
| 111 | |
| 112 | ### 4. 拿到产物 |
| 113 | |
| 114 | ``` |
| 115 | my_workspace/ |
| 116 | ├── raw/ # 你给的原始素材(不动) |
| 117 | ├── samples_normalized/ # 归一化后的统一格式样本 |
| 118 | │ ├── 001-xxx.md |
| 119 | │ └── ... |
| 120 | ├── 量子位风格分析报告.md # 人读的深度报告 |
| 121 | └── style_profile.yaml # 机器读的风格档案 |
| 122 | |
| 123 | ~/.claude/skills/ |
| 124 | └── write-as-qbitai/ # 一键生成的新 skill(可选) |
| 125 | ├── SKILL.md |
| 126 | └── references/style_profile.yaml |
| 127 | ``` |
| 128 | |
| 129 | 之后任何对话里说"按这个风格写一篇关于 X 的文章"(或直接 `@write-as-qbitai`),新 skill 会自动触发。 |
| 130 | |
| 131 | --- |
| 132 | |
| 133 | ## How it works |
| 134 | |
| 135 | ### 整体流程 |
| 136 | |
| 137 | ``` |
| 138 | 原始素材 (md / txt / html) |
| 139 | │ |
| 140 | ▼ |
| 141 | [1] 归一化 ──→ scripts/normalize_samples.py |
| 142 | │ 统一 frontmatter + 极短句保留 + 噪音剔除 |
| 143 | ▼ |
| 144 | [2] 场景识别 |
| 145 | │ 公众号 / 知乎 / 小红书 / Twitter / 博客 / 学术 / 散文 / 其他 |
| 146 | ▼ |
| 147 | [3] 通用 5 维 分析 ──┐ |
| 148 | │ │ 标题术 / 开篇 / 节奏 / 语言 / 结尾 |
| 149 | [4] 场景增量维度 ──┤ |
| 150 | │ │ 平台特有规则 |
| 151 | ▼ ▼ |
| 152 | ┌─────────────────────┐ |
| 153 | │ 双产物 │ |
| 154 | │ ├─ 报告.md (人读) │ |
| 155 | │ └─ profile.yaml │ |
| 156 | └────────┬────────────┘ |
| 157 | │ 可选 |
| 158 | ▼ |
| 159 | [5] 一键生成 write-as-<id> skill |
| 160 | ``` |
| 161 | |
| 162 | ### 为什么要 yaml 中间产物? |
| 163 | |
| 164 | `style_profile.yaml` 是本 skill 的"灵魂"。所有可量化的风格特征(标题公式、动词库、语气色板、口头禅、节奏模式…)都按标准 schema 落到这份 yaml。 |
| 165 | |
| 166 | **好处**: |
| 167 | |
| 168 | - * |