---

name: knowledge description: Search WeKnora knowledge base for documentation, guides, and best practices. Use when user asks "how to", "what is", or needs configuration guides, feature docs, usage instructions, or troubleshooting steps.

Knowledge Base Skill

Search the WeKnora knowledge base with intelligent tag filtering for precise results. Supports hybrid search (keyword + vector).

When to Use

• User asks "how to use", "how to configure", "what is"
• Questions about product features, usage guides, API docs
• Best practices, configuration examples
• Keywords: usage, configuration, feature, guide, document, how to, 如何, 怎么, 配置, 使用

Workflow

1. Get tags first - Understand available knowledge categories
2. Match tags - Select appropriate tags based on user query
3. Search - Use tag filtering for better precision

Scripts

1. Get Available Tags

Fetch all tags to understand knowledge structure:

Copyuv run python .claude/skills/knowledge/scripts/get_tags.py

Output: JSON with tags array containing name and description for each tag

2. Search Knowledge

Search with optional tag filtering:

Copyuv run python .claude/skills/knowledge/scripts/search.py -q "your query" --tags '["tesla"]'

Output: JSON with results array containing content, score, metadata

Tag Mapping Guide

Examples

Search with tag filtering (recommended)

Copyuv run python .claude/skills/knowledge/scripts/search.py -q "如何配置网关" --tags '["tesla"]'

Search with multiple tags

Copyuv run python .claude/skills/knowledge/scripts/search.py -q "部署流水线" --tags '["miline"]' --tag-mode any

Search without tags (fallback)

Copyuv run python .claude/skills/knowledge/scripts/search.py -q "系统架构设计"