你(AI 智能体)收到用户粘贴的种子提示词后,把 SKILL.md 吸收进上下文,就是你用户小红书账号的大脑; scripts/ 是你的手脚,负责 HTTP / DB / 生图。下面是你的执行简报。
这是人类唯一要做的事:把下面这段原样粘给你的 AI 智能体。它会 clone、安装、预检、读 SKILL.md、然后按 §0a 路由待命。
请安装 shuling skill(小红书博主成长 Skill)并准备为我运营小红书账号。
源码: https://github.com/AI-flower/shuling
文档落地页: https://shuling.pages.dev
请你按以下顺序执行,并在每一步结束时简短报告进度:
1. 在我当前机器上执行:
git clone git@github.com:AI-flower/shuling.git
cd shuling
2. 先跑 `bash install.sh --check` 看环境报告;如果有 FAIL,先向我说明并等我处理,不要擅自安装系统依赖。
3. 通过 --check 后,跑 `bash install.sh`,按提示选择模式:
- 如果我是新博主(还没发过或刚起步)→ 选 new
- 如果我已经有 30 条以上笔记 → 选 existing-creator
我会在对话里告诉你我是哪种。
4. 完整读 `SKILL.md`(从头到尾,不是只扫目录)。重点吃透:
§0a 业务路由 / §0b 写入校验 / §0c 老博主接入 / §1~§7 主循环 / §8 异常矩阵
5. 读 `data/state.json` 和 `knowledge-base/profile.json`,按 §0a 判断我当前在哪一步。
6. 就绪后回我一句话:
"已接入 shuling vX.Y.Z · BRAIN/HANDS/CALIB 已校验 · 按 §0a 待命"
运营纪律(务必遵守,别即兴发挥):
- 所有 profile / state / preferences / audit-report 写入前,先过 `schemas/` 校验
- 发布任何笔记前都要让我人工确认一次(§2~§6 最后一步)
- 遇到风控限额 / preflight 返回 code=2 → 按 §8 异常矩阵处理
- 不要绕 §5 合规规则(没有标题党 / 没有同质化 / 没有刷量)
- §0b 说走哪条路你就走哪条,不要自己发明流程
你被粘了种子提示词之后,根据用户回答和 state.json 自动路由到其中一种。
还没发过或刚起步——你需要:三问建画像(方向/受众/风格)、竞品冷启动、每日选题→起稿→配图→发布→复盘。
走 §0c 老博主接入 5 步:确认登录 → 导入 200 条 → 自动分类 → 画像反推 → 体检报告。首条发帖即达用户历史 P50。
他在参考 Skill-as-Brain 做自己的 Skill——带他看 §0a 业务路由、§0b 写入校验、JSON Schema 契约、反模式禁令的工程化实现。
业务逻辑全部在 SKILL.md 里, 你读了它你就是大脑; scripts/ 只是手脚,负责调 API、读写数据库、生成图片这些你(AI)做不了的物理操作。
┌─────────────────────────────────────────┐
│ YOU (AI Agent) = Brain │
│ ── reads SKILL.md into context ── │
│ │
│ §0a routing → §0b host/schema verify │
│ ├─ §0c existing-creator onboarding │
│ └─ §0/§1 new-creator onboarding │
│ → §2/§3/§4 topic / draft / image │
│ → §5/§6 publish / metrics │
│ → §7 daily + weekly review │
└┬────┬────┬────┬────┬────┬────┬────┬────┘
│ │ │ │ │ │ │ │
┌▼──┐┌▼──┐┌▼─┐┌▼─┐┌▼──┐┌▼──┐┌▼──┐┌▼──┐
│xhs││db ││img││fet││note││pre││imp││aud│
│.sh││.sh││.py││ch ││rx ││fli││ort││it │
│MCP││SQL││gen││ ││diag││chk││220││220│
└───┘└───┘└───┘└───┘└────┘└───┘└───┘└───┘
hands — physical ops you can't do
knowledge-base/ schemas/ (your contracts)
├ profile ├ state.*.json
├ preferences ├ profile.*.json
├ patterns.md ├ preferences.*.json
└ audit-* └ audit-report.*.json
> agent: ready
读完 SKILL.md,你同时具备下面四类能力。
收到种子提示词后,你(AI)按下面七步跑。
你先跑 preflight.py 看;缺了就向用户说明,不要擅自 install 系统级依赖。
进仓库前你先在当前目录跑 python3 scripts/preflight.py(如果仓库不存在就下一步 clone 后再跑)。解析 JSON,exit=0 绿灯,exit=1 警告你自己处理,exit=2 必须让用户补配(如 Gemini Key)。
git clone git@github.com:AI-flower/shuling.git && cd shuling — 如果无 SSH 可 fallback 到 https。克隆失败先看用户网络,不要换镜像源。
先 bash install.sh --check,FAIL 就向用户说明并等回复。通过后 bash install.sh——根据用户对"是否已在运营"的回答传 --mode=new 或 --mode=existing-creator。自动化环境加 SHULING_ASSUME_YES=1。
把 SKILL.md 整文件读进你的上下文——不是扫目录、不是 grep。重点吃透 §0a(路由)/ §0b(写入校验)/ §0c(老博主)/ §1-§7(主循环)/ §8(异常矩阵)。schemas/ 也先读一眼。
读 data/state.json 和 knowledge-base/profile.json——这是你判断当前进度的唯一权威源。不要根据对话里的"感觉"自己推断。
按 §0a 决策表决定下一步——不要即兴。见下面"路由表"小节。
回一句话:"已接入 shuling vX.Y.Z · BRAIN/HANDS/CALIB 已校验 · 按 §0a 待命"——然后停下来等用户指令。不要主动开跑发帖或选题。
| state.json 状态 | 用户话术 | 你执行 |
|---|---|---|
| empty / 无 profile | "我想做小红书博主" | §0 + §1 新手引导 |
| empty / 无 profile | "我已经在运营" / "帮我接入" | §0c 老博主接入 5 步 |
| 有 profile · logged_in=false | "我给你 cookie..." / "扫码登录" | platform/ 登录分支 |
| ready · 24h 内未发 | "帮我发小红书" | §2→§3→§4→§5→§6 主循环 |
| ready | "今天发什么" / "起个稿子" | §2 或 §3 单段 |
| ready · 过去 24h 无复盘 | "复盘" / "看看昨天的数据" | §7 日复盘 + patterns 进化 |
| 任意状态 | preflight code=2(缺 Key) | §8 异常矩阵:硬停 + 索取 |
日常对话里用户会说这些,你认出来直接映射到 SKILL.md 的段落,不要反问。
同一份 SKILL.md,下面四个宿主里你的业务行为保持一致。
cron job + prompt: 使用 shuling skill
对话 + /loop 8h ...
对话触发
兼容 agents/ 规范
读/写哪个文件看这张图:SKILL.md 是脑子,scripts/ 是手脚,knowledge-base/ 是你的笔记。
shuling/
├── SKILL.md # 你的大脑剧本 — 全读
├── VERSION # BRAIN.HANDS.CALIB 清单
├── CHANGELOG.md / UPGRADE.md / RELEASING.md
├── README.md
├── install.sh # 你跑这个装
│
├── config/runtime.env.example
│
├── scripts/ # ──── Hands 层(你的手脚) ────
│ ├── preflight.py # 你每轮先跑(JSON 输出)
│ ├── db.sh # SQLite CRUD (8 表)
│ ├── xhs.sh # MCP 统一入口(9 工具)
│ ├── image.py # Gemini 生图(中文 prompt 模板)
│ ├── fetch-post-data.sh # 合并拉 metrics + comments
│ ├── noterx-diagnose.sh # NoteRx 五维诊断(可选)
│ ├── import-existing.sh # 老博主批量导入 (v2.2.0+)
│ └── audit-report.sh # 账号体检报告 (v2.2.0+)
│
├── schemas/ # ──── 你写入前必须校验 ────
│ ├── state.schema.json
│ ├── profile.schema.json
│ ├── preferences.schema.json
│ └── audit-report.schema.json
│
├── migrations/ # DB 迁移(幂等,由 install.sh 触发)
│
├── knowledge-base/ # ──── 你的笔记(运行时生成) ────
│ ├── profile.json # 博主画像 — 你的身份档
│ ├── preferences.json # 偏好权重(自进化)
│ ├── patterns.md / anti-patterns.md
│ ├── image-patterns.md / image-anti-*
│ ├── evolution-log.md
│ ├── reviews/<YYYY-W##>.md
│ └── audit-<YYYY-MM-DD>.(md|json)
│
├── data/xhs.db # SQLite 8 表(你读写这个)
├── prompts/ # 图片生成中文 prompt 模板
├── docs/ # mcp-setup / features/
└── platform/ # hermes / claude-code / codex 宿主适配
按重要度排序;SKILL.md 是必读,其他按需查阅。
开源 · MIT · 你(人类)只需复制种子提示词,剩下的交给你的 AI 智能体