ByteRover スキル（日本語版）

name: byterover
description: 作業前のコンテキスト収集で必ず使うこと。AIエージェント向けナレッジ管理。`brv` を使って `.brv/context-tree` にプロジェクトのパターン・意思決定・設計ルールを保存/検索する。既定LLMプロバイダ（ByteRover、APIキー不要）で query / curate を実行する。

`brv` CLI を使って、プロジェクトの長期記憶を管理する。
インストール: npm install -g byterover-cli
記憶は .brv/context-tree/ に人間可読のMarkdownで保存される。

認証は必須ではない。
brv query と brv curate は初期状態で利用可能。
ログインが必要なのはクラウド同期（push/pull/space）のみ。クラウド機能が不要なら無視してよい。

1. 考える前: 既存パターン把握のために brv query を実行
2. 実装後: 新しい判断/パターン保存のために brv curate を実行

概要: 知識ベースから関連コンテキストを取得する。`.brv/context-tree/` を元に、設定済みLLMが回答を合成する。

使用すべき場面:

• 過去の情報を思い出す必要がある
• 現在コンテキストに必要情報がない
• 能力・過去行動を再確認したい
• 行動前にルール/基準/好みを確認したい

使わない場面:

• 必要情報が現在コンテキストに既にある
• 一般知識で、保存済み記憶とは無関係

brv query "How is authentication implemented?"

概要: コンテキストを解析してローカル知識ベースに保存。設定済みLLMが分類・構造化する。

使用すべき場面:

• ユーザーが「覚えてほしい」と依頼した
• 意図的に知識を保存したい
• 将来再利用価値がある重要なやり取りが発生した
• 重要な事実・決定・実施内容を残したい

使わない場面:

• 同内容が既に保存済みで変化なし
• 一時的な情報・汎用知識のみ

brv curate "Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts"

ファイル同梱（最大5件・プロジェクト内のみ）:

brv curate "Authentication middleware details" -f src/middleware/auth.ts

既定ByteRover接続（APIキー不要）:

brv providers connect byterover

別プロバイダ利用:

brv providers list
brv providers connect openai --api-key sk-xxx --model gpt-4.1

クラウド同期は認証が必要。ローカル完結なら不要。

brv login --api-key sample-key-string
brv space list
brv space switch --team human-resources-team --name a-department
brv pull
brv push

• 保存先: プロジェクト内 .brv/context-tree/（Markdown）
• -f で読むファイルはプロジェクトルート内のみ（最大5）
• ByteRoverサーバー送信は brv push 実行時のみ

• Not authenticated → brv login --help
• No provider connected → brv providers connect byterover
• Connection failed / Instance crashed → brvプロセス再起動
• Token expired/invalid → 再ログイン
• Billing/Rate limit → クレジット確認 or 待機

• Missing required arguments → brv <command> --help
• Maximum 5 files allowed → -f を5件以下に減らす
• File does not exist → パス確認（相対パス推奨）
• File type not supported → 対応形式のみ使用

診断コマンド: brv status