用途:为 Grok Ship 提供工厂式待办管理。事实来源是本地 SQLite 数据库 factory.db,而非聊天记录。数据库位于共享 Grok Bot 电脑上的 /home/box/agent-data/grok-ship/factory.db,需先创建父目录,路径固定,不得另建第二个数据库。Scout 报告放在同目录的 /home/box/agent-data/grok-ship/reports/ 下,每个任务 id 一个文件。
主要能力:提供 projects 与 tasks 两张表的建表语句(见资料,含 id、name、crewmate_id、repos、source_control、created_at 以及 kind、title、prompt、project_id、repo、branch、status、gate_kind、gate_ref、result、updated_at 等字段)。projects.repos 是仓库 slug 或 URL 的 JSON 数组,source_control 可为 github、gitlab、bitbucket 或 origin。tasks.kind 仅 scout、ship、decision,不得添加 triage;status 为 queued、underway、blocked、done、cancelled;result 是结果指针(scout 报告路径或 ship 的 PR URL);gate_kind 可选 after-task、at-time、captain。schema 刻意精简,不应推测性增表。
使用方式:库不存在则创建并执行 schema,已存在则不要随意迁移,把路径报告给 Firstmate。Intake 时 Firstmate 先写任务行,再把任务 id 复用于 crewmate 消息;提示应写明目标、验收标准和约束。Triage 唤醒留在聊天或 cron,不写 factory.db,不得用 kind=triage,也不得记为 scout 或 ship。仓库已有 project 行则复用其 crewmate,不覆盖 crewmate_id,不为同一仓库插第二行;无 project 行则插入一行并记录 crewmate_id、repos、source_control;非软件工作归入保留的默认 project 行(repos []、无 source_control)。captain 批准实施时,把同一行 kind 改为 ship 并交回 crewmate,附带 scout 报告,不新建重复任务。crewmate 随时更新 status、branch、result、updated_at,done 表示 result 已含指针。
限制:不要只把队列留在聊天里,不为 triage 写行,不加 triage 类型,不每个项目建一个 Firstmate,记录 source_control 时不要假定 GitHub,不加角色列,不发明第二张映射表。资料未提供安装命令与价格等信息。