用途：读取与管理 Zergboard 的看板、卡片与知识库，用于查看/搜索卡片、创建或移动工作项、查看分配给自己的任务等。
接口选择：日常读取、搜索、快速创建/更新/移动卡片与评论用 zergboard_skill.py，它支持看板名、卡片前缀（如 CES）、外部 ID（如 CES-1）、工作区名等友好标识；管理员、令牌、邀请、标签、子任务、依赖、知识库、导入、看板拆分、工作区运行等完整功能用 zb CLI，多数参数需 UUID。
认证与配置：Python 辅助脚本读取 ~/.claude/skills/zergboard-skill/config.json（含 base_url、api_token、default_organization_id）。zb CLI 二进制位于 ~/.claude/skills/zergboard-skill/bin/zb，缺失时需重新构建；配置默认 ~/.zergboard/zb.json，可用环境变量 ZB_CONFIG_PATH、ZB_BASE_URL、ZB_API_TOKEN、ZB_SESSION_TOKEN、ZB_CURRENT_ORG_ID 覆盖。可复用 Python 配置中的令牌：export ZB_API_TOKEN=$(python3 -c "import json;print(json.load(open('$HOME/.claude/skills/zergboard-skill/config.json'))['api_token'])")。
主要命令：Python 辅助脚本提供 my-cards、workspaces、boards、cards、card、cycle、search、create、update、move、reorder、comments、comment、invite-guest。zb CLI 覆盖认证/令牌、组织与成员、看板、卡片（含子任务、依赖）、知识库（kb ls/cat/find）、工作区会话与运行、Linear/Notion/Jira/Trello 导入及 TUI。
限制：zb CLI 跨组织令牌限制、移动卡片参数组合、关闭看板拒绝写入、board split apply 需 --confirm-reviewed、token create 仅显示一次原始令牌、卡片并发编辑可能返回 409 需重读重试。TUI 不适合自动化非 TTY 环境。