# Skill Updater

> 技能版本更新機制。指示 AI Agent 直接透過工具讀取遠端 GitHub 倉庫，比對 public/SKILLS/ 內技能的差異並執行自動化更新流程。

- **Type:** Skill
- **Install:** `agentstack add skill-eric861129-skills-all-in-one-skill-updater`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [eric861129](https://agentstack.voostack.com/s/eric861129)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [eric861129](https://github.com/eric861129)
- **Source:** https://github.com/eric861129/SKILLS_All-in-one/tree/main/.agent/skills/skill-updater
- **Website:** http://huangchiyu.com/SKILLS_All-in-one/

## Install

```sh
agentstack add skill-eric861129-skills-all-in-one-skill-updater
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Skill Updater (技能版本更新機制)

此技能定義了 AI Agent 如何自主檢查並同步 `SKILLS_All-in-one` 平台中位於 `public/SKILLS/` 內的公共技能，確保其安全性與遠端來源保持一致。

## 🚀 核心工作流 (Agent-Driven Update Pipeline)

當接收到「檢核更新」任務時，AI Agent **必須** 執行以下動作：

### Step 1: 遠端探索與內容比對 (Discovery & Diff)
1. **讀取元數據**：從 `@src/data/skills.ts` 取得技能的 `githubUrl`。
2. **定位本地路徑**：僅針對路徑位於 `@public/SKILLS/` 下的技能執行檢查。
3. **獲取遠端內容**：使用 `web_fetch` 讀取遠端路徑下的 `SKILL.md` (原始碼)。
   - *提示*：確保將 GitHub Tree URL 轉換為 `raw.githubusercontent.com` 下載路徑。
4. **執行比對**：將遠端 `SKILL.md` 的內容與本地 `public/SKILLS/` 目錄下的 `SKILL.md` 進行內容比對。
5. **判定異動**：若內容不一致或遠端 YAML 中的 `version` 較新，則標記為「待更新」。

### Step 2: 抓取新版 (Import Phase)
- **調用邏輯**：參考 `github-skill-importer`。
- **目標**：將遠端技能目錄下的所有檔案（含輔助腳本與資源）下載至臨時暫存區 `@public/SKILLS/Uncategorized/tmp-update-{FolderName}/`。

### Step 3: 安全審查 (Audit Phase)
- **調用技能**：`skill-security-auditor`
- **目標**：對暫存區的新檔案執行代碼掃描，產出《更新安全審查報告》。
- **規則**：結果必須為 `PASS` 方可繼續。

### Step 4: 原子化更新與遷移 (Update & SQL)
1. **備份與校驗**：
   - **校驗**：執行覆蓋前，**必須** 使用 `read_file` 讀取暫存區檔案，確保內容非空且未損壞。
   - **備份**：考慮將舊版檔案暫存至 `tmp-bak/`，以利更新失敗時還原。
2. **覆蓋本地檔案**：將通過審核的暫存區檔案移動至 `@public/SKILLS/{Category}/` 下的正式路徑，覆蓋舊版。
3. **元數據同步**：更新 `src/data/skills.ts` 中該技能的 `updatedAt` 或 `version`。
4. **資料庫遷移**：調用 `sql-migration-manager` 將 `UPDATE` 語句記錄於 `database/incremental_updates.sql` 頂部。

### Step 5: 系統同步 (Manifest Sync)
- **執行指令**：`npm run prebuild`。
- **回報**：向使用者呈報更新結果與版本變更摘要。

---

## 🚦 狀態管控規則 (Guardrails)

1. **僅限公共技能**：本更新機制 **僅適用於** `public/SKILLS/` 目錄下的技能。嚴禁將此流程應用於 `.agent/skills/` 內的內部管理技能。
2. **自主性要求**：AI Agent 應直接使用自身工具執行比對，嚴禁依賴外部腳本。
3. **禁止靜默更新**：偵測到差異後，應先列出清單向使用者確認。
4. **防空檔案覆蓋 (Null-Overwrite Prevention)**：嚴禁使用空檔案或未完整下載的檔案覆蓋正式環境。覆蓋前 **必須** 通過內容校驗。
5. **檔案完整性**：更新時必須確保該技能目錄下的所有關聯檔案同步更新。

## 📝 任務紀錄範本
- [x] **Check**: 偵測到內容差異。
- [x] **Import**: 已將新版檔案下載至暫存區。
- [x] **Audit**: 已執行安全掃描 (結果: PASS)。
- [x] **Validation**: 檔案內容校驗通過 (非空)。
- [x] **Update**: 檔案已覆蓋，元數據與 `incremental_updates.sql` 已同步。
- [x] **Sync**: Manifest 已重新生成。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [eric861129](https://github.com/eric861129)
- **Source:** [eric861129/SKILLS_All-in-one](https://github.com/eric861129/SKILLS_All-in-one)
- **License:** MIT
- **Homepage:** http://huangchiyu.com/SKILLS_All-in-one/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-eric861129-skills-all-in-one-skill-updater
- Seller: https://agentstack.voostack.com/s/eric861129
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.