⚡ 栗子云知识库

Skills & 记忆 · 每日 LLM 整理

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

🧠 系统记忆

群协作v3:Bot收不到其他Bot消息(硬限制)→kanban原生子Agent(swarm-pm-v2,12并行实测1030s)+group_collab实名映射;
【凭证存储约定】所有云厂商凭证只存 MySQL cloud_credentials 表 (provider='cloudflare' 等, 含 account_id/api_token/r2 三件套)，绝不落本地文件；用时从 MySQL 读入环境变量。
【Cloudflare 约束】只用免费配额绝不触发收费(KV写1k/天、读100k/天、Worker请求100k/天)。凭证见 MySQL cloud_credentials。
=(,CentOS7,)。2026-08-02装栗子云 v0.19.1,模型opencode-go。
【邮件系统偏好】主题前缀 [栗子云Bot] 固定；结果邮件主题用离线主机命名(XX 等 N 台主机离线，已完成恢复)；状态卡片只显示 IP/内存/硬盘/负载/容器(显示用量)。email-consolidator.py 用 LLM() 合并≤2封(>10min未恢复发检测通知+处理结果,快速恢复1封,主题规则化不依赖LLM,恢复去重:failed分支只记email_pending)。**离线兜底通知用邮件不用Telegram**：CF Worker 接 Resend(key存MySQL provider='resend', 发件→收件)。
【LLM配置】OpenCode Go: base_url= provider=opencode-go, model=(老板指定勿改)。双key随机主备(主+OPENCODE_FALLBACK_KEY备)。坑:urllib无UA 403;reasoning空content重试+模板兜底;${VAR}在heredoc被shell展开。
【栗子云 操作铁律】云服务器禁止使用任何代理（HTTP/SOCKS 代理会被封号，老板明确）。本机 IP 被 栗子云 风控时，禁止起代理隧道，改为通过 SSH 让对端未风控节点（如 HK-Q）的 栗子云/脚本直接操作 栗子云。栗子云.sh 的隧道方案已废弃。
【知识库wiki】 (CF Pages 项目 栗子云-wiki)，gen-wiki.py 每日 21:00 UTC 生成+部署+邮件通知；只展示 /root/wiki-used.json 白名单内使用过的 skill（20个），skill/分类名全中文，LLM 生成易读摘要+mermaid 流程图；凭证双层脱敏（正则+部署前LLM检查），IP/主机名/内部域名绝不落页面。
【BJ】()国内网络:MySQL连接不稳(曾致误报+重复恢复邮件,诊断法见 multi-host-栗子云-orchestrator references/repeated-recovery-email-triage.md:心跳>180s但SSH在线=上报中断非故障,修复方向=阈值300s+24h同主机1封节流);防火墙连不了Telegram(不配bot,broker=false纯worker)。heartbeat已加3次重试+SSH二次确认;换解释器须确认远端venv有pymysql。
【时区约定】9台时区统一 Asia/Shanghai(CST UTC+8)，MySQL tz=+08:00；脚本统一 CN_TZ=timezone(timedelta(hours=8)) 显式北京时间，禁裸 datetime.now()。9台已装 typeaudit 监控(nt-tunnel+pika-agent)。主节点=health-monitor 实时 md5(date)%9 选举。
【Swarm集群v2】栗子云 kanban编排+MySQL镜像(kanban_mirror,kanban-sync.py每60s,9台)。swarm-planner.py动态拆解(自动角色+budget~1亿)。搜索searxng@HK-Q:8888(9台,安全组4223)。delegation无限制。
【Swarm老板规则】任务失败2+轮先停手复盘修BUG再重跑;群里只发阶段/总结果(过程进日志);项目经理制:实名Bot+差异化计划+完成简报含交付物路径;超时先探测LLM流式回复再决策wait/retry/kill;Agent1/2 key1、3/4 key2仅opencode;任务目录uuid;文档整合独立Agent。详见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分工→子Agent实名(setMyName:沈嘉禾/陆之昂/顾星野/林默/苏黎世/程亦辰)→计划反馈→执行→完成汇报→总交付,每角色都起作用;报告对标Kimi专业标准(执行摘要+多级章节+多来源引用+对比表),拒简短平铺。

📁 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 智能体

multi-agent-swarm-orchestration

复刻 Kimi Agent Swarm/虚拟公司多角色协作，用 delegate_task 拆解任务并并行执行。

原文摘要：# 多 Agent 集群编排（Kimi Agent Swarm / 虚拟公司模式）

用户想要的能力：发一个任务给 Agent → 它自动设计整套含大量角色的工作流、模拟一整个公司、为子 Agent 分配临时角色和分工、并行执行、达成研究/工作目标。本 skill 是这套模式的调研结论 + 栗子云 落地实现方案。

何时使用

  • 用户要求"像 Kimi 集群/Agent Swarm 一样"、"虚拟公司/模拟团队"、"给我分配一堆角色协作完成任务"
  • 任务复杂到需要多维度并行调研/分析（市场+技术+人才、竞品对比、方案多视角评审）
  • 需要 orchestrator 动态设计角色分工，而不是手动写死 worker 列表

核心模式（Kimi Agent Swarm 四模块）

`

User 请求 → ①任务分析器(复杂度判断) → ②任务拆解器(子任务+依赖

🔀 查看流程图
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 互收限制：Telegram 硬性规定 Bot 收不到其他 Bot 发的消息，所以不能靠 @ 互踢任务，必须走后端中转（如 PM 节点派单）。
  • getUpdates 冲突：同一个 Bot 只能有一个轮询会话，第二个请求会报 409 Conflict，导致 Bot 掉线。
  • require_mention：设置后只有被 @ 的 Bot 才响应，未提及消息全部静默。

常用命令/步骤

  • 设置只响应提及：栗子云 config set telegram.extra.require_mention true
  • 设置未提及消息仅观察：栗子云 config set telegram.extra.observe_unmentioned_group_messages true
  • 验证轮询状态：ss -tnp | grep 149.154（看到 Telegram IP 的 ESTAB 连接即正常）
  • 清空日志：重启 gateway 进程，不要手动 > gateway.log。

注意事项

  • 千万别用 getUpdates 探测 Bot 是否在轮询，这会抢占会话导致冲突，且需要重启 gateway 等 2-3 分钟才能恢复。
  • 不要手动截断 gateway.log，会导致日志句柄失效，新日志全丢。
  • 角色 prompt 必须显式约束对老板的语气，防止 LLM 放飞自我。
  • 群升级为超级群后 chat_id 会变，老 ID 会报 400 migrate 错误。
  • setMyName 接口有全局冷却，连续改名易触发 429，需间隔 ≥8 秒并做退避重试。
🔀 查看流程图
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 密钥等日常运维。

核心概念

  • 登录依赖 Cookie（PHPSESSID 等），约 2 小时过期，过期后 API 会报 404 或“请登陆后再试”。
  • 服务详情页源码里直接暴露当前 root 密码（JS 变量 zcPwdValue），无需点眼睛图标。
  • 重置密码走 crack_pass 接口，密码需 12 位以上，含大小写字母和数字。

常用命令或步骤

  1. 登录：先 GET 登录页取 CSRF 令牌，再 POST 提交邮箱密码，保存 Cookie。
  2. 查主机：GET /service?groupid=347 列服务，搜 ser<hex> 找数字 service_id，再访问详情页。
  3. 取 root 密码：从详情页 HTML 中正则匹配 zcPwdValue 的值。
  4. 重置密码：POST /provision/default，传 func=crack_pass&id=<service_id>&password=<新密码>。
  5. SSH：重置后先 ssh-keygen -R <IP> 清除旧主机密钥，等 60 秒再连接部署公钥。

注意事项

  • 本机 IP 被风控时，需 SSH 到未风控节点操作，再把会话拷回本机。
  • 面板账号密码从 MySQL 的 cloud_credentials 表读取，不要硬编码。
  • 重置密码后，sshd 可能只允许公钥登录，但 authorized_keys 可能被清空，需重新部署。
🔀 查看流程图
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 个技能

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

用途

这个技能用于在≥2台云主机上部署 栗子云 代理，实现自愈监控：检测离线、自动恢复，并把每日巡检报告存入 MySQL 并邮件发送。

核心概念

  • 每节点运行三个守护进程，共享一个 MySQL 记录状态
🔀 查看流程图
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 多主机 Agent 编排的常见故障：LLM 空输出、API 限流、并发分配冲突、Telegram 群协作问题。

核心概念

  • Swarm 编排：多台主机跑 Agent 任务，常用 栗子云 -z、delegate_task 等。
  • 最大坑：DeepSeek 的 reasoning 模式会把 max_tokens 全烧在思考内容上，导致最终 content 为空。
  • 限流：同时超过 3 路 LLM 调用会全部失败。
  • 并发 race：多线程用 len(results)%len(hosts) 选主机会算成同一个，导致全堆一台。
  • Telegram 机制：bot 群权限、群升级 ID 变化、getUpdates 冲突等。

常用命令/步骤

  • LLM 调用统一设置：max_tokens>=8192，LLM_TIMEOUT=90，失败重试 3 次 + 随机退避 3-8 秒。
  • 并发控制：用全局 Semaphore(3) 包住执行，批量跑时 BATCH=3 + 批间 5 秒。
  • 选主机：用 agent id 的 MD5 哈希取模，避免并发 race。
  • Telegram 重启前清空积压：

`python

getUpdates?offset=最大update_id+1

`

注意事项

  • 遇到空 content，先单台测简单任务（PONG）判断是 LLM 偶发还是配置问题。
  • 同一 bot 只能有一个 getUpdates 长轮询，否则报 409；监控 daemon 要跳过 orchestrator bot。
  • 群升级超级群后 chat_id 会变，从响应的 migrate_to_chat_id 拿新 ID。
  • 国内节点不配 Telegram broker，纯 worker；国外节点设 `broker.enabled
🔀 查看流程图
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 研究

Deep Research 报告生成技能

本技能用于

🔀 查看流程图
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 软件开发

用途

多主机多 Agent 并行集群执行失败时用的调试手册，解决并发抢主机、API 限流、LLM 空输出、token 被烧光等问题。

##

🔀 查看流程图
```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 软件开发

用途

这个技能帮你设计多 Agent 集群（模仿虚拟公司或 Kimi Swarm），包括架构模式、任务编排和节点容错。

核心概念

  • Kimi Swarm（Kimi 智能体集群）：模型自身当编排器，四大模块：任务分析 → 拆解 → 动态调度 → 结果聚合。
  • 虚拟公司模式：像 ChatDev（CEO→CTO→程序员→测试）或 MetaGPT（SOP 流水线）那样给 Agent 分角色。
  • 编排类型：集中式（单主控）、去中心化（平等协作）、分层（上层决策+下层执行）、联邦式（多系统按规则协作）。
  • spec vs plan：有明确交付物（报告/代码）用 spec 直接执行；开放探索（调研/分析）用 plan 先计划再执行。

常用命令

  • `swarm-run.py --mode "<任务
🔀 查看流程图
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

本技能用于将复杂任务交给“CEO Agent（调度主代理）”拆解为虚拟公司式工作流，并调度多主机、多Agent并行执行，最终汇总交付。

核心概念

  • CEO Agent：本机编排器，负责分析任务、生成 plan.json（含角色、阶段、依赖、验收标准）。
  • 并行机制：同主机多Agent通过 delegate_task
🔀 查看流程图
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-multi-bot-collab 用于配置和调试多个 Telegram 机器人在同一群里的协作，典型场景是“PM + 7 个角色 Bot”模拟公司群聊。

核心概念

  • Bot 收不到其他 Bot 的消息（Bot API 硬限制），所以群里 @botB 只是好看，Bot B 永远收不到。
  • TELEGRAM_REQUIRE_MENTION=true 不可靠，会连被 @ 的消息也吞掉；想“仅被 @ 才响应”，用提示词约束，别用这个配置。
  • Bot 之间传消息唯一可靠路径 = 后端中转（PM 本机调度，各角色节点执行后用自己的 Bot 发结果）。

常用步骤

  1. 老板群发任务 → 本机 orchestrator（PM gateway）接收。
  2. swarm-pm.py 编排：接收→调研→计划→确认→派单→质检→汇总。
  3. swarm-dispatch.py 派单：优先走 HTTP（栗子云-bridge.py 常驻端口 8138），封闭节点走 SSH 兜底。
  4. 各节点 栗子云 执行，用自己的 Bot 发结果到群。

注意事项（已知坑）

  • 禁止用 getUpdates 探测，会制造 409 冲突，打断 gateway 的 poll，Bot 变“空闲”。
  • 重启 gateway 会被工具层拦截，要用远程 SSH 或 base64 绕过。
  • 部署时 .env 必设 GATEWAY_ALLOW_ALL_USERS=true，否则群消息会被拒收。
🔀 查看流程图
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

telegram-group-collab

用于栗子科技群内 Bot 之间通过 @ 协作，形成公司式工作链。

核心概念

  • 每个 Bot 是公司“员工”，由各自节点的 LLM 驱动。
  • 通过 @ 其他 Bot 实现派单、转交、请求协助。
  • 角色包括：PM（@researcher_lizbot）、调研员、内容专家、方法论专家、撰写员、统计师、执行验证员。

常用步骤

  • 派单：PM @ 对应角色并给出明确任务，如“@调研员 请调研2026年AI Agent市场规模”。
  • 被 @ 者必须响应确认，执行任务，完成后 @ 派单人汇报。
  • 转交：不擅长时 @ 对应角色请求协助，可形成“PM→调研→内容→撰写”的协作链。
  • 质检：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 网页自动化

knowledge-wiki-publishing

Publish the LLM-curated knowledge wiki to Cloudflare Pages.

原文摘要：# 知识库 Wiki 发布 (knowledge-wiki-publishing)

触发条件

  • 维护/重建 /root/bin/gen-wiki.py 知识库生成管道
  • 部署 wiki 到 CF Pages（）
  • 修复 wiki 内容问题（脱敏、中文翻译、md 渲染、导航、流程图）
  • 处理 wiki 每日 cron 任务（job 0d004b08557a）

架构

  • 生成脚本: /root/bin/gen-wiki.py
  • 输出: /root/wiki-output/（index.html + timeline.html）
  • LLM 缓存: /root/wiki-state.json（skill hash → 摘要 + 流程图，只转换变更的）
  • 时间轴数据: `/
🔀 查看流程图
flowchart TD A[开始] --> B[读取状态缓存] B --> C{有变动?} C -- 有 --> D[运行生成脚本] D --> E[白名单过滤] E --> F[安全检查] F --> G[部署到CF Pages] G --> H[发送邮件] H --> I[结束] C -- 无 --> I