ByteRover知识管理

技能简介

ByteRover-headless 提供命令行方式管理项目知识库，支持查询历史决策、录入新上下文、同步团队数据。通过 --headless --format json 标志实现机器可解析的输出，便于集成到自动化流程。

能做什么

• 检索项目中的模式、决策记录与实现细节
• 向上下文树添加新知识或代码关联信息
• 推送本地变更到云端，或拉取团队最新上下文
• 验证登录状态与项目初始化情况

使用说明

安装指令

npm install -g @byterover/cli

首次配置（无头模式）

1. 获取 API key：https://app.byterover.dev/settings/keys
2. 登录：brv login --api-key <key>
3. 初始化项目：brv init --headless --team <团队名> --space <空间名> --format json

常用操作

• 查询知识：brv query "问题描述" --headless --format json
• 添加上下文：brv curate "内容描述" --files src/file.ts --headless --format json
• 推送变更：brv push --headless --format json -y
• 拉取更新：brv pull --headless --format json
• 检查状态：brv status --headless --format json

输入与输出

见下方输入与输出表格。

风险提示

• 所有命令必须附加 --headless --format json 以保证输出可解析
• 推送前需确认本地变更，或使用 -y 跳过交互
• API key 需妥善保管，避免泄露
• 团队/空间名称大小写不敏感，但 ID 需完全匹配

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/byteroverinc/byterover-headless/SKILL.md
来源类型：GitHub 仓库