Agent Skills › agentscope-ai/QwenPaw › QA_source_index

QA_source_index

GitHub

将用户问题映射至QwenPaw文档和源码路径，辅助QA Agent快速定位安装、配置及功能相关文件的参考索引。

src/qwenpaw/agents/skills/QA_source_index-en/SKILL.md agentscope-ai/QwenPaw

触发场景

查询软件安装或配置方法询问特定功能模块的源码位置需要快速查找官方文档路径

安装

npx skills add agentscope-ai/QwenPaw --skill QA_source_index -g -y

更多选项

非标准路径

npx skills add https://github.com/agentscope-ai/QwenPaw/tree/main/src/qwenpaw/agents/skills/QA_source_index-en -g -y

不安装直接使用

npx skills use agentscope-ai/QwenPaw@QA_source_index

指定 Agent (Claude Code)

npx skills add agentscope-ai/QwenPaw --skill QA_source_index -a claude-code -g -y

安装 repo 全部 skill

npx skills add agentscope-ai/QwenPaw --all -g -y

预览 repo 内 skill

npx skills add agentscope-ai/QwenPaw --list

SKILL.md

Frontmatter

{
    "name": "QA_source_index",
    "metadata": {
        "qwenpaw": {
            "emoji": "🗂️",
            "requires": []
        },
        "builtin_skill_version": "1.3"
    },
    "description": "Maps topics and keywords from user questions to QwenPaw official documentation paths and common source code entry points, reducing blind searching. Intended for the built-in QA Agent to quickly identify which files to read when answering questions about installation, configuration, skills, MCP, multi-agent, memory, CLI, etc."
}

Documentation and Source Code Quick Reference

When answering questions about installation, configuration, or behavioral principles, first classify by keyword, then open 1–2 paths most likely to contain the answer from the table below, avoiding aimless directory traversal.

Usage Steps

Extract the topic from the user's question (match against the left column or synonyms in the table below).
Resolve $QWENPAW_ROOT: use which qwenpaw to get the executable path. If it is …/.qwenpaw/bin/qwenpaw, the source root is three levels up (consistent with the guidance skill); otherwise, determine it from the user-provided installation path.
Resolve $DOCS_DIR first (cross-install compatible): run python3 -c "from qwenpaw.constant import DOCS_DIR; print(DOCS_DIR or '')" 2>/dev/null. If it returns a valid path, use it directly. Otherwise, fallback to $QWENPAW_ROOT/website/public/docs/.
Read documentation first: $DOCS_DIR/<topic>.<language>.md (use the same language as the user: zh / en.). If that is insufficient, read the source entry points listed in the table.

Topic / Keywords → Preferred Documentation and Source Code

Topic or Keywords (examples)	Preferred Documentation (`$DOCS_DIR/`)	Common Source Entry Points (relative to `$QWENPAW_ROOT`)
Installation, dependencies, getting started	`quickstart`, `intro`	`src/qwenpaw/cli/`, `pyproject.toml`
Configuration, config.json, environment variables	`config`	`src/qwenpaw/config/config.py`, `src/qwenpaw/constant.py`
Skills, SKILL, skill_pool, built-in skills	`skills`	`src/qwenpaw/agents/skill_system/`, `src/qwenpaw/agents/skills/`
MCP, plugins	`mcp`	`src/qwenpaw/app/routers/` (grep `mcp` as needed)
Multi-agent, workspace, agent, built-in QA	`multi-agent`	`src/qwenpaw/app/routers/agents.py`, `src/qwenpaw/app/migration.py`, `src/qwenpaw/constant.py` (`BUILTIN_QA_AGENT_ID`, etc.)
Memory, MEMORY, memory_search	`memory`	`src/qwenpaw/agents/memory/memory_manager.py`, `src/qwenpaw/agents/tools/memory_search.py`
Console, frontend	`console`	`console/`
CLI, subcommands, init	`cli`	`src/qwenpaw/cli/` (e.g., `init_cmd.py`)
Channels, sessions	`channels`	Search for `channels` keyword under `src/qwenpaw`
Context, window	`context`	`config` docs + related logic in `src/qwenpaw/agents/`
Models, API Key	`models`	`src/qwenpaw/config/config.py`
Heartbeat, HEARTBEAT	`heartbeat`	Search for `heartbeat` / `HEARTBEAT` under `src/qwenpaw`
Desktop client	`desktop`	`desktop/` (if present in the repository)
Security	`security`	Read `security.<lang>.md` first
Errors, FAQ	`faq`	Read `faq.<lang>.md` first, then examine source code as needed
Commands and slash commands	`commands`	CLI/command registration modules under `src/qwenpaw` (search as needed)

Conventions

Full documentation path: $DOCS_DIR/<topic>.<language>.md (fall back to .en.md if the corresponding language file does not exist). Prefer DOCS_DIR from qwenpaw.constant; fallback to $QWENPAW_ROOT/website/public/docs/.
The source entry points in the table are starting points; use read_file or targeted grep to narrow down to specific symbols — do not read through an entire large directory listing at once.

Notes

This skill does not replace read_file: after identifying candidate paths, you should immediately read and verify the content.
If a path does not exist locally (e.g., an installation tree without source code), use the installed documentation package or the root directory provided by the user, and clearly state which path you are relying on.