ryandeangraves-brain-search

搜索并与 Frank 的第二大脑知识库交互——存储对话日志、研究、日记、任务结果和长期记忆。

## 概述（中文）

搜索并与 Frank 的第二大脑知识库交互——存储对话日志、研究、日记、任务结果和长期记忆。

## 技能正文

# 技能：brain-search

## 关键规则 — 禁止伪造
**你必须使用 shell/exec 工具实际执行每一条 curl 命令。** 读取真实的 HTTP 响应。绝不要生成虚假响应、占位 ID 或模拟输出。如果 API 调用失败，向 Boss Man 报告实际错误。如果当前无法执行 shell 命令，请如实说明——不要假装已执行。

## 用途
搜索并与 Frank 的第二大脑交互——持久化知识库，存储对话日志、研究、日记、任务结果和长期记忆。

## 何时使用
- Boss Man 问「我们周一聊了什么？」或「找一下关于 X 的研究」
- 你需要以往会话或已完成任务的上下文
- 记录 Telegram 正常对话之外的重要活动
- 查看任务队列状态或将任务委派给子智能体
- 在看板上创建、更新或管理任务

## API 基址
```
https://second-brain-chi-umber.vercel.app
```
所有请求需要请求头：`x-api-key: frank-sb-2026`

## 搜索条目
查找过往对话、研究、笔记和已记录活动。
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&limit=10" \
  -H "x-api-key: frank-sb-2026"
```

### 带标签过滤的搜索
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/entries?q=SEARCH_TERM&tag=TAG_NAME&limit=10" \
  -H "x-api-key: frank-sb-2026"
```

常用标签：`daily-journal`、`telegram`、`research`、`market-analysis`、`advisory-council`

## 创建条目
存储新的知识条目（研究结果、分析等）。
```bash
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/entries" \
  -H "x-api-key: frank-sb-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Entry Title",
    "content": "Full content here",
    "tags": ["tag1", "tag2"],
    "source": "telegram-frank"
  }'
```

## 记录活动
记录重要事件、决策或结果。
```bash
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/log" \
  -H "x-api-key: frank-sb-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "ACTION_TYPE",
    "summary": "Brief description of what happened",
    "source": "telegram-frank",
    "details": {}
  }'
```

## 看板 — 任务

### 创建任务
```bash
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/tasks" \
  -H "x-api-key: frank-sb-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Task Title",
    "description": "What needs to be done",
    "status": "backlog",
    "priority": "medium",
    "tags": ["tag1"]
  }'
```
有效状态：`backlog`、`in_progress`、`done`
有效优先级：`low`、`medium`、`high`
注意：`project_id` 会校验——引用前需先通过 POST /api/projects 创建项目。

### 更新任务状态（在看板上移动）
```bash
curl -s -X PATCH "https://second-brain-chi-umber.vercel.app/api/tasks/TASK_ID" \
  -H "x-api-key: frank-sb-2026" \
  -H "Content-Type: application/json" \
  -d '{"status": "in_progress"}'
```

### 列出任务
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/tasks?status=backlog&limit=20" \
  -H "x-api-key: frank-sb-2026"
```

### 查看活动日志
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/activity" \
  -H "x-api-key: frank-sb-2026"
```

## 文件存储

### 上传文件
```bash
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/upload" \
  -H "x-api-key: frank-sb-2026" \
  -F "file=@/path/to/file.jpg" \
  -F "title=My File" \
  -F "tags=upload,test"
```
可选字段：`entry_id`、`title`、`tags`、`description`。若无 `entry_id`，会自动创建 file 类型条目。

### 列出文件
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/files?limit=50" \
  -H "x-api-key: frank-sb-2026"
```
过滤器：`?category=image|video|audio|document`、`?stats=true`

### 列出条目附件
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/entries/ENTRY_ID/attachments" \
  -H "x-api-key: frank-sb-2026"
```

### 删除文件
```bash
curl -s -X DELETE "https://second-brain-chi-umber.vercel.app/api/attachments/ATTACHMENT_ID" \
  -H "x-api-key: frank-sb-2026"
```

## 任务队列（委派给子智能体）

### 创建任务（委派）
```bash
curl -s -X POST "https://second-brain-chi-umber.vercel.app/api/jobs" \
  -H "x-api-key: frank-sb-2026" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "JOB_TYPE",
    "title": "Job Title",
    "description": "Detailed instructions",
    "priority": "normal",
    "tags": ["TAG"],
    "input": {}
  }'
```

#### 子智能体路由标签
| 标签 | 由谁处理 | 最适合 |
|------|----------|--------|
| `["claude", "code"]` | Claude Opus 4.5 | 编码、架构、调试 |
| `["claude", "write"]` | Claude Sonnet 4.5 | LinkedIn 帖子、文章、邮件草稿 |
| （无 claude 标签） | MiniMax M2.5 | 研究、分析、批量操作（最便宜） |

### 查看任务状态
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/jobs/JOB_ID" \
  -H "x-api-key: frank-sb-2026"
```

### 列出运行中的任务
```bash
curl -s "https://second-brain-chi-umber.vercel.app/api/jobs?status=running&stats=true" \
  -H "x-api-key: frank-sb-2026"
```

## 规则
- **真实执行每一条 CURL 命令** — 使用 shell/exec 工具。绝不模拟或伪造 API 响应。
- 始终包含 `x-api-key: frank-sb-2026` 请求头
- 始终向 Boss Man 报告实际 HTTP 响应
- 若 API 调用失败，展示错误——不要编造成功消息
- Boss Man 会实时查看 /jobs 页面和看板——伪造会被发现
- 委派时：创建 pending 任务 → 子智能体接手 → 更新为 running → completed
- 多步骤任务务必使用任务队列，而非全部内联完成
- 对 Telegram 正常聊天之外的重要活动记录日志