名称： pikaboard
描述： "与 PikaBoard 任务管理 API 交互。用于创建、更新、列出或管理任务。面向 AI 团队的 Agent-first 看板。触发词：tasks、kanban、board、todo、backlog、sprint。"
元数据：
openclaw:
emoji: "📋"
requires:
bins: ["node", "npm"]
install:
- id: clone
kind: git
repo: https://github.com/angelstreet/pikaboard
branch: main
label: "克隆 PikaBoard 仓库"
- id: backend
kind: script
cwd: "pikaboard/backend"
run: "npm install && npm run build"
label: "安装后端依赖"
- id: frontend
kind: script
cwd: "pikaboard/frontend"
run: "npm install && npm run build"
label: "构建前端"
- id: env
kind: prompt
message: "创建包含 DATABASE_PATH 和 PIKABOARD_TOKEN 的 .env 文件"
label: "配置环境变量"

PikaBoard

面向 Agent 的任务/看板仪表盘。PikaBoard 是任务的唯一可信源。

快速开始

安装完成后，启动服务：

cd pikaboard/backend && npm start

通过 http://localhost:3001 访问仪表盘。

配置

创建 backend/.env 文件：

DATABASE_PATH=./pikaboard.db
PIKABOARD_TOKEN=your-secret-token
PORT=3001

添加到你的 TOOLS.md：

## PikaBoard
- **API:** http://localhost:3001/api/
- **Token:** your-secret-token

Agent 运行时变量：

export PIKABOARD_API="http://localhost:3001/api"
export PIKABOARD_TOKEN="your-secret-token"
export AGENT_NAME="bulbi"

任务命令

通过 ID 引用任务：
- task 12 或 #12 → 查看任务
- move #12 to done → 变更状态
- create task "Fix bug" → 创建新任务

API 参考

完整端点文档请参阅 backend/API.md（单一权威文档）。

常用操作

列出任务：

curl -H "Authorization: Bearer $PIKABOARD_TOKEN" "$PIKABOARD_API/tasks"

创建任务：

curl -X POST -H "Authorization: Bearer $PIKABOARD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"Fix bug","status":"inbox","priority":"high","tags":["bug","backend"]}' \
  "$PIKABOARD_API/tasks"

更新状态：

curl -X PATCH -H "Authorization: Bearer $PIKABOARD_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"status":"done"}' \
  "$PIKABOARD_API/tasks/123"

枚举值

Agent 接入（简易路径）

使用辅助脚本自动为每个 Agent 映射看板：

cd pikaboard
MY_BOARD_ID="$(
  ./skills/pikaboard/scripts/setup-agent-board.sh | sed -n 's/^MY_BOARD_ID=//p' | tail -n1
)"
export MY_BOARD_ID

脚本功能：
- 读取 PIKABOARD_API、PIKABOARD_TOKEN、AGENT_NAME
- 根据 BOARD_NAME（默认为 AGENT_NAME）查找看板
- 若不存在则创建看板
- 输出 MY_BOARD_ID=<id>
- 验证 GET /api/tasks?board_id=<id>&status=up_next

可选配置：

export BOARD_NAME="Bulbi"
export BOARD_ENV_FILE="$HOME/.openclaw/agents/bulbi/.pikaboard.env"
./skills/pikaboard/scripts/setup-agent-board.sh

多 Agent 设置

每个 Agent 可拥有独立的看板。使用 board_id 参数：

curl "$PIKABOARD_API/tasks?board_id=6" -H "Authorization: Bearer $PIKABOARD_TOKEN"

看板分配示例：
- 看板 1: Pika（主看板）
- 看板 2: Tortoise（个人）
- 看板 3: Sala（工作）
- 看板 4: Evoli（VirtualPyTest）
- 看板 5: Psykokwak（EZPlanning）
- 看板 6: Bulbi（PikaBoard）
- 看板 7: Mew（创意）

验证清单

设置完成后运行：

# 1) API 可访问性
curl -s http://localhost:3001/health

# 2) 认证有效
curl -s -H "Authorization: Bearer $PIKABOARD_TOKEN" "$PIKABOARD_API/boards"

# 3) 看板映射正常
echo "$MY_BOARD_ID"

# 4) Agent 可读取自身任务队列
curl -s -H "Authorization: Bearer $PIKABOARD_TOKEN" \
  "$PIKABOARD_API/tasks?board_id=$MY_BOARD_ID&status=up_next"