ByteRover 知识管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-byterover-headless。
技能介绍
要解决什么问题
长期在同一个仓库里协作时,设计决策、实现细节和重复踩过的坑往往散落在 PR 评论、文档和脑子里。换人或隔几周再改模块时,很难快速找回「当时为什么这么写」。ByteRover 用 上下文树(context tree) 把这类知识结构化存起来,并通过云端与本地同步,让助手在自动化流程里也能查询和补充上下文。
技能如何工作
本技能指导 AI 通过 brv CLI 操作知识库,且面向无界面场景时一律使用 --headless --format json,便于解析返回结果。
核心流程大致如下:
- 状态检查:用
brv status --headless --format json判断当前目录是否已初始化.brv/,以及是否已登录(projectInitialized、authStatus)。 - 鉴权与初始化:未登录时用 API Key 执行
brv login;未初始化时用 team / space(名称或 ID)执行brv init --headless。 - 查询:
brv query向知识库提问,拿回与问题相关的模式、决策与实现细节;响应中可能包含检索过程信息。 - 策展:
brv curate把新结论写入上下文树,可用--files附带最多 5 个相关文件以增强上下文。 - 同步:
brv push/brv pull与 ByteRover 云端对齐;无头推送需-y跳过确认,可按分支操作。
操作前应检查 JSON 里的 success 字段;常见失败包括未认证、项目未初始化,以及 pull 前存在未推送的本地变更(需先 push)。
适用边界与注意点
brv login成功时输出的是纯文本,其余自动化步骤应坚持用 JSON 模式。- push / pull 会改动本地与云端上下文树,技能说明建议在执行前征得用户同意。
- 策展时若只给一句话摘要而不带
--files,上下文可能偏薄;涉及架构或实现变更时尽量带上关键源码文件。 - 团队与空间在 headless 初始化中是必填项,需从 ByteRover 控制台 取得 API Key 并确认 team/space 标识。
使用场景
- 在 CI 或 Agent 流水线里,落地页重构前先用 JSON 查询历史架构决策再改代码
- 结对编程结束后,把本次约定的错误处理模式写入上下文树并 push 到团队 space
- 新同事接手服务前,针对支付模块连续 query 检索既有实现细节与踩坑记录
- 发版前将本迭代的 API 变更说明 curate 进库,并附带最多 5 个相关源码文件
适合人员
- 维护微服务仓库、需要把跨 PR 的设计理由沉淀成可检索知识的后端 Tech Lead
- 用 Cursor/Claude 跑自动化改码、希望助手先查 ByteRover 再动手的平台工程师
- 负责多分支协作、需在 pull 前处理本地上下文冲突的 DevOps 或发布值班
- 编写内部 Agent 技能、要把 brv status/query 嵌入工作流的工具链作者