kb-advisor

ナレッジベースアドバイザー

チームのナレッジベースリポジトリを検索し、回答をまとめます。

設定

ナレッジベースは superskills setup の実行時に設定され、~/.superskills/knowledge.conf に保存されます。

# Check configured knowledge bases
cat ~/.superskills/knowledge.conf

各行の形式は次のとおりです：name|path|description

例：

docs|~/.superskills/knowledge/docs|Internal documentation and architecture decisions
research|~/.superskills/knowledge/research|Market research and competitive analysis

ワークフロー

1. 利用可能なナレッジを見つける

# List configured knowledge bases
cat ~/.superskills/knowledge.conf | while IFS='|' read -r name path desc; do
  path="${path/#\~/$HOME}"
  if [ -d "$path" ]; then
    count=$(find "$path" -name "*.md" -o -name "*.txt" -o -name "*.html" | wc -l | tr -d ' ')
    echo "  [$name] $count files — $desc"
  else
    echo "  [$name] NOT CLONED — $path"
  fi
done

2. ナレッジベースを横断して検索する

# Search all knowledge bases for a topic
for kb_path in $(awk -F'|' '{print $2}' ~/.superskills/knowledge.conf); do
  kb_path="${kb_path/#\~/$HOME}"
  [ -d "$kb_path" ] && grep -rli "search terms" "$kb_path" --include="*.md" --include="*.txt" --include="*.html"
done

3. アドバイスをまとめる

• 関連性の高いファイル（上位3～5件）を読みます
• 出典（ファイル名とパス）を明記して、具体的な箇所を引用します
• 複数の情報源で意見が一致している場合や異なる場合は、相互に照らし合わせます
• 抽象的な原則を、ユーザーの具体的な状況に結び付けます

4. ナレッジベースを更新する（任意）

会話から、保存する価値のある新しい知見が得られた場合：

# Add new knowledge to the appropriate repo
echo "content" > <kb-path>/new-insight.md

# Commit the update
cd <kb-path> && git add -A && git commit -m "Add: <topic>"

ヒント

• 必ず具体的な出典ファイルを明記します
• ナレッジベースにトピックの情報がない場合は、その旨を伝え、情報を捏造しないでください
• 最新版の取得を提案します：cd <kb-path> && git pull
• ナレッジベースの範囲外の質問には一般知識に基づいて回答し、情報が不足していることを伝えます
• 複数のナレッジベースをまとめて検索すると、分野横断的な知見を得られます