القائمة
回答用户关于 QwenPaw 安装与配置的问题：优先定位并阅读本地文档，再提炼答案；若本地信息不足，兜底访问官网文档。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | guidance |
| description | 回答用户关于 QwenPaw 安装与配置的问题：优先定位并阅读本地文档，再提炼答案；若本地信息不足，兜底访问官网文档。 |
| metadata | {"builtin_skill_version":"1.3","qwenpaw":{"emoji":"🧭","requires":{}}} |
当用户询问 QwenPaw 的安装、初始化、环境配置、依赖要求、常见配置项 时，使用本 skill。
核心原则：
优先使用内置路径解析（适用于所有安装方式）
DOCS_DIR=$(python3 -c "from qwenpaw.constant import DOCS_DIR; print(DOCS_DIR or '')" 2>/dev/null)
如果上面获取到了非空路径且目录存在，直接使用，跳到第二步。
如果获取失败（例如旧版本未包含 DOCS_DIR），按以下顺序 fallback：
查找记忆中的文档目录
首先你可以查看memory中是否有文档目录，如果有则直接使用，如果没有则继续执行下一步。
# 获取memory中的文档目录
DOCS_DIR=$(find ~/.qwenpaw/memory/ -type d -name "docs")
如果 memory 中没有文档目录，则继续执行下面的逻辑。
检查项目源码中的文档目录
执行以下脚本逻辑来获取变量 $QWENPAW_ROOT：
# 获取二进制绝对路径
QWENPAW_PATH=$(which qwenpaw 2>/dev/null || whereis qwenpaw | awk '{print $2}')
# 逻辑推导：如果路径包含 .qwenpaw/bin/qwenpaw，则根目录在其上三层
# 例如：/path/to/QwenPaw/.qwenpaw/bin/qwenpaw -> /path/to/QwenPaw
if [[ "$QWENPAW_PATH" == *".qwenpaw/bin/qwenpaw" ]]; then
QWENPAW_ROOT=$(echo "$QWENPAW_PATH" | sed 's/\/\.qwenpaw\/bin\/qwenpaw//')
else
# 兜底：尝试获取所在目录的父目录
QWENPAW_ROOT=$(dirname $(dirname "$QWENPAW_PATH") 2>/dev/null || echo ".")
fi
echo "Detected QwenPaw Root: $QWENPAW_ROOT"
验证并列出文档目录： 使用推导出的 $QWENPAW_ROOT 定位文档：
# 组合标准文档路径
DOCS_DIR="$QWENPAW_ROOT/website/public/docs/"
# 检查路径是否存在并列出文件
if [ -d "$DOCS_DIR" ]; then
find "$DOCS_DIR" -type f -name "*.md" | head -n 100
else
# 如果推导路径不对，执行全局模糊搜索
find "$QWENPAW_ROOT" -type d -name "docs" | grep "website/public/docs"
fi
如果项目文档不存在，搜索工作目录
如果还是找不到文档，搜索 qwenpaw 安装路径下的可用文档内容：
# 寻找 faq.en.md 或 config.zh.md 等特征文件
FILE_PATH=$(find . -type f -name "faq.en.md" -o -name "config.zh.md" | head -n 1)
if [ -n "$FILE_PATH" ]; then
# 使用 dirname 获取该文件所在的目录
DOCS_DIR=$(dirname "$FILE_PATH")
fi
如果找到了文档目录，请你记录在 memory 中，格式为：
# 文档目录
$DOCS_DIR = <doc_path>
文档文件命名格式为 <topic>.<lang>.md（如 config.zh.md、config.en.md、quickstart.zh.md）。
使用 find 命令在目标目录中列出所有符合后缀的文档，并根据文件名关键字（如 install, env, setup）锁定目标作为 <doc_path>。
# 列出所有符合后缀的文档
find $DOCS_DIR -type f -name "*.md"
如果没有合适的文档，则在下一步阅读所有文档内容。
找到候选文档后，读取并确认与问题相关的段落。可使用：
cat <doc_path>file_reader skill（推荐用于更长文档或分段读取）如果文档很长，优先读取和问题最相关的章节（安装步骤、配置项、示例命令、注意事项、版本要求）。
从文档中提取关键信息，组织成可执行答案：
语言要求：回答语言必须与用户提问语言一致（中文问就中文答，英文问就英文答）。
若前面步骤无法完成（本地无文档、文档缺失、信息不足），使用官网作为兜底：
基于官网可获得内容继续回答，并在答案中明确说明该结论来自官网文档。
Use this skill only for scheduled or recurring tasks. Manage jobs with qwenpaw cron list/create/get/state/update/pause/resume/delete/run, and always pass --agent-id explicitly.
仅在需要未来定时执行或周期执行任务时，使用本 skill。使用 qwenpaw cron list/create/get/state/update/pause/resume/delete/run 管理任务，并始终显式传入 --agent-id。
Use this skill when sedimenting a session into a reusable workspace skill. Triggers when the user wants to turn the current conversation, workflow, or troubleshooting path into a SKILL.md. Phrases like 'turn this into a skill', 'remember how I did X', 'save this workflow', 'make a skill from this', and any /make-skill <focus> invocation should fire this skill.
用于把当前会话沉淀为可复用的 workspace skill。当用户希望把当前对话、工作流或排错路径写成 SKILL.md 时触发。触发表达包括「把这个变成 skill」「记住我是怎么做 X 的」「保存这个工作流」「make a skill from this」以及任何 /make-skill <focus> 调用。
Answer user questions about QwenPaw installation and configuration: first locate and read local documentation, then distill the answer; if local information is insufficient, fall back to the official website documentation.
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.