From 7c81ac9dd5f29b4f1ed83abaaf2b9edc346e7d05 Mon Sep 17 00:00:00 2001
From: qwenpaw-skills <qwenpaw-skills@local>
Date: Sun, 9 Aug 2026 00:35:57 +0000
Subject: [PATCH] Publish QA_source_index via gitea-publish skill

---
 SKILL.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)
 create mode 100644 SKILL.md

diff --git a/SKILL.md b/SKILL.md
new file mode 100644
index 0000000..9476d68
--- /dev/null
+++ b/SKILL.md
@@ -0,0 +1,50 @@
+---
+name: QA_source_index
+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."
+metadata:
+  builtin_skill_version: "1.2"
+  qwenpaw:
+    emoji: "🗂️"
+    requires: {}
+---
+
+# 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
+
+1. Extract the topic from the user's question (match against the left column or synonyms in the table below).
+2. 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.
+3. **Read documentation first**: `website/public/docs/<topic>.<language>.md` (use the same language as the user: `zh` / `en` / `ru`, etc.). 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 (`website/public/docs/`) | 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/skills_manager.py`, `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: `$QWENPAW_ROOT/website/public/docs/<topic>.<language>.md` (fall back to `.en.md` if the corresponding language file does not exist).
+- 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.