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
• 对于知识库范围之外的问题，可以依据一般知识作答，但要指出这一缺口
• 可以同时搜索多个知识库，以获取跨领域见解