用途:在 Claude Code 中通过 curl 直接调用 GitBook REST API(https://api.gitbook.com/v1),完成文档变更请求(CR)的创建、内容推送与评审闭环,无需离开编辑器。它是 cr-review(评审方)的创作侧配套技能,所有操作均为普通 HTTP 调用,没有 CLI 或辅助脚本。
主要能力:创建变更请求、推送内容(更新已有页面、新建页面、插入文件、回滚页面)、请求评审人、拉取与回复评论、解决评论,并解析站点预览链接。内容变更操作包括 update_page(文档或元数据、重命名、移动)、insert_page、delete_page、insert_files、revert_page。
使用方式:需在 PATH 中具备 curl 与 jq,并在仓库根 .env 中配置 GITBOOK_TOKEN(在 GitBook 开发者页面创建),Slack 通知需 SLACK_WEBHOOK_URL。会话中定义 gbapi 辅助函数加载令牌并调用 API,所有响应经 jq 解析。创建 CR、指派评审人、发送 Slack、解决评论等状态变更操作需先获得明确确认。
限制:markdown 往返有损,推送前需自行处理重复 H1 与多行 {% %} 块;预览链接不在 CR 响应中,需单独解析站点;预览仅当空间挂载到已发布站点时存在;Git Sync 需在 GitBook UI 手动配置;本流程不执行合并。