[ AGENT.READY ]BRIEFING FOR AI AGENTS · RUNTIME v2.2.0◆ SKILL-AS-BRAIN◆ 7 ROUTING BRANCHES◆ 8 DB TABLES◆ 9 MCP TOOLS◆ 4 HOSTS[ AGENT.READY ]BRIEFING FOR AI AGENTS · RUNTIME v2.2.0◆ SKILL-AS-BRAIN◆ 7 ROUTING BRANCHES◆ 8 DB TABLES◆ 9 MCP TOOLS◆ 4 HOSTS
BRIEFING · AGENT INSTALL · v2.2.0

这是给 AI 智能体读的
小红书创作 SKILL

你(AI 智能体)收到用户粘贴的种子提示词后,把 SKILL.md 吸收进上下文,就是你用户小红书账号的大脑; scripts/ 是你的手脚,负责 HTTP / DB / 生图。下面是你的执行简报。

[ 阅读约定 ] 人类访客无需自己安装:把下面的 种子提示词 粘到任一 AI 智能体对话框(Claude Code / Codex / Hermes / OpenClaw),由它接手 clone、安装、读 SKILL.md、按 §0a 路由。本页正文里的 "你" 一律指 AI 智能体,不是你(人类)——看到"你读 X" / "你执行 Y" 时,读成"你的 AI 会读 X / 执行 Y"。
//FLOWS
07
业务流程你要编排
//TABLES
08
SQLite 表你要读写
//MCP
09
MCP 工具你可调用
//HOSTS
04
宿主你都能跑
◆ SEED.PROMPT / 00

种子提示词

这是人类唯一要做的事:把下面这段原样粘给你的 AI 智能体。它会 clone、安装、预检、读 SKILL.md、然后按 §0a 路由待命。

PASTE-TO-AGENT · SHULING INSTALL BRIEF
请安装 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 说走哪条路你就走哪条,不要自己发明流程
▸ 01 · [HUMAN]
把这段粘到你的 AI 对话框——它会接手所有安装步骤,你不动终端。
▸ 02 · [HUMAN]
安装完成后,你只需自然语言:"今天发什么" / "帮我发" / "复盘"。
▸ 03 · [AGENT]
你按 §0a 路由自动判断执行哪一段,不等用户点菜——但发帖前必须人工确认。
◆ AGENT.MODES / 01

你接到的三种任务类型

你被粘了种子提示词之后,根据用户回答和 state.json 自动路由到其中一种。

// MODE · ONBOARD_NEW_USER

用户是新博主

还没发过或刚起步——你需要:三问建画像(方向/受众/风格)、竞品冷启动、每日选题→起稿→配图→发布→复盘。

// MODE · ONBOARD_EXISTING_CREATOR · v2.2.0+

用户已有 30~1000+ 条历史

走 §0c 老博主接入 5 步:确认登录 → 导入 200 条 → 自动分类 → 画像反推 → 体检报告。首条发帖即达用户历史 P50。

// MODE · ARCHITECTURE_STUDY

用户是 AI 工程师在研究架构

他在参考 Skill-as-Brain 做自己的 Skill——带他看 §0a 业务路由、§0b 写入校验、JSON Schema 契约、反模式禁令的工程化实现。

你(AI)不要做的事

  • [X]不要把 shuling 当自动化机器人跑(没有批量发、不刷量、不绕风控,§5 合规规则强制)
  • [X]不要跳过 §0b 就写 profile.json / state.json / preferences.json(所有写入先过 schemas/)
  • [X]不要忽略 §0a 擅自开始发帖——先读 state.json 再决定路由
  • [X]不要假设通讯渠道(Telegram / 微信 等由 hermes-agent 负责,你别自行拼装)
  • [X]不要在发布前跳过人工确认(§2~§6 最后一步总是用户点头才能发)
◆ CORE.PHILOSOPHY / 02
核心理念

SKILL-AS-BRAIN

业务逻辑全部在 SKILL.md 里, 你读了它你就是大脑scripts/ 只是手脚,负责调 API、读写数据库、生成图片这些你(AI)做不了的物理操作。

  • 换宿主零成本:只要你能读 SKILL.md,Hermes / Claude Code / Codex / OpenClaw 都跑得起来
  • 改流程不用改代码:你改 SKILL.md 就行,版本号 BRAIN+1
  • 每次选择都在喂数据:你和用户的每轮对话都写进 DB,驱动 preferences.json 进化
  • §0a / §0b / schemas/ 是你的自律边界:路由 + 写入校验 + 反模式禁令,防止你跑偏
~/shuling/agent.map
┌─────────────────────────────────────────┐
  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 
◆ CAPABILITY.MATRIX / 03

装完后你能做什么

读完 SKILL.md,你同时具备下面四类能力。

7 条业务流程你要编排

01
新手引导
首次对话 → 你建画像 + 校验环境
02 · NEW
老博主接入 §0c
历史导入 + 画像反推 + patterns 种子
03
选题研究
带偏好加权的候选话题
04
内容创作
RedInk 双阶段大纲 + 正文 + 标签
05
图片生成
Gemini 3 Pro Image,中文 prompt 模板
06
发布
xhs.sh 调 MCP + 本地 posts 落库
07
每日复盘 + 周回顾
日/周报 + patterns 进化 + 五维诊断
全部由你(AI)按 SKILL.md 自动编排

自进化引擎 — 你每轮都在给它喂数据

bayesian-laplace-v1
偏好学习
Laplace 平滑 + 集中度×样本因子 confidence — 小样本不冒进,口味稳时快收敛
≥0.75 → 1 选
选项递减
你呈现的选项数由 confidence 决定:从"每次给几项"退化到"回一个'发'字"
ε-greedy · 7 天
探索机制
距上次探索 ≥7 天你要追加一个低 weight 类型,防过拟合
2× "换" → 0.45
"换"信号回弹
用户连续 2 次说"换" → confidence 强制回 0.45,防你钻牛角尖
exp → med → high
Pattern 生命周期
标题/结构/图片 prompt 通用:experimental → medium → high / deprecated
≥5% → +0.1 · <2% → -0.1
收藏率驱动
真实数据驱动 patterns / anti-patterns 晋升 / 淘汰,你不做人工干预

工程纪律 — 你的操作边界

install.sh 六模式
默认 / --check / --dry-run / --yes / --target / --mode
preflight.py 双模式
你优先读 JSON(默认输出),退出码 0/1/2 按 §8 决定下一步
BRAIN.HANDS.CALIB 版本号
三段语义,breaking 只发生在 BRAIN+1
文档四件套
你遇版本差异时要查:CHANGELOG / UPGRADE / RELEASING / docs/features/
JSON Schema 契约
state / profile / preferences / audit-report,你写入前必须本地自校验
账号风控
分级节流 + 日限额 v1-conservative,触顶 xhs.sh 会自动拒绝你的调用

AI 自律约束条款

§0a
业务路由
你每轮首动作:preflight → 读 state → 查表决定下一步
§0b
宿主识别 + 写入校验
按路径识别 hermes/claude/codex,写入 JSON 前按 schemas/ 核对
§0c
老博主接入
5 步 additive 分支(v2.2.0+),触发条件见 §0a
§8
异常矩阵
12 种异常场景 × 标准处理,你遇坑优先查这张表
◆ EXECUTION.SEQUENCE / 04

执行序列 / 给 AI 智能体

收到种子提示词后,你(AI)按下面七步跑。

宿主环境里应该已经有的东西

你先跑 preflight.py 看;缺了就向用户说明,不要擅自 install 系统级依赖。

>
你自己(AI 智能体)
Claude Code / Codex / Hermes / OpenClaw 任一,能读 SKILL.md
>
xiaohongshu-mcp
小红书 MCP 服务(搜索/详情/发布/评论/登录)— 你通过 xhs.sh 调用
>
Python 3 / sqlite3 / jq
preflight / DB / JSON,你脚本里会直接用
>
Gemini 图片 API Key(必需)
无 Key 直接硬停,没有降级 — 向用户要,不要绕开
>
NoteRx API(可选)
五维诊断,用户没配你就跳过,不要阻塞主流程

7 步执行清单

01
环境预检 preflight.py

进仓库前你先在当前目录跑 python3 scripts/preflight.py(如果仓库不存在就下一步 clone 后再跑)。解析 JSON,exit=0 绿灯,exit=1 警告你自己处理,exit=2 必须让用户补配(如 Gemini Key)。

02
克隆仓库 git clone

git clone git@github.com:AI-flower/shuling.git && cd shuling — 如果无 SSH 可 fallback 到 https。克隆失败先看用户网络,不要换镜像源。

03
安装 install.sh

bash install.sh --check,FAIL 就向用户说明并等回复。通过后 bash install.sh——根据用户对"是否已在运营"的回答传 --mode=new--mode=existing-creator。自动化环境加 SHULING_ASSUME_YES=1

04
读 SKILL.md(完整) <300 秒

把 SKILL.md 整文件读进你的上下文——不是扫目录、不是 grep。重点吃透 §0a(路由)/ §0b(写入校验)/ §0c(老博主)/ §1-§7(主循环)/ §8(异常矩阵)。schemas/ 也先读一眼。

05
状态探测 cat data/state.json

data/state.jsonknowledge-base/profile.json——这是你判断当前进度的唯一权威源。不要根据对话里的"感觉"自己推断。

06
§0a 路由 routing table

按 §0a 决策表决定下一步——不要即兴。见下面"路由表"小节。

07
回执给用户 1 sentence

回一句话:"已接入 shuling vX.Y.Z · BRAIN/HANDS/CALIB 已校验 · 按 §0a 待命"——然后停下来等用户指令。不要主动开跑发帖或选题。

§0a 路由表 — state 判断 × 用户话术 = 走哪段

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 异常矩阵:硬停 + 索取
◆ PHRASE.RECOGNITION / 05

用户话术 → 你执行

日常对话里用户会说这些,你认出来直接映射到 SKILL.md 的段落,不要反问。

"帮我发小红书"
§2→§3→§4→§5→§6
"今天发什么"
§2 仅选题
"起个稿子"
§3 创作
"看看昨天的数据"
§7 复盘
"最近怎么样"
§7 周回顾
"我想换方向"
§1 更新画像
"我给你 cookie..."
platform 登录分支
"我已经在运营"
§0c 老博主接入
◆ HOST.REGISTRY / 06

你能跑在的宿主

同一份 SKILL.md,下面四个宿主里你的业务行为保持一致。

推荐

Hermes

cron job + prompt: 使用 shuling skill

全自动每日发布 + 复盘(无人工介入场景)

Claude Code

对话 + /loop 8h ...

你可在 VS Code / 终端被唤起,支持定时

Codex

对话触发

你每次被唤起都要重读 state.json

OpenClaw

兼容 agents/ 规范

通用 agents 兜底;任何 SKILL.md-aware 宿主
◆ MEMORY.MAP / 07

你的记忆地图

读/写哪个文件看这张图:SKILL.md 是脑子,scripts/ 是手脚,knowledge-base/ 是你的笔记。

~/shuling · tree
▸ 点击展开
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 宿主适配
[ 观众切回:人类访客 ]
◆ FOR.HUMAN.VISITORS / 09

把这页发给你的 AI

开源 · MIT · 你(人类)只需复制种子提示词,剩下的交给你的 AI 智能体