# Guidance

回答用户关于 QwenPaw 安装与配置的问题：优先定位并阅读本地文档，再提炼答案；若本地信息不足，兜底访问官网文档。

- Repository: https://github.com/agentscope-ai/QwenPaw (37135 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add agentscope-ai/QwenPaw --skill guidance -g -a claude-code -y`
Codex: `npx skills add agentscope-ai/QwenPaw --skill guidance -g -a codex -y`
Cursor: `npx skills add agentscope-ai/QwenPaw --skill guidance -g -a cursor -y`
Gemini CLI: `npx skills add agentscope-ai/QwenPaw --skill guidance -g -a gemini-cli -y`

## Description

回答用户关于 QwenPaw 安装与配置的问题：优先定位并阅读本地文档，再提炼答案；若本地信息不足，兜底访问官网文档。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# QwenPaw 安装与配置问答指南

当用户询问 **QwenPaw 的安装、初始化、环境配置、依赖要求、常见配置项** 时，使用本 skill。

核心原则：

- 先查本地文档，再回答
- 回答要基于已读到的内容，不臆测
- 回答语言与用户提问语言保持一致

## 标准流程


### 第一步：定位文档位置

**优先使用内置路径解析（适用于所有安装方式）**

```bash
DOCS_DIR=$(python3 -c "from qwenpaw.constant import DOCS_DIR; print(DOCS_DIR or '')" 2>/dev/null)
```

如果上面获取到了非空路径且目录存在，直接使用，跳到第二步。

如果获取失败（例如旧版本未包含 DOCS_DIR），按以下顺序 fallback：

**查找记忆中的文档目录**

首先你可以查看memory中是否有文档目录，如果有则直接使用，如果没有则继续执行下一步。

```bash
# 获取memory中的文档目录
DOCS_DIR=$(find ~/.qwenpaw/memory/ -type d -name "docs")
```

如果 memory 中没有文档目录，则继续执行下面的逻辑。

**检查项目源码中的文档目录**

执行以下脚本逻辑来获取变量 $QWENPAW_ROOT：

```bash
# 获取二进制绝对路径
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 定位文档：

```bash
# 组合标准文档路径
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 安装路径下的可用文档内容：

```bash
# 寻找 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 中，格式为：

```markdown
# 文档目录
$DOCS_DIR = <doc_path>
```

### 第二步：文档检索与匹配

文档文件命名格式为 `<topic>.<lang>.md`（如 `config.zh.md`、`config.en.md`、`quickstart.zh.md`）。

使用 find 命令在目标目录中列出所有符合后缀的文档，并根据文件名关键字（如 install, env, setup）锁定目标作为 <doc_path>。

The rest: https://github.com/agentscope-ai/QwenPaw/blob/HEAD/src/qwenpaw/agents/skills/guidance-zh/SKILL.md