feat: add auth command

.qwen/skills/qwen-code-claw/SKILL.md

@@ -1,71 +1,201 @@
 ---
 name: qwen-code-claw
-description: 使用QwenCode作为Code Agent完成代码理解、项目生成、feature、fix bug、重构等各种编程相关需求
+description: Use Qwen Code as a Code Agent for code understanding, project generation, features, bug fixes, refactoring, and various programming tasks
 ---
 
-# qwen-code
+# Qwen Code Claw
 
-## When to use this skill
+## When to Use This Skill
 
-## What qwen-code is
+Use this skill when you need to:
+
+- Understand codebases or ask questions about source code
+- Generate new projects or add new features
+- Review pull requests in the codebase
+- Fix bugs or refactor existing code
+- Execute various programming tasks such as code review, testing, documentation generation, etc.
+- Collaborate with other tools and agents to complete complex development tasks
 
 ## Install
 
 ```bash
-npm i -g @qwen-code/qwen-code
+npm install -g @qwen-code/qwen-code
 ```
 
 For normal session reuse, prefer a global install over `npx`.
 
-## acpx
+## Authentication
 
-You should always use acpx to run qwen-code over the Agent Client Protocol
-(ACP) instead of scraping PTY sessions.
+Check if authentication is already configured:
 
-Please do the following to use acpx:
+```bash
+qwen auth status
+```
 
-1. Install acpx globally (recommended) or use npx:
+If authentication exists, skip this section. If not authenticated, check if the `BAILIAN_CODING_PLAN_API_KEY` environment variable exists:
+
+```bash
+echo $BAILIAN_CODING_PLAN_API_KEY
+```
+
+**If `BAILIAN_CODING_PLAN_API_KEY` exists**, authenticate directly:
+
+```bash
+qwen auth code-plan --region china --key $BAILIAN_CODING_PLAN_API_KEY
+```
+
+**If the environment variable does not exist**, interrupt and prompt the user to authenticate via `qwen-oauth` or `code-plan`:
+
+```bash
+qwen auth
+```
+
+Or configure custom API after launching Qwen Code via `/auth`.
+
+## ACPX Integration
+
+You should always use `acpx` to run Qwen Code over the Agent Client Protocol (ACP) instead of scraping PTY sessions.
+
+To use acpx:
+
+1. **Install acpx globally** (recommended) or use npx:
+
+   ```bash
    npm install -g acpx@latest
+   ```
 
    Or without installing:
+
+   ```bash
    npx acpx@latest
+   ```
 
-2. Install the acpx skill so you have the full reference available:
+2. **Install the acpx skill** for full reference:
+
+   ```bash
    npx acpx@latest --skill install acpx
+   ```
 
-3. Read the acpx skill reference so you know every command, flag, and
-   workflow pattern:
-   https://raw.githubusercontent.com/openclaw/acpx/main/skills/acpx/SKILL.md
+3. **Read the acpx skill reference** for every command, flag, and workflow pattern:
+   See the [ACPX Reference](#acpx-reference) section below for details
 
-4. If you need the full CLI reference with all options and examples:
+4. **For complete CLI reference with all options and examples**:
    https://raw.githubusercontent.com/openclaw/acpx/main/docs/CLI.md
 
-From now on, when you need to delegate work to qwen-code, use acpx
-instead of spawning raw terminal sessions. For example:
+From now on, when you need to delegate work to Qwen Code, use `acpx` instead of spawning raw terminal sessions. For example:
+
+```bash
 npx acpx@latest qwen "fix the failing tests"
 npx acpx@latest qwen "refactor the auth module"
 npx acpx@latest qwen exec "one-shot: summarize this repo"
+```
 
-通常情况下，你应该使用approval-all参数来防止任务中断
+> **Tip:** You should typically use the `--approve-all` flag to prevent task interruptions.
 
-## Practical workflows
+## Practical Workflows
 
-Persistent repo assistant:
+### Persistent Repository Assistant
 
 ```bash
 acpx qwen 'inspect failing tests and propose a fix plan'
 acpx qwen 'apply the smallest safe fix and run tests'
 ```
 
-One-shot script step:
+### One-Shot Script Steps
 
 ```bash
 acpx qwen exec 'summarize repo purpose in 3 lines'
 ```
 
-Parallel named streams:
+### Parallel Named Streams
 
 ```bash
 acpx qwen -s backend 'fix API pagination bug'
 acpx qwen -s docs 'draft changelog entry for release'
 ```
+
+### Queue Follow-ups Without Waiting
+
+```bash
+acpx qwen 'run full test suite and investigate failures'
+acpx qwen --no-wait 'after tests, summarize root causes and next steps'
+```
+
+### Machine-Readable Output for Orchestration
+
+```bash
+acpx --format json qwen 'review current branch changes' > events.ndjson
+```
+
+### Repository-Wide Review with Permissive Mode
+
+```bash
+acpx --cwd ~/repos/my-project --approve-all qwen -s pr-123 \
+  'review PR #123 for regressions and propose minimal patch'
+```
+
+## Approval Modes
+
+- `--approve-all`: No interactive prompts
+- `--approve-reads` (default): Auto-approve reads/searches, prompt for writes
+- `--deny-all`: Deny all permission requests
+
+If every permission request is denied/cancelled and none are approved, `acpx` exits with permission denied.
+
+## Best Practices
+
+1. Use **named sessions** for organizing different types of development tasks
+2. Use `--no-wait` for long-running tasks to avoid blocking
+3. Use `--approve-all` for non-interactive batch operations
+4. Use `--format json` for automation and script integration
+5. Use `--cwd` to manage context across multiple projects
+
+## ACPX Reference
+
+### Built-in Agent Registry
+
+Well-known agent names resolve to commands:
+
+- `qwen` → `qwen --acp`
+
+### Command Syntax
+
+```bash
+# Default (prompt mode, persistent session)
+acpx [global options] [prompt text...]
+acpx [global options] prompt [options] [prompt text...]
+
+# One-shot execution
+acpx [global options] exec [options] [prompt text...]
+
+# Session management
+acpx [global options] cancel [-s <name>]
+acpx [global options] set-mode <mode> [-s <name>]
+acpx [global options] set <key> <value> [-s <name>]
+acpx [global options] status [-s <name>]
+acpx [global options] sessions [list | new [--name <name>] | close [name] | show [name] | history [name] [--limit <count>]]
+acpx [global options] config [show | init]
+
+# With explicit agent
+acpx [global options] <agent> [options] [prompt text...]
+acpx [global options] <agent> prompt [options] [prompt text...]
+acpx [global options] <agent> exec [options] [prompt text...]
+```
+
+> **Note:** If prompt text is omitted and stdin is piped, `acpx` reads prompt from stdin.
+
+### Global Options
+
+| Option                | Description                                                  |
+| --------------------- | ------------------------------------------------------------ |
+| `--agent <command>`   | Raw ACP agent command (fallback mechanism)                   |
+| `--cwd <directory>`   | Session working directory                                    |
+| `--approve-all`       | Auto-approve all requests                                    |
+| `--approve-reads`     | Auto-approve reads/searches, prompt for writes (default)     |
+| `--deny-all`          | Deny all requests                                            |
+| `--format <format>`   | Output format: `text`, `json`, `quiet`                       |
+| `--timeout <seconds>` | Maximum wait time (positive integer)                         |
+| `--ttl <seconds>`     | Idle TTL for queue owners (default: `300`, `0` disables TTL) |
+| `--verbose`           | Verbose ACP/debug logs to stderr                             |
+
+Flags are mutually exclusive where applicable.