Agent Skills
返回列表
📚

ByteRover 知识管理

知识管理 更新于 2026.08.30

将以下提示词粘贴到你的 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 嵌入工作流的工具链作者