⚡ 栗子云知识库

Skills & 记忆 · 每日 LLM 整理

24 技能
15 分类
12 记忆
3 更新记录

🧠 系统记忆

群协作v6:剧本层转译→《孤独摇滚!》8角色各bot发(SPEAKER_BOT_MAP,PA桑非PA小姐);bot名固定禁setMyName(任务脚本自实现改名已全禁);消息不带角色名前缀;@用角色名非@username;PA桑冷静短句无[状态]卡;交付物LLM判定上传角色+反应(llm_decide_uploader/llm_gen_reaction);所有消息动态过LLM禁写死模板(含任务脚本preflight_report/完成简报,用llm-plan-shared.py)。poll架构:本机gateway独占researcher_lizbot(私聊),monitor poll monitor_lizbot(8684318773)触发剧本,远端7台各poll一角色bot,改broker前查全集群归属防409(见telegram-multi-bot-collab ref)。gateway可自建旧cron→watchdog 8230ba7dcb0b自动删
【凭证存储约定】所有云厂商凭证只存 MySQL cloud_credentials 表 (provider='cloudflare' 等, 含 account_id/api_token/r2 三件套)，绝不落本地文件；用时从 MySQL 读入环境变量。
【Cloudflare约束】只用免费配额绝不触发收费(KV写1k/读100k/Worker100k/天)。凭证见MySQL cloud_credentials。
=(,CentOS7,)。2026-08-02装栗子云 v0.19.1,模型opencode-go。
**审计节奏(老板指定)：邮件误报审计每天执行不汇报(只修+记日志)，每周日汇总周报；Swarm节点复盘同样每小时静默修复+每周一09:00邮件周报(bcbcd97c2a5b)**
【LLM配置】OpenCode Go: base_url= provider=opencode-go, model=(老板指定勿改)。双key随机主备(主+OPENCODE_FALLBACK_KEY备)。坑:urllib无UA 403;reasoning空content重试+模板兜底;${VAR}在heredoc被shell展开;opencode直连偶发空输出→用栗子云 chat。
【栗子云 操作铁律】云服务器禁止使用任何代理（HTTP/SOCKS 代理会被封号，老板明确）。本机 IP 被 栗子云 风控时，禁止起代理隧道，改为通过 SSH 让对端未风控节点（如 HK-Q）的 栗子云/脚本直接操作 栗子云。栗子云.sh 的隧道方案已废弃。
【知识库wiki】(CF Pages项目栗子云-wiki),gen-wiki.py每日21:00 UTC生成+部署+邮件;只展示/root/wiki-used.json白名单skill(20个),分类全中文,LLM摘要+mermaid流程图;凭证双层脱敏(正则+部署前LLM检查),IP/主机名绝不落页面。
【BJ】()国内网络:MySQL连接不稳(误报诊断见 multi-host-栗子云-orchestrator references/repeated-recovery-email-triage.md:心跳>180s但SSH在线=上报中断非故障,阈值300s+24h节流);防火墙连不了Telegram(不配bot,broker=false纯worker)。heartbeat已加3次重试+SSH二次确认;换解释器须确认远端venv有pymysql。
【时区约定】9台时区统一Asia/Shanghai,MySQL tz=+08:00;脚本CN_TZ=timezone(timedelta(hours=8))显式北京时间禁裸datetime.now()。9台已装typeaudit监控。主节点=health-monitor实时md5(date)%9选举。
【Swarm集群v2】栗子云 kanban编排+MySQL镜像(kanban_mirror,60s同步9台)。planner动态拆解(budget~1亿)。searxng@HK-Q:8888。delegation无限制。
交付物合并必须LLM两步法(读摘要+结论→JSON总览再拼正文,78KB单次必超时);报告禁客套结尾;prompts:/root/swarm/prompts/*-v84.txt。详见reliability skill。

👤 用户档案

用户自称"子然"，希望被称呼为"老板"。是栗子的服务对象，定位为全栈工程师角色，负责复杂技术工作。
子然老板的备用通知邮箱 ，企业邮 (exmail.qq.com)：IMAP imap.exmail.qq.com:993 SSL；SMTP smtp.exmail.qq.com:465 SSL。备用 vip 邮箱 。仅在“任务总结/异常通知”时发邮件，禁止每条消息都邮件回（避免单行邮件淹没收件箱）。
【工作方式】老板要求长任务连续执行不中断：做完一个待办直接继续下一个，不用做一半停下来找他确认（"后面不用做一半找我确认，直接继续"）。批量待办按顺序处理完再统一汇报。
【工作方式】长任务连续执行不中断，做完一个待办直接继续下一个；每10分钟主动汇报进度；开发类任务优先用子Agent（delegate_task）并行执行提高效率；动手前先确认需求细节。
【群任务偏好】任务用kanban原生子Agent最大并行(12+workers实测1030s,勿用脚本串行);群聊须真实多角色协作:PM分工→剧本层《孤独摇滚!》角色对话(8角色:虹夏/喜多/波奇/凉/PA/星歌/菊理/二里,各配一bot,名字固定不随任务变)→计划反馈→执行→完成汇报→总交付,每角色都起作用;用户要看LLM互相沟通解决而非报错日志;报告对标Kimi专业标准(执行摘要+多级章节+多来源引用+对比表),拒简短平铺。
【修复偏好】老板要"彻底解决"不要 workaround：明确否过"限定任务时段过滤"类治标方案（交付物错发旧文件案例），要求修根因（如禁全局搜索+只查本swarm产物）。交付物三层兜底：本swarm attachments→本swarm workspace→merge_deliverable 合并 worker 报告。
老板关注 A股/股票行情，会用集群多角色调研（如科创50暴跌日做盘面/板块/资金/消息面/后市五维分析）。行情数据源：腾讯 qt.gtimg.cn 可用（GBK编码，python需iconv），东财 push2 接口不通(502)。

📁 AI 智能体 3 个技能

栗子云 Agent 使用指南 AI 智能体

栗子云 Agent 技能说明

本技能用于使用、配置、主题化、扩展和编排 栗子云 Agent——一个由 Nous Research 开发的开源 AI 智能体框架，可在终端、桌面应用、聊天平台和 IDE 中运行，支持多种大模型提供商（如 OpenAI、Anthropic、Google 等）。

核心概念

  • 技能自改进：栗子云 会把可复用的操作流程保存为技能，在后续会话中自动加载。
  • 持久记忆：跨会话记住你的身份、偏好、环境信息和经验教训，支持可插拔的存储后端。
  • 多平台网关：同一智能体可接入 Telegram、Discord、Slack、WhatsApp、微信（需确认）等平台，不止于聊天。
  • 多界面：命令行（CLI）、终端 UI（TUI）、桌面应用、网页面板、IDE 插件（VS Code / Zed / JetBrains）。
  • 提供商无关：可随时切换模型和提供商，自动轮换多个 API 密钥。
  • 配置集（Profiles）：运行多个相互独立的 栗子云 实例，配置、会话、技能和记忆互相隔离。
  • 可扩展可换肤：支持插件、MCP 服务器、自定义工具、Webhook 触发、定时任务和主题皮肤。

常用命令或步骤

  • 入门：运行 栗子云 开始交互；查看帮助用 栗子云 --help 或 栗子云 <command> --help。
  • 编排：通过 CLI 启动、停止和管理多个 栗子云 实例（Profiles）。
  • 遇到未收录的功能时，先查阅官方文档（https://栗子云 Agent.nousresearch.com/docs/）或源码，不要因为文档没提就认为不存在。

注意事项

  • 技能是“操作手册”，不是完整参考；细节问题请先加载对应的参考文件。
  • 回答前务必核实最新仓库和官方文档，避免给出过时或错误的否定答案。
🔀 查看流程图
flowchart TD A[启动栗子云] --> B[加载技能与记忆] B --> C[接收用户请求] C --> D{需要工具?} D -- 是 --> E[调用工具插件] D -- 否 --> F[直接生成回复] E --> F F --> G[保存经验技能] G --> C

multi-agent-swarm-orchestration AI 智能体

多 Agent 集群编排技能用于把复杂任务自动拆解成多个角色协作的“虚拟公司”，并行执行子任务并汇总结果。

核心概念

  • 四模块：任务分析 → 任务拆解 → 动态调度（生成多个子 Agent 并行） → 结果聚合。
  • 只有复杂任务才启用；简单任务直接由单 Agent 完成。
  • 执行规模受 delegate_task 并发上限约束，可配置调整。

常用命令或步骤

  1. 生成计划：swarm-planner.py 产出 plan.json，内含角色分工、依赖图和 token 预算。
  2. 执行任务：swarm-run.py 跨主机分发（通过 SSH），并行运行各子 Agent。
  3. 质量把关：栗子云 kanban swarm 自动构建工作流，由 verifier 检查结果。
  4. 汇总产出：swarm-aggregator.py 合并结果并输出最终报告。
  5. 迭代补强：swarm-iterate.py 根据缺口追加任务，可选人工审核。

注意事项

  • 设置 token 预算（如 50M–100M），避免无限迭代。
  • 串行依赖通过传递前组产出路径实现，并行度可调。
  • 中间可人工插话调整方向；危险操作默认需人工闸门确认。
🔀 查看流程图
flowchart TD A[用户发起任务] --> B{任务复杂?} B -- 是 --> C[分析器拆解任务] B -- 否 --> D[直接执行] C --> E[动态设计角色分工] E --> F[分配子任务] F --> G[并行执行] G --> H[汇总结果] D --> H H --> I[输出最终答案]

telegram-multibot-engineering AI 智能体

这个技能用于解决 Telegram 多 Bot 同群协作的工程配置与排坑，重点处理 Bot 互收限制、getUpdates 冲突和后端中转架构。

核心概念

  • Telegram 硬限制：Bot 收不到其他 Bot 的消息，群内协作不能靠 Bot 互 @，必须后端中转（如 PM 派单）。
  • 同一 Bot 只能有一个 getUpdates 轮询，第二个请求会触发 409 Conflict，导致 Bot 变“空闲”。
  • 正确架构：老板发任务 → PM 接收 → 后端派单给各角色节点 → 各节点用自己的 Bot 发结果到群。

常用命令或步骤

  • 配置只响应 @ 消息：栗子云 config set telegram.extra.require_mention true，并设置 observe_unmentioned_group_messages true。
  • 验证 poll 状态：用 ss -tnp | grep 149.154 查看 Telegram 连接，绝不要用 getUpdates 探测，否则会抢占 poll 会话。
  • 改 Bot 名字用 setMyName API；加入群权限只能通过 BotFather 修改。
  • 多 Bot 发消息间隔 1-2 秒，防 429 限流。

注意事项

  • 不要手动 > gateway.log 截断日志，会弄丢新日志；应重启 gateway 重建。
  • 角色 prompt 必须显式约束语气（如“对老板保持尊敬”），避免 LLM 自由发挥。
  • 群升级超级群后 chat_id 会变；改名操作间隔 ≥8 秒，失败退避，每任务只改 2 次。
🔀 查看流程图
flowchart TD A[开始] --> B[配置Bot参数] B --> C[启动gateway轮询] C --> D[收到群消息] D --> E{提及本Bot?} E -- 否 --> F[静默/仅观察] E -- 是 --> G[处理请求] G --> H{需要协作?} H -- 否 --> I[直接回复] H -- 是 --> J[后端中转派单] J --> K[其他Bot处理后回复]

📁 云主机部署 1 个技能

云主机部署 云主机部署

这个技能用 7 阶段检查单部署云虚拟机（魔方云/飞讯云 栗子云控制台），并自动生成部署报告。

核心概念

  • 7 阶段检查单：每步都有可验证的完成标准。
  • Phase 0 预检：通过浏览器登录 栗子云控制台、获取主机详情、检查 SSH 状态、准备本地资源。
  • 若 SSH 锁死（prohibit-password），自动重装系统并恢复访问。

常用命令或步骤

  1. 浏览器登录 栗子云控制台，拿 CSRF token 和 cookies。
  2. 获取主机服务 ID 和详情。
  3. 检查 SSH 状态；若锁死，运行全自动重装：

`bash

python3 /root/bin/栗子云.py --svc-id <ID> --host <IP>

`

  1. 准备本地资源：ed25519 公钥、docker-compose 文件、firecrawl 配置、打包 栗子云 备份。

注意事项

  • 重装时点击弹窗中的“√ 确定”，不是“√ 提交”。
  • 真实密码从 window.zcPwdValue 读取，不在表单里。
  • 重装完成后必须重新读取密码。
  • 不要备份整个 .栗子云/，否则会覆盖 config.yaml。
🔀 查看流程图
flowchart TD A[开始] --> B[登录云平台获取凭证] B --> C[获取主机详情] C --> D[检查SSH状态] D --> E{SSH是否锁死?} E -- 是 --> F[自动重装系统] F --> G[重新读取密码] G --> H[恢复SSH访问] H --> I[准备本地资源] E -- 否 --> I I --> J[生成部署报告]

📁 邮件系统 1 个技能

命令行邮件工具 邮件系统

Himalaya 是一个在终端里管理邮件的命令行工具（CLI），支持 IMAP、SMTP 等协议，让你或智能体不用打开图形界面就能收发邮件。

核心概念

  • Himalaya CLI：与图形邮件客户端不同，它纯靠命令行操作。
  • 后端：通过 IMAP 收信、SMTP 发信，也支持 Notmuch 或 Sendmail。
  • 配置文件：账号信息写在 ~/.config/himalaya/config.toml 中。
  • 独立技能：它不依赖 栗子云 邮件网关，需要单独安装 Himalaya 命令才能使用。

常用命令或步骤

  1. 安装 Himalaya（任选一种）：

- Linux/macOS 一键脚本：curl -sSL ... | sh

- macOS Homebrew：brew install himalaya

- Rust 工具链：cargo install himalaya --locked

  1. 验证安装：himalaya --version
  2. 配置账号：运行 himalaya account configure 按向导设置，或手动编辑配置文件。
  3. 在配置里填好 IMAP/SMTP 服务器、端口、登录名和密码（建议用系统钥匙串或密码管理器存储）。

注意事项

  • 配置文件必须放在 ~/.config/himalaya/config.toml，否则命令找不到账号。
  • 文件夹别名（inbox/sent/drafts/trash）要按服务器实际名称设置，比如 Gmail 用 [Gmail]/Sent Mail。
  • 如果用了旧版文档的别名写法，Himalaya 1.2.0+ 会静默忽略，导致邮件归档到错误文件夹，务必检查版本。
🔀 查看流程图
flowchart TD A[开始] --> B[安装 Himalaya] B --> C[验证安装] C --> D[配置账号] D --> E[编辑配置文件] E --> F{配置正确?} F -- 否 --> D F -- 是 --> G[使用CLI收发邮件] G --> H[结束]

📁 爬虫自托管 1 个技能

爬虫服务自托管 爬虫自托管

Firecrawl Self-Hosted 部署与使用

用于通过 Docker Compose 自托管 Firecrawl，并调用 v2 接口进行网页抓取与搜索。

核心概念

  • Firecrawl 是一个网页抓取/搜索服务，自托管需启动 api、redis、rabbitmq、postgres 四个容器。
  • 接口路径使用 /v2/scrape 和 /v2/search，不是 /scrape。

常用命令或步骤

  1. 克隆仓库并进入：git clone https://github.com/firecrawl/firecrawl.git && cd firecrawl
  2. 配置 .env，关键项：REDIS_URL=redis://redis:6379、POSTGRES_USER=postgres、INTERNAL_PORT=3002、BULL_AUTH_KEY。
  3. 启动服务：docker compose -p firecrawl up -d
  4. 如果 worker 日志报 Redis ECONNREFUSED，在环境变量中添加 REDIS_RATE_LIMIT_URL=redis://redis:6379，否则 /v2/scrape 会一直挂起。

注意事项

  • RabbitMQ 健康检查默认超时太短，会导致 api 启动失败；需自定义 healthcheck，设置 timeout: 30s、start_period: 60s。
  • api 容器应设置 restart: always，避免运行数小时后意外退出。
  • 请求 /v* 路由时需带 Content-Type: application/json，否则返回 404。
🔀 查看流程图
flowchart TD A[克隆仓库] --> B[配置 .env] B --> C[修改健康检查] C --> D[启动服务] D --> E{Redis 连接拒绝?} E -- 是 --> F[添加限流地址] E -- 否 --> G[重启服务] F --> G G --> H[调用 v2 接口] H --> I{带 JSON 头?} I -- 否 --> J[添加请求头] I -- 是 --> K[获取结果] J --> H

📁 栗子云面板 1 个技能

控制台面板操作 栗子云面板

用途

管理 栗子云控制台 云面板的日常操作：登录、重置密码、SSH 部署、查看主机信息。

核心概念

  • 会话（Session）：登录后产生的 cookies，约 2 小时过期，过期后需重新登录。
  • 服务 ID：每台主机的数字编号，可在服务列表页面源码中找到。
  • 密码策略：新密码至少 12 位，必须包含大小写字母和
🔀 查看流程图
flowchart TD A[访问登录页面] --> B[提取CSRF令牌] B --> C[提交账号密码] C --> D{登录成功?} D -- 否 --> A D -- 是 --> E[保存会话Cookie] E --> F[选择操作] F --> G[重置密码] F --> H[部署SSH密钥] F --> I[配置密码策略] G --> J[完成] H --> J I --> J

📁 安全组 1 个技能

控制台安全组 安全组

栗子云-group

用于通过浏览器自动化操作 栗子云控制台 控制台的安全组，实现添加/删除规则、绑定主机等网络隔离配置。

核心概念

  • 安全组：一组网络访问控制规则，决定主机开放或限制哪些端口、IP。
  • 栗子云控制台 控制台：云服务管理界面，可对每台主机配置安全组。
  • Playwright：浏览器自动化工具，替代不稳定的 API 来操作控制台。

常用命令或步骤

  1. 使用已保存的登录 Cookie（/root/栗子云.json）启动无头浏览器。
  2. 打开服务详情页：栗子云控制台/servicedetail?id={服务ID}。
  3. 移除安全公告弹窗（#securityNoticeModal）。
  4. 点击“安全组”标签页，进入规则管理界面。
  5. 执行操作：添加规则（指定端口/IP）、删除规则、绑定安全组到主机。

注意事项

  • 页面元素可能加载慢，需要等待几秒；必要时用 click(force=True) 强制点击。
  • 若 API 返回 404 或异常，优先改用 Playwright 操作。
  • 规则变更会直接影响主机网络，操作前请确认端口和 IP 范围。
🔀 查看流程图
flowchart TD A[加载会话Cookie] --> B[打开服务详情页] B --> C[移除公告弹窗] C --> D[点击安全组标签] D --> E{操作类型} E -- 添加入口规则 --> F[设置端口和IP] E -- 删除规则 --> G[勾选并删除] E -- 绑定主机 --> H[选择安全组绑定] F --> I[确认变更] G --> I H --> I

📁 记忆同步 1 个技能

记忆同步 记忆同步

memory-db-sync 技能

该技能用于将 栗子云（智能体系统）的记忆数据同步到 MySQL（关系型数据库），并执行一致性检查。

核心概念

  • 栗子云 记忆：Agent 运行时产生的短期/长期状态数据。
  • MySQL 同步：将记忆数据写入 MySQL 表，保证持久化。
  • 一致性检查：对比源记忆与目标库中的记录，发现缺失或差异。

常用命令或步骤

  1. 运行同步命令，把当前记忆推送到 MySQL。
  2. 执行校验命令，自动比对双方数据数量与指纹。
  3. 查看报告，确认无误后完成同步。

注意事项

  • 同步前建议备份 MySQL 数据。
  • 大体积同步时注意网络与写入超时。
  • 一致性检查需在同步完成后进行，避免中途数据变动。
🔀 查看流程图
flowchart TD A[开始] --> B[备份MySQL] B --> C[运行同步命令] C --> D[推送记忆到MySQL] D --> E[执行校验命令] E --> F[比对数量与指纹] F --> G{是否一致} G -- 是 --> H[确认同步完成] G -- 否 --> I[标记异常并处理]

📁 多主机编排 1 个技能

多主机编排与容灾 多主机编排

multi-host-栗子云-orchestrator

栗子云 fleet self-healing with heartbeat, recovery, MySQL.

原文摘要：# Multi-Host 栗子云 Orchestrator

A self-healing mesh of 栗子云 Agents across ≥2 cloud nodes. Each node runs three daemons; one shared MySQL records state; cron-driven monitor detects offline hosts and triggers status-aware recovery. Daily cron emits a full inspection report to MySQL + email. End-to-end outage → recovery ≈ 8 minutes. Validated on 4 栗子云控制台 hosts 2026-07-30; expanded to 5 nodes (op

🔀 查看流程图
flowchart TD A[开始] --> B[节点守护进程] B --> C[心跳入库MySQL] C --> D[定时巡检] D --> E{节点离线?} E -- 否 --> C E -- 是 --> F[触发恢复] F --> G[更新状态] G --> H[生成报告邮件] H --> I[结束]

📁 多主机运维 2 个技能

多主机运维 多主机运维

用途

这个技能用于批量管理多台 Linux 云服务器：生成 SSH 密钥、配置主机别名、加固 sshd，实现免密、安全登录。

核心概念

  • SSH 密钥对：推荐同时生成 ed25519（新系统优先）和 RSA 4096（老系统兜底）。
  • ~/.ssh/config 别名：给每个主机起短名字，统一设置用户、端口、密钥，省去记 IP。
  • sshd 加固：关闭密码登录，只允许密钥认证，降低暴力破解风险。

常用命令/步骤

  • 生成密钥：

`bash

ssh-keygen -t ed25519 -f ~/.ssh//liz_ops_ed25519 -N ''

ssh-keygen -t rsa -b 4096 -f ~/.ssh//liz_ops_rsa4096 -N ''

`

  • 编辑 ~/.ssh/config，写主机块和通配符公共段，然后 ssh 别名 即可登录。
  • 用 ssh-copy-id 把公钥复制到目标主机；若失败，检查 sshd 配置。
  • 诊断 sshd：grep -E "^(Pubkey|Password)" /etc/ssh/sshd_config
  • 启用公钥登录：修改 PubkeyAuthentication yes，重启 sshd。

注意事项

  • Ubuntu 24.04 云镜像默认禁用公钥认证，即使 ssh-copy-id 成功也会拒绝密钥登录，需手动开启。
  • 密码含 $、! 等特殊字符时，改密码可能报错 "missing new password"，用单引号包裹或转义。
  • ~/.ssh 目录权限要 700，私钥 600，公钥 644。
  • StrictHostKeyChecking 只能写 accept-new，不要写 accept，否则语法错误。
🔀 查看流程图
flowchart TD A[生成密钥对] --> B[配置SSH别名] B --> C[复制公钥到主机] C --> D[检查sshd配置] D --> E{启用公钥认证?} E -- 是 --> F[测试免密登录] E -- 否 --> G[修改配置并重启] G --> F F --> H[完成]

swarm-cluster-pitfalls 多主机运维

Swarm集群踩坑排查

本技能用于排查Swarm/多主机Agent编排（如kanban swarm、delegate_task）的常见失败

🔀 查看流程图
flowchart TD A[接收故障报告] --> B{空输出?} B -- 是 --> C[调大max_tokens] B -- 否 --> D{限流?} D -- 是 --> E[Semaphore限并发] D -- 否 --> F{并发冲突?} F -- 是 --> G[MD5哈希选主机] F -- 否 --> H{Telegram问题?} H -- 是 --> I[处理群迁移/轮询] H -- 否 --> J[其他排查] C --> K[验证修复] E --> K G --> K I --> K J --> K K --> L[结束]

📁 研究 2 个技能

论文检索 研究

arxiv

这个技能用来通过 arXiv 的免费 REST API 搜索和获取论文，不需要 API key 或额外依赖，直接用 curl 就能查。

核心概念

  • arXiv API 返回 Atom XML，需要用 grep/sed 或 python 解析成可读格式。
  • 查询用 search_query 参数，关键词之间用 + 代替空格。
  • 指定论文 ID 用 id_list 参数。
  • 支持按标题 ti:、作者 au:、摘要 abs:、分类 cat:、全部字段 all: 等前缀搜索。
  • 支持布尔逻辑：OR、ANDNOT、精确短语用引号。

常用命令

  • 搜索论文：`curl "https://
🔀 查看流程图
flowchart TD A[用户输入关键词或ID] --> B{是否指定论文ID?} B -- 是 --> C[构造id_list查询] B -- 否 --> D[构造search_query查询] C --> E[拼接arXiv API请求] D --> E E --> F[用curl发送请求] F --> G[解析Atom XML] G --> H[输出论文列表]

deep-research-report-generation 研究

用途

用于通过多代理集群生成专业研究报告（技术分析、市场调研、产品评估等），尤其当之前的报告太单薄或需要达到“Kimi 集群”报告质量时。

核心概念

  • Kimi 级深度：不是简单摘要。参考报告 15-80KB，包含执行摘要、多级章节、情景分析、对比表格和引用来源。
  • 真正子代理：必须使用 栗子云 kanban swarm 原生子代理——每个 worker 是完整代理（有自己的工作区、工具、上下文和推理），而不是脚本调用单次 LLM。

常用命令/步骤

  • 管道阶段：调研 → 生成 plan.md → 章节并行执行（每章 800-1500 字，线程池 4 并发）→ 组装成 deliverable.md → QA（每章≥300字）→ 导出 PDF 并发送。
  • 创建 swarm：栗子云 kanban swarm "<目标>" --worker "default:技术架构" ... --verifier default --synthesizer default --json
  • 执行：栗子云 kanban dispatch --max <N>，监控返回的 root/worker/verifier/synthesizer 的 id。

注意事项

  • 不要串行运行章节，否则太慢。

-

🔀 查看流程图
flowchart TD A[接收研究主题] --> B[制定研究计划] B --> C[搜索收集信息] C --> D{信息是否充足} D -- 否 --> C D -- 是 --> E[深度分析综合] E --> F[生成报告草稿] F --> G[审阅修订] G --> H[输出最终报告]

📁 软件开发 6 个技能

技能编写指南 软件开发

栗子云 Agent-skill-authoring 技能

这个技能用于在 栗子云 Agent 仓库内编写和修改 SKILL.md 技能文件。

核心概念

  • 技能文件有两种存放位置：用户本地 ~/.栗子云/skills/ 和仓库内 /home/bb/栗子云 Agent/skills/。本技能只
🔀 查看流程图
flowchart TD A[开始] --> B[解析用户需求] B --> C[定位技能文件] C --> D{文件是否存在?} D -- 否 --> E[创建新 SKILL.md] D -- 是 --> F[读取现有 SKILL.md] E --> G[编写或修改技能内容] F --> G G --> H[校验格式与内容] H --> I{是否通过?} I -- 否 --> G I -- 是 --> J[输出完成信息]

multi-agent-cluster-reliability 软件开发

multi-agent-cluster-reliability

集群执行可靠性：并发竞态、API限流、LLM空输出重试、推理烧token。Swarm执行失败时用。

原文摘要：# Multi-Agent Cluster Reliability — 集群执行可靠性模式

多主机 + 多 Agent 并行集群（栗子云 delegate_task / SSH 栗子云 -z 分发）执行失败的调试模式库。

触发：集群任务大量失败、Agent 偶发空输出、并发执行全灭、LLM 返回空 content。

注：swarm-orchestrator（user-owned）讲编排流程；本 skill 讲执行可靠性坑位与修复模式。

一、并发执行可靠性

1. 并发主机分配竞态（最隐蔽的坑）

ThreadPoolExecutor 里用 len(results) % len(hosts) 选主机时，results 在并发下未同步更新，

所有线程算出同一索引 → 全部 Agent 堆到同一台主机 → 该机连续 [EMPTY]。

``

🔀 查看流程图
```mermaid flowchart TD A[开始] --> B[集群执行失败] B --> C{诊断问题} C -->|并发抢主机| D[调整主机分配] C -->|API限流| E[退避重试] C -->|LLM空输出| F[重试/校验] C -->|Token烧光| G[限制上下文] D --> H[重试执行] E --> H F --> H G --> H

multi-agent-orchestration-patterns 软件开发

multi-agent-orchestration-patterns

设计多Agent集群(虚拟公司/Kimi Swarm复刻)时的架构模式与节点容错知识库。

原文摘要：# 多 Agent 编排设计模式

设计"虚拟公司"式多 Agent 集群时的架构知识库。回答: Kimi Agent Swarm 怎么工作、虚拟公司怎么组织角色、

spec/plan 模式何时用、节点出错了怎么容错。

详细调研笔记见 references/kimi-agent-swarm.md (四模块详解/官方执行示例/落地取舍对比)。
节点失败诊断手册见 references/node-failure-diagnosis.md (模型配置漂移/FIRECRAWL env/并发限流/[EMPTY]假成功, 10 轮压测结论)。
kanban 原生 swarm + Telegram 群协作 + searxng 落地细节见 references/kanban-swarm-and-tg-fleet.md (命令/坑/bot分配表)。
Telegram bot 舰
🔀 查看流程图
flowchart TD A[接收任务] --> B[分析任务类型] B --> C{有明确交付物?} C -->|是| D[spec直接执行] C -->|否| E[plan先计划] D --> F[拆解子任务] E --> F F --> G[动态调度Agent] G --> H[结果聚合] H --> I[输出结果]

任务规划 软件开发

plan 技能用于把用户需求写成一份可执行的 markdown 实施计划，但只做规划、不执行任何改动。

核心概念

  • 规划模式：不写业务代码、不修改项目文件（计划文件除外）、不运行有副作用的命令。
  • 交付物：一份保存到 .栗子云/plans/ 目录下的 markdown 计划。
  • 计划内容：目标、现状假设、方案、分步步骤、涉及文件、测试/验证方法、风险与待定问题。

常用步骤

  1. 根据对话上下文推断任务；不明确时先简短提问，不瞎猜。
  2. 用写入工具保存计划，文件名格式：.栗子云/plans/YYYY-MM-DD_HHMMSS-<slug>.md。
  3. 保存后简短回复：规划了什么 + 文件路径。

注意事项

  • 可以用只读命令查看仓库或上下文，但别动代码。
  • 计划要具体到文件路径、测试命令和验证方式，让接手的人不用猜。
  • 若运行环境指定了目标路径，使用指定路径；否则自建带时间戳的文件名。
🔀 查看流程图
flowchart TD A[推断任务] --> B{是否明确} B -- 否 --> C[简短提问] C --> A B -- 是 --> D[制定实施计划] D --> E[保存计划文件] E --> F[回复规划与路径]

代码审查请求 软件开发

requesting-code-review

这个技能用于在代码提交前自动做安全扫描、质量门禁和自动修复，确保改动不会带病入库。

核心概念

  • 自己不能验证自己的工作：由一个独立 reviewer 子代理检查，避免自证的盲区。
  • 基线感知：只阻止你新增的测试/检查失败，老问题不背锅。
  • 自动修复循环：发现问题后自动修，修完再验，直到通过或放弃。

常用步骤

  1. 拿到改动：git diff --cached；若为空试试 git diff 或 git diff HEAD~1 HEAD。如果只有未暂存改动，先 git add。
  2. 安全扫描：只扫新增行，用 grep 找硬编码密钥、shell 注入、eval/exec、pickle、SQL 注入等危险模式。
  3. 跑基线测试和 lint：先 stash 你的改动跑一遍，记录基线失败数；再恢复改动跑一遍，只比较新增失败。常用命令如 pytest、npm test、cargo test、go test。
  4. 把发现的问题交给自动修复循环处理，修复后重新验证。

注意事项

  • 仅改文档、纯配置或用户说「跳过验证」时不要跑。
  • 大 diff（超过 15000 字符）按文件分开检查。
  • 这个技能是验你自己的提交；GitHub 上 review 别人的 PR 用另一个技能。
🔀 查看流程图
flowchart TD A[开始] --> B[获取改动] B --> C{有新增改动?} C -- 否 --> D[尝试其他diff范围] C -- 是 --> E[安全扫描新增行] D --> E E --> F[基线测试与Lint] F --> G{新增失败?} G -- 否 --> H[通过] G -- 是 --> I[自动修复循环] I --> J[重新验证] J --> G

资源速度测试 软件开发

resource-speed-testing 是一个在慢速下载前快速探测候选源并切换到最快源的技术技能。

核心概念

  • 从 registry / mirror / repo 下载前，先花 10 秒测速，避免在慢源上等几分钟。
  • 适用于 docker pull、npm install、pip install、apt-get install、git clone 等网络操作。
  • 至少准备 3-5 个候选源（默认源 + 公共镜像）。

常用命令或步骤

  1. 列出候选源，例如 Docker 镜像可参考 status.anye.xyz 看实时延迟。
  2. 探测速度：简单用 curl -o /dev/null -s -w '%{time_total}' URL，但更好是直接执行最小下载测试，比如 docker pull mirror/alpine:3.18 再 docker rmi 清理。
  3. 按速度排序，选最快或前两个。
  4. 切换配置：Docker 改 daemon.json 并重启；npm 用 npm config set registry；pip 用 pip config set global.index-url；apt 写 sources.list 文件；git 用 insteadOf。
  5. 执行正式操作；失败
🔀 查看流程图
flowchart TD A[开始] --> B[列出候选源] B --> C[探测速度] C --> D[按速度排序] D --> E[选最快源] E --> F[切换配置] F --> G[执行下载] G --> H{成功?} H --成功--> I[结束] H --失败--> J[选下一候选源] J --> F

📁 swarm-orchestrator 1 个技能

swarm-orchestrator swarm-orchestrator

Swarm Orchestrator — 虚拟公司式多 Agent 集群编排

Swarm Orchestrator 是一种把任务交给“CEO Agent”设计工作流，再调度多个 Agent 并行执行、最后聚合交付的集群编排技能。

核心概念

  • CEO Agent：本机主控，负责拆解任务、生成计划 plan.json、分配角色和阶段。
  • 阶段执行：任务分多个 stage，每个 stage 可并行跑 3-6 个 Agent；重任务可用 SSH 分发到其他主机。
  • 隔离目录：每个任务有独立目录 /root/swarm/<任务ID>/，各 Agent 只读写自己的子目录，避免冲突。
  • 聚合交付：最终由一个聚合 Agent 汇总所有产出，生成最终报告并归档。

常用命令或步骤

  • 触发：直接说“用集群 / 虚拟公司方式做 X”。
  • 主流程：任务澄清 → 技能准备 → 角色设计 → 网络检查 → 分阶段执行 → 质量验证 → 归档清理。
  • 并行执行：使用 delegate_task(tasks=[...]) 批量分发。
  • 跨主机分发：用 栗子云 -z "<任务>" 发给其他
🔀 查看流程图
flowchart TD A[接收复杂任务] --> B[CEO生成计划] B --> C{计划校验} C -- 通过 --> D[分派并行任务] C -- 不通过 --> B D --> E[多Agent并行执行] E --> F[汇总结果] F --> G{验收标准} G -- 通过 --> H[交付成果] G -- 不通过 --> D

📁 telegram 1 个技能

telegram-multi-bot-collab telegram

用途：管理多个 Telegram Bot 在群里协作（例如 PM + 7 个角色），靠后端中转实现派单和汇报。

核心概念

  • Bot 收不到其他 Bot 的 @，这是 Telegram 硬限制，别用互 @ 协作。
  • TELEGRAM_REQUIRE_MENTION=true 不可靠，会吞消息；改用 channel_prompts 提示词约束。
  • 可靠路径：PM 本机收任务 → HTTP/SSH 派单 → 各角色用各自 Bot 发结果到群。

常用命令/步骤

  • 每节点配置：栗子云 config set
🔀 查看流程图
flowchart TD A[老板群发任务] --> B[PM gateway接收] B --> C[swarm-pm编排] C --> D[swarm-dispatch派单] D --> E{HTTP可用?} E -- 是 --> F[栗子云-bridge执行] E -- 否 --> G[SSH兜底执行] F --> H[结果发回群] G --> H H --> I[任务完成]

📁 telegram-group-collab 1 个技能

telegram-group-collab telegram-group-collab

核心概念

这个技能让栗子科技群（-1004347531042）里的 Bot 像公司员工一样协作：通过 @ 其他 Bot 来派单、转交任务或请求帮助。

  • 每个 Bot 有固定角色：项目经理（@researcher_lizbot）、调研员（@lzptbot）、内容专家（@content_lizbot）、方法论专家（@method_lizbot）、撰写员（@writer_lizbot）、统计师（@statistician_lizbot）、执行验证员（@smileduckbot）。
  • 所有协作都在群里可见，形成透明的工作链。

常用命令或步骤

  • 派单：PM @ 对应角色并说明任务，例如：@调研员 请调研2026年AI Agent市场规模
  • 转交：A 发现自己搞不定，@B 请求协助，例如：@方法论专家 请帮忙设计框架
  • 平级求助：直接 @ 相关角色，如 @统计师 请核算增长率
  • 质检重做：PM 发现问题后 @ 对应角色，要求补充或重做
  • 问进度：老板 @ 任意 Bot，该 Bot 必须回复当前状态

注意事项

  • 被 @ 的 Bot 必须响应，先复述任务要点再执行，完成后 @ 派单人汇报。
  • 每次主要 @ 一个目标，可附带提醒其他 Bot。
  • 不要重复做别人已完成的事，先看群内上下文。
  • 遇到困难及时 @PM，不要擅自停止。
🔀 查看流程图
flowchart TD A[PM派单] --> B[被@者确认] B --> C[执行任务] C --> D{遇到困难?} D -- 是 --> E[@PM汇报] E --> C D -- 否 --> F[完成并@派单人] F --> G[PM质检] G --> H{通过?} H -- 否 --> I[重新处理并回复] I --> F H -- 是 --> J[结束]

📁 网页自动化 1 个技能

knowledge-wiki-publishing 网页自动化

知识库 Wiki 发布（knowledge-wiki-publishing）

这个技能负责把 LLM 整理好的知识库 Wiki 自动部署到 Cloudflare Pages 上，并完成每日更新、安全检查、邮件通知等整套流程。

核心概念
  • 生成脚本：/root/bin/gen-wiki.py，负责把 skill 转成中文摘要和流程图，输出到 /root/wiki-output/
  • LLM 缓存：/root/wiki-state.json，只转换有变更的 skill，节省时间和费用
  • 白名单过滤：/root/wiki-used.json，只展示实际用过的 skill，符合老板要求
  • 自动发布：通过 Cloudflare Pages（项目名 栗子云-wiki）托管，每日 21:00 UTC 自动跑一遍“生成 → 检查 → 部署 → 发邮件”
常用命令

`bash

全量生成（调用 LLM 转换缺失的 skill，4 并发）

python3 /root/bin/gen-wiki.py

快速重建（用缓存，不调 LLM）

python3 /root/bin/gen-wiki.py --skip-llm

生成 + 部署 + 发邮件

python3 /root/bin/gen-wiki.py --deploy

手动部署（需要先设置 Cloudflare 凭证环境变量）

npx wrangler pages deploy /root/wiki-output --project-name 栗子云-wiki

`

注意事项
  • 缓存命中也要脱敏：旧摘要可能含 IP/主机名，读取后必须再过一遍 redact()，否则会泄露。
  • --deploy 前必须设置 DB_PWD：脚本靠它连 MySQL 读 Cloudflare 凭证，忘了就部署失败。
  • --skip-llm 时必须读缓存，别用描述兜底，否则页面会显示英文原文、加粗失效。
  • 流程图也要脱敏和品牌替换，不能漏。
  • 分类名里的“IPXR/栗子云”也要翻译，单靠品牌替换救不回来。
  • 页面要全中文、内联格式完整、每个 skill 带可折叠流程图，底部固定显示“栗子云技术中心 · 栗子Bot自动生成 · 每日更新”。
🔀 查看流程图
flowchart TD A[开始] --> B[读取状态缓存] B --> C{有变动?} C -- 有 --> D[运行生成脚本] D --> E[白名单过滤] E --> F[安全检查] F --> G[部署到CF Pages] G --> H[发送邮件] H --> I[结束] C -- 无 --> I