内容创作系统初始化

使用者通常从一个空文件夹开始：先把内容创作要用的软件装齐、把 AI第二大脑/ 的目录建好；之后要用到别的技能，也由本技能装（见「装其他技能」）。缺什么补什么，已有的不动。

安装方法

先问使用者用的是什么 AI 工具，选项按这个顺序列：1. WorkBuddy　2. Claude Code　3. Codex　4. 其他（用户直接说工具名），回答记作 X
只安装给 X，不安装或链接其他任何工具：
- X 是 WorkBuddy：把本技能下载后放进 ~/.workbuddy/skills/（WorkBuddy 的技能目录；skills CLI 不支持 WorkBuddy，由你直接放置）
- X 是其他工具：
```
npx -y --registry=https://registry.npmmirror.com skills add https://modelscope.cn/skills/sunny31221/content-system-init-buheliwa -a X -y
```
  （不带 -a 会安装给本机所有检测到的工具，禁止；--registry 为 npmmirror 镜像，保证国内不翻墙也能拉到 CLI）
- X 不在上述范围时，按该工具自身的技能机制安装，装完确认 X 能识别本技能即可
装完后询问是否现在使用本技能

核心原则

名字即约定——各环节按固定路径读写，文件夹先建对，后面每一步的内容才落得进去。目录名不改；编号只管排序（统一 NN_ 两位、每层从 01 起），各技能引用一律不带编号、按文件夹名匹配实际目录（忽略数字前缀），编号调整不影响任何引用。

只补不覆盖——脚本幂等，跑多少次结果都一样；已有的一律不碰，不清空、不覆盖。

触发场景

"初始化内容系统" / "搭建工作区" / "建好文件夹" / "初始化文件夹结构"
"我的文件夹不全" / "采集的时候提示缺文件夹"
"缺什么软件" / "环境检查" / "装不上 XX"
"帮我安装 XX 技能" / "装 XX 技能"（后续环节的安装指令统一走这里）
AI 主动发起：其他技能运行时报缺依赖（如采集提示缺 yt-dlp、转写提示缺 mlx-whisper）时，AI 检测到就主动问「缺 X，要现在装吗」，不用使用者先开口
第一次使用前装好技能，准备开始做内容

不适用

补一两个文件 → 直接建，不用跑脚本
目录已经完整 → 脚本会自己识别，不会重复建
只是某个技能报错要排查 → 先跑环境检查定位，不要重建目录

工作流

第 1 步：检查环境

python3 "<技能目录>/scripts/check_env.py"

逐项报「装了没有 / 缺什么 / 怎么装」。有缺的，问使用者要不要一并装上，同意就跑：

python3 "<技能目录>/scripts/check_env.py" --install

脚本按「国际源 → 清华镜像 → 阿里云镜像」的顺序试，一条失败不影响下一条；装不上的先跳过，不影响其他环节。装完再查一遍。

其中 opencli 有个例外：命令行能自动装，Chrome 扩展的最后一步要使用者手动点（Chrome 从 137 版起不让脚本代劳）。--install 遇到它会自动转到 install_opencli.py，脚本把下载、解压做完，再把 Chrome 里那几步打出来。照念给使用者即可，别自己改写步骤。

依赖清单、各环节的降级办法、以及「命令行能跑但脚本报 ModuleNotFoundError」这类解释器错位问题，见 references/environment.md。

运行期：其他技能跑着跑着报缺依赖（例：采集提示缺 yt-dlp、转写提示缺 mlx-whisper）时，AI 主动告诉使用者「缺 X，要现在装吗」——同意就跑上文的 --install，装完回到原技能继续；跳过也照常继续，不阻塞。

第 2 步：建目录

python3 "<技能目录>/scripts/setup_folders.py"

| 用法 | 结果 | |------|------| | 不给参数 | 在当前目录下建 AI第二大脑/，已存在则补齐 | | --root <路径> | 指定 AI第二大脑 目录；不存在则创建 | | --dry-run | 只列出会建什么，不落盘 |

脚本做四件事：建出全部文件夹 → 给每个目录写一份 README（说明这个目录装什么、怎么用）→ 建好 7 个入口文档（采集链接清单、归档 CSV、两份卡片索引、选题池、热点网站、校对记录）+ 7 个预建文件（对标账号链接、定位空壳五项，带「⚠️ 待填写」标记，由定位访谈填写后删标记；写作风格空壳，带「⚠️ 待训练」标记，由第 4 关风格训练填好后删标记）→ 在项目根目录（与 AI第二大脑/ 平级）建一份 .env.local，把公众号发布密钥、小红书账号名这几项先注释着列好（已有这个文件时不动它）。

跑完会打印新建了哪些；结构本来就完整时打印「结构完整，未做任何改动」。

第 3 步：汇报

告诉使用者建在哪里、新建了什么、环境里还缺哪些是可选项。首次搭建时提醒一句：目录建好只是空壳，接着从 个人背景/ 开始填。

第 4 步：后续环节

目录就位后按顺序走：定位（填个人背景）→ 采集对标内容 → 提炼规律 → 生成选题 → 写作 → 配图、排版、发布 → 数据复盘。

装其他技能（统一安装器）

后续环节的「帮我安装 XX 技能」都由本技能执行——装单个技能（单技能 URL），绝不装合集（合集不带 -s 会一次装进全部技能，违背按需装技能）。

默认装给当前正在用的工具（本技能就在那个工具里运行，认得出）；拿不准当前工具时才问，四选：

| 工具 | 标识 | 装到哪 | |---|---|---| | WorkBuddy | 手工放置 | ~/.workbuddy/skills/（skills CLI 不支持 WorkBuddy，把技能包直接放进去） | | Claude Code | claude-code | .claude/skills/（项目级） | | CodeX | codex | .agents/skills/（项目级） | | 其他 | universal | .agents/skills/（universal 目录，多工具自动识别） |

命令（除 WorkBuddy 外）：

npx -y --registry=https://registry.npmmirror.com skills add <单技能 URL> -a <标识> -y

装完一句话告知：装到了哪个工具、技能名、怎么触发；接下来怎么用，听该关教程的指引。

装完让使用者填 `.env.local`

有两个技能靠项目根 .env.local 里的值工作。刚装的要是它们，装完紧接着用编辑器打开这份文件，让使用者把对应的行填上：

| 刚装的技能 | 让使用者填 | |---|---| | wechat-publisher-buheliwa | weChat_bloom_key（必填）；weChat_bloom_AppID 可选，想固定推给某个号时才填 | | review-buheliwa | XHS_CREATOR_ACCOUNT，填他自己的小红书账号名 |

文件由第 2 步建好，通常在；不在就先跑一次第 2 步的脚本补建（它不动已有文件），或自己建一份。打开方式：

open -t <项目根>/.env.local        # macOS，系统默认文本编辑器
notepad "<项目根>\.env.local"      # Windows

文件里每一项都先注释着，填的时候把那一行开头的 # 去掉、值写在等号后面。跟使用者说填完讲一声，再往下走。

打开是给人编辑的：AI 不要读文件内容、不要贴进对话。 这份文件里可能已经存着别的密钥。

按环节批量装（使用者说「装 XX 环节的技能」时）

skills add 一条命令只接受一个技能——批量装 = 依次跑多条单技能命令（实测 9 条 38 秒）。不走合集：合集会把后面几关才用的技能一起装进来，违背按需装技能。

| 环节 | 依次装这些（单技能 URL 换名字即可） | |---|---| | 采集 | collect-orchestrator-buheliwa · xiaohongshu-collect-buheliwa · crawl-wechat-buheliwa · youtube-collect-buheliwa · channels-collect-buheliwa · account-collect-buheliwa · pattern-extractor-buheliwa · thought-card-buheliwa · topic-generator-buheliwa | | 写作 | content-writer-buheliwa · writing-style-buheliwa · article-style-checker-buheliwa · html-content-images-buheliwa · gzh-layout-buheliwa · wechat-publisher-buheliwa · data-cleaning-buheliwa（7 个） |

做法：

把清单念给使用者听，确认要装这一批
先看哪些已经装过（列一下当前工具的技能目录，已在的不重复装，只装缺的）
逐条跑安装命令，装完一条报一条技能名
某条失败就跳过继续，不阻塞其余；最后汇总「装上了哪些、哪几条本来就装着、哪几条没装上、失败原因」
全装完告知：都在哪个目录、这一关先触发哪个技能；这批里含 wechat-publisher-buheliwa 或 review-buheliwa 时，按上面「装完让使用者填 .env.local」做一次

初始化技能本身不用再装（正在用它就说明已经有了）。

目录结构速览

AI第二大脑/
├── 01_个人背景/            定位、账号形象、真实经历卡片
│   ├── 01_背景卡片/
│   └── 02_对外简介/
├── 02_规律研究/            研究别人怎么做内容
│   ├── 01_对标账号/
│   ├── 02_对标内容采集/    四个平台各一个子文件夹 + 采集链接清单
│   └── 03_内容规律/        四个平台各一个子夹，各按四类规律卡片分（开头 / 标题 / 正文结构 / 封面）
├── 03_知识库/              自己的沉淀
│   ├── 01_思想卡片/        作者的观点，一张卡一个观点
│   ├── 02_沟通录音/
│   └── 03_知识卡片/       四类预设：概念 / 工具 / 原理 / 方法（用户可按领域重分类）
├── 04_选题池/              选题总表（上方待写候选、最下方已创作选题）+ 热点网站
├── 05_作品仓库/            每篇内容一个编号文件夹（01_母稿 / 02_公众号 / 03_小红书 / 04_视频脚本）
├── 06_数据复盘/            单条复盘（01_单条复盘/）+ 总复盘（02_总复盘/）+ 原始取数（03_原始取数/）+ 复盘索引
├── 07_视觉与排版/          图片库（含头像）、排版模板
├── 08_我的记忆/            写作偏好与风格档案、改稿记忆、修改痕迹
└── 09_AI员工/              第 6 关做出来的 AI 员工：一个任务一个文件夹（工作流 + 两张流程图 + 岗位卡）

编号规约：所有子文件夹统一 NN_ 两位编号、每层从 01 起（同级只有一个子夹时不编号），编号只管排序、可随时调整；各技能引用路径一律不带编号，按文件夹名匹配实际目录（忽略数字前缀）。

每个目录装什么、各环节怎么读写，见 references/directory-guide.md。

常见问题

| 情况 | 处理 | |------|------| | 工作目录里已有自己建的同名文件 | 脚本跳过不覆盖；确认要重写时先手动备份再删 | | 报「找不到 AI第二大脑目录」 | 脚本会自动在当前目录下新建；想建到别处用 --root <路径> | | 想把目录名改短一点 | 不要改。各环节按固定目录名读写，改名后内容会落不进去 | | 目录建好了但内容是空的 | 正常。先填个人背景，其余目录随使用逐步积累 | | 软件装了但脚本报 ModuleNotFoundError | 包装到了另一个 Python 解释器下，用 python3 -m pip install 重装（见 environment.md） | | 某个依赖死活装不上 | 跳过，不影响其他环节；各环节自己写了降级办法（见 environment.md） |

不做什么

不采集内容、不写文章、不做选题——只把目录、入口文档、环境准备好
不覆盖已有文件——两个脚本都幂等，已有的一律不动、不清空
不装合集——装技能只装点名的那个（见铁律 5）

Resources

references/environment.md — 依赖清单、各环节装法（国际源 + 国内镜像）、装不上时的降级办法
references/directory-guide.md — 完整目录结构与每个目录的用途、各环节读写对应
references/file-contract.md — 文件接口清单：跨技能读写的文件谁写谁读、名字约定（改名前先查这张表）
scripts/check_env.py — 环境检查与安装（支持 --install / --json）
scripts/install_opencli.py — 装 opencli 命令行 + Chrome 扩展（扩展走国内镜像自动下载解压，Chrome 里加载那一步打印给使用者）
scripts/setup_folders.py — 建目录脚本（幂等，支持 --dry-run）

内容创作系统初始化

内容创作系统初始化

安装方法

核心原则

触发场景

不适用

工作流

第 1 步：检查环境

第 2 步：建目录

第 3 步：汇报

第 4 步：后续环节

装其他技能（统一安装器）

装完让使用者填 .env.local

按环节批量装（使用者说「装 XX 环节的技能」时）

目录结构速览

常见问题

不做什么

Resources

装完让使用者填 `.env.local`