---
id: gh-qianwen-update-check
name: "qianwen-update-check"
url: https://skills.yangsir.net/skill/gh-qianwen-update-check
author: qianwen-ai
domain: ai-skill-platform-ecosystem
tags: ["update-check", "version-management", "skill-management", "automation"]
install_count: 4500
rating: 4.40 (120 reviews)
github: https://github.com/qianwen-ai/qianwen-ai/tree/main/skills/ops/qianwen-update-check
---

# qianwen-update-check

> 此技能自动检查 QianWen-AI 技能包的最新版本，并通知用户是否有可用更新。它通过与 GitHub 仓库对比，确保用户始终运行最新、最稳定的技能版本，从而提升开发效率和系统安全性，减少手动维护的负担。

**Stats**: 4,500 installs · 4.4/5 (120 reviews)

## Before / After 对比

### 技能版本更新效率

**Before**:

在没有此技能之前，用户需要手动访问 GitHub 仓库，查找最新版本信息，并与本地版本进行比对。这个过程耗时且容易遗漏，导致技能包长时间未更新，错失新功能或安全修复。

**After**:

此技能自动检测 QianWen-AI 技能包的最新版本，并在有更新时及时通知用户。这确保了技能始终保持最新状态，无需手动干预，显著提升了技能维护的效率和准确性。

| Metric | Before | After | Change |
|---|---|---|---|
| 发现新版本所需时间 | 720分钟 | 5分钟 | -99% |

## Readme

# Qwen Update Checker

Automatic version checker for the **QianWen-AI/qianwen-ai** skill pack. Compares the locally installed version against the latest release on GitHub and notifies the user when an update is available.

This skill is referenced by all other QianWen-AI/qianwen-ai. When any skill runs, it checks if this skill is installed and delegates version checking here.

## How It Works

1. Reads the installed version from `version.json` (the `version` field bundled with this skill).
2. Fetches the latest version from the remote repository (GitHub raw content).
3. Compares versions using semver. Returns `{"has_update": true}` if a newer version exists.
4. Records the check timestamp (`last_interaction`) in `<repo_root>/.agents/state.json` to rate-limit network requests to once every 24 hours.

## Usage

Other skills invoke this script automatically. You can also run it manually:

```bash
python3 <path-to-this-skill>/scripts/check_update.py --print-response
```

### CLI Arguments

| Argument | Description |
|----------|-------------|
| `--print-response` | Print result as formatted JSON to stdout |
| `--force` | Bypass 24-hour rate limit and check immediately |

### Output Format

```json
{
  "has_update": true
}
```

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `QWEN_SKILLS_REPO` | `QianWen-AI/qianwen-ai` | GitHub repo for remote version check |

## State File

The `last_interaction` timestamp is stored at `<repo_root>/.agents/state.json` for rate-limiting. Check results are **not** cached in the state file. This file persists across sessions and is shared with `gossamer.py` for fatigue control.


---
*Source: https://skills.yangsir.net/skill/gh-qianwen-update-check*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-qianwen-update-check/markdown*