PikaBoard

该技能用于与 PikaBoard 任务管理 API 交互，支持创建、更新、列出任务，按 board 管理多智能体看板；包含环境配置、API 调用示例和初始化脚本，使用 PIKABOARD_TOKEN 认证。

angelstreet

热度 90.10

最近更新 2026-05-11 15:54:25

分类：协作依赖：代码执行 / 读写文件 / 第三方 API应用场景：任务管理 / API 集成 / 工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pikaboard

Metadata

name: pikaboard
description: Interact with PikaBoard task management API. Use when creating, updating, listing, or managing tasks. Agent-first kanban for AI teams. Triggers on: tasks, kanban, board, todo, backlog, sprint.
metadata: {"openclaw":{"emoji":"📋","requires":{"bins":["node","npm"]},"install":[{"id":"clone","kind":"git","repo":"https://github.com/angelstreet/pikaboard","branch":"main","label":"Clone PikaBoard repository"},{"id":"backend","kind":"script","cwd":"pikaboard/backend","run":"npm install && npm run build","label":"Install backend dependencies"},{"id":"frontend","kind":"script","cwd":"pikaboard/frontend","run":"npm install && npm run build","label":"Build frontend"},{"id":"env","kind":"prompt","message":"Create .env with DATABASE_PATH and PIKABOARD_TOKEN","label":"Configure environment"}]}}

PikaBoard

Agent-first task/kanban dashboard. PikaBoard is the source of truth for tasks.

Quick Start

After install, start the server:

cd pikaboard/backend && npm start

Access dashboard at http://localhost:3001

Configuration

Create backend/.env:

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

Add to your TOOLS.md:

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

Agent runtime variables:

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

Task Commands

Reference tasks by ID:

task 12 or #12 → view task
move #12 to done → status change
create task "Fix bug" → new task

API Reference

See backend/API.md for full endpoint documentation (single canonical doc).

Common Operations

List tasks:

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

Create task:

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"

Update status:

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

Enums

Field	Values
status	`inbox`, `up_next`, `in_progress`, `testing`, `in_review`, `done`, `rejected`
priority	`low`, `medium`, `high`, `urgent`

Agent Onboarding (Simple Path)

Use the helper to map each agent to a board automatically:

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

What it does:

Reads PIKABOARD_API, PIKABOARD_TOKEN, AGENT_NAME
Finds board by BOARD_NAME (default: AGENT_NAME)
Creates board if missing
Prints MY_BOARD_ID=<id>
Verifies GET /api/tasks?board_id=<id>&status=up_next

Optional:

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

Multi-Agent Setup

Each agent can have their own board. Use board_id parameter:

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

Board assignments:

Board 1: Pika (main)
Board 2: Tortoise (personal)
Board 3: Sala (work)
Board 4: Evoli (VirtualPyTest)
Board 5: Psykokwak (EZPlanning)
Board 6: Bulbi (PikaBoard)
Board 7: Mew (Ideas)

Validation Checklist

Run after setup:

# 1) API reachable
curl -s http://localhost:3001/health

# 2) Auth works
curl -s -H "Authorization: Bearer $PIKABOARD_TOKEN" "$PIKABOARD_API/boards"

# 3) Board mapping works
echo "$MY_BOARD_ID"

# 4) Agent can read own queue
curl -s -H "Authorization: Bearer $PIKABOARD_TOKEN" \
  "$PIKABOARD_API/tasks?board_id=$MY_BOARD_ID&status=up_next"