用途:初始化一个新的写书项目,核心产出是一份 Book Requirements Document(BRD),由 brd-creator 智能体通过结构化提问引导生成。
主要能力与流程:先检查 SurrealDB 是否运行(通过 docker ps 查找 bookstrap-db),未运行则执行 docker-compose up -d 启动并等待;再运行 ./scripts/init-schema.sh 初始化表、字段与索引;随后由 brd-creator 逐题询问核心信息(标题、体裁、字数目标、受众)、主旨与前提、结构(格式、视角、时态、时间线)、语气与可比作品、角色或概念、研究来源与 URL、约束条件等,生成 BRD.md 并存入 SurrealDB 的 brd 表。之后创建 manuscript、research、logs、data 目录,按需生成 .gitignore,并在缺失时从模板复制 bookstrap.config.json,最后检查 .env 中的嵌入 API 密钥(GEMINI_API_KEY 或 OPENAI_API_KEY)并给出提示。
使用方式:以命令形式传入书籍概念($ARGUMENTS),按提示逐项回答,完成后返回 BRD 位置与版本、数据库状态、已建目录、配置文件状态以及下一步(如 /bookstrap-ingest 导入研究资料)。
限制与说明:依赖 Docker 与 docker-compose 环境运行 SurrealDB;需要准备嵌入服务 API 密钥,否则仅提示警告;BRD 可后续编辑并重新导入数据库;概念描述可简可详,智能体会追问补齐细节。