用途 busa-rnd 是一个轻量的研发工作台模板,面向希望由编程智能体承担大部分记账工作的团队。人负责提出需求和做决策;智能体把需求转成任务、在编码过程中持续回写、把完成的工作打包提交验收,并撰写周报。整套流程按每周闭环运行:需求 → 任务 → 代码与 PR → 合并后写入一条变更记录 → 交付验收 → 由人验收通过,再由周报汇总已交付、进行中、仍缺什么以及需要决策的事项。
主要能力 模板定义了一份所有智能体共享的数据契约,包含六张表:
- products(产品):每个产品一行,含 product-key(稳定的 kebab-case 短标识,用于分支名和仓库指针块,一经使用不可更改)、status(active 在研 / maintenance 维护中 / planned 规划中 / retired 已下线)、owner、repos(每行一个仓库 URL,一个仓库只属于一个产品)、try-at(验收试用位置,如 staging URL、沙箱、测试账号,不含密码)等。
- projects(项目):属于某个产品、有目标和目标日期的工作,含 status、health(on-track / at-risk / off-track)、goal、latest-update 与 updated-on。
- tasks(任务):每个需求、缺陷与改进,含 type、status(backlog → todo → in-progress → in-review → done,或 canceled)、priority、assignee、requester、acceptance(可测试的验收描述)以及 pr-url、completed-on。
- changelog(变更记录):每条已合并改动一行,title 用非工程人员能理解的平实语句描述用户可见变化,含 kind、product、task、merged-on、version、pr-url(去重键)、repo、author、verification(未验证需如实写明,不能留空)。
- deliveries(交付验收):按“用户现在能做什么”而非按 PR 分组,可包含多个任务和变更;含 status(preparing → ready → accepted / changes-requested)、how-to-verify(带编号步骤)、evidence、submitted-on、acceptor、decided-on、feedback。
- reports(周报与产出):weekly / release / other,status 分 draft(由智能体撰写)与 final(由人定稿),含 period-start、period-end、summary 与 Markdown 正文 body。 此外,模板附带只读的 AirApp 概览界面,展示最近七天概况、“需要你处理”队列、周报阅读器、验收队列、任务板、项目、变更记录和产品;它通过查看者自身会话读取六张表,不写入任何内容。
使用方式 模板通过三个角色技能分工协作:rnd-prd 负责任务创建与梳理、将已合并工作打包为交付、撰写验收步骤并记录人工验收结果;rnd-coder 负责连接代码仓库、领取任务、跟踪分支/PR/合并并写入变更记录、补录未登记的合并;rnd-pmo 负责登记产品与项目、更新项目健康度、撰写周报与发布说明。 定位工作台时须依据其 stamp(appId 为 busa-rnd、resourceKey 为 app-root)而非名称,避免误用其他文件夹中的同名数据。各表按 resourceKey(products、projects、tasks、changelog、deliveries、reports)查找;若打印出多个工作台,应先询问用户,不得自行挑选。 写入采用变更请求方式,可省略 autoMerge:有写权限的密钥会直接落地,较弱权限则进入审核队列,两者都属正常。例如: npx busabase-cli bases create-change-request --base-id <tasks base id> --fields-json @task.json --message "Add task: Apple Pay on web checkout — requested by Sales" npx busabase-cli records change-request --record-id <id> --operation update --fields-json '{"status":"in-review","pr-url":"https://…/pull/425"}' --message "Move 'Delivery-date estimate' to review — PR #425 opened" 查询使用有界、带过滤的语句:records list 支持 --value-filters-json(精确过滤)与 --sort-json(排序需带 "fieldType":"date" 才生效),每页最多 100 行,可跟随 nextCursor 翻页,值在 headCommit.payload 中返回;records group-by 可按状态做精确计数。例如: npx busabase-cli records list --base-id <changelog base id> --limit 50 --output json --value-filters-json '[{"fieldSlug":"merged-on","operator":"gte","value":"2026-10-12"}]' --sort-json '{"fieldSlug":"merged-on","fieldType":"date","direction":"desc"}' npx busabase-cli records group-by --base-id <tasks base id> --field-slug status 取值以选择项 id 写入(如 in-progress)而非显示名;日期格式为 YYYY-MM-DD;关系字段使用记录 id 数组。写入前应先检索是否已有对应行(变更按 pr-url、任务与交付按标题和产品),优先更新而非新建重复行。
适用场景 适合由编程智能体承担大量登记工作的小型研发团队,用一张工作台统一管理产品、项目、任务、用户可读的变更记录、交付验收和周报,保持“每周闭环”的节奏。
限制与边界 智能体不得仅凭自身判断验收交付或定稿周报;accepted、changes-requested 和 final 只能依据对话中人的明确表述设置。不得在未经负责人同意时修改已有任务的优先级、截止日期或所属项目(只可提议);新建任务时仅当请求者明确说明才填写这些字段。报告和交付只能描述已存在的记录,若事件没有对应行,应先补行或说明缺失。不做删除:应取消任务(canceled)或将产品置为 retired,以保留历史。不得在字段中存储凭据,GitHub/GitLab 令牌保留在智能体自身环境中。除非用户明确要求,智能体不得批准或合并自己提交的变更请求。Busabase 本身不按计划自动运行,周报需借助智能体已有的调度器(如 Claude Code 例程、cron、Codex 自动化)每周一早上以“Write last week's R&D weekly report”提示运行,再由人阅读定稿。