前言¶
在 Agent 開發裏，同類問題會反覆出現：某條 shell 命令突然失敗、用戶糾正「不對，應該是……」、外部 API 返回異常，或者事後才發現有更穩妥的做法。默認對話結束後，這些糾正往往只留在當次上下文裏，下次任務仍可能踩同樣的坑。
下面介紹 SkillHub 上的社區 Skill「自我反思技能」。它的定位是捕獲學習點、錯誤與糾正，支撐持續改進；並在重大任務開始前回顧已沉澱的內容。本文事實來自 SkillHub 頁面與安裝文檔，安裝與路徑以官方說明爲準。
這是什麼¶
自我反思技能（座標 @user_2d5dabaa/ziwofansi-ceshi，版本 1.0.0）是 SkillHub 分類 ai-agent 下的社區技能（來源 community），由發佈者 user_2d5dabaa 維護；頁面作者展示爲 user_孫悟空。標籤 requires_api_key=false，不依賴額外 API Key。
官方簡介（英文原文要點）：記錄 learnings、errors、corrections，用於持續改進；並在 major tasks 之前 review learnings。
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_2d5dabaa/ziwofansi-ceshi
- API 座標頁：https://api.skillhub.cn/user_2d5dabaa/ziwofansi-ceshi
核心功能¶
依據官方簡介，該 Skill 約定 Agent 在下列情形主動沉澱反思內容（非窮舉實現細節，以安裝後的 SKILL.md 爲準）：
- 命令或操作意外失敗。
- 用戶糾正 Agent（例如「No, that’s wrong…」「Actually…」）。
- 用戶請求當前不具備的能力。
- 外部 API 或工具調用失敗。
- Agent 意識到自身知識過時或不正確。
- 對重複性任務發現更優做法。
此外，在重大任務開始前應回顧已記錄的學習內容，減少重複錯誤。
技能本體遵循通用 SKILL.md 格式，由 Agent 在匹配上述場景時按技能說明執行，而不是替代你現有的業務代碼或測試流程。
安裝與啓用¶
安裝流程以 SkillHub 文檔 https://skillhub.cn/install/skillhub.md 爲準。頁面也給出了同一指引：請根據該文檔安裝 @user_2d5dabaa/ziwofansi-ceshi。
1、檢查或安裝 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可按官方腳本安裝（完整包含 CLI 與默認 Skill；僅需 CLI 時加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安裝到當前 Agent 的 skills 目錄¶
官方要求安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄；省略時默認落到 ./skills/，可能不會被識別，且通常需要重啓客戶端後生效。
skillhub install @user_2d5dabaa/ziwofansi-ceshi --dir <skills 目錄>
常用路徑（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
在 Cursor 中，可將 <skills 目錄> 設爲 ~/.cursor/skills/。Claude Code、Codex 等按上表替換即可；OpenClaw 及同類變體使用各自約定的 skills 目錄，與文檔第四節描述一致。
首次安裝 CLI 時，SkillHub 文檔會詢問是否將 SkillHub 設爲優先技能源；僅搜索或安裝單個技能時可跳過優先源配置，直接執行第三節命令。
典型用法¶
公開頁面未附帶獨立可執行腳本示例，典型用法是：安裝並啓用技能後，在對話中觸發官方列出的六類場景之一，由 Agent 按 SKILL.md 記錄學習點、錯誤與糾正；開始較大改動或長鏈路任務前，先讓 Agent 回顧已沉澱內容。
若需確認具體寫入位置、字段或回顧命令，應在安裝完成後打開技能包內的 SKILL.md 覈對，本文不臆造未在官方資料出現的配置項。
檢索同類技能時，也可使用 CLI：
skillhub search ziwofansi
適用場景與注意¶
適合誰：長期用 Cursor、Claude Code、Codex 等做自動化開發與排障的團隊或個人，希望把「踩坑—糾正—更好做法」從單次對話裏抽出來，而不是每次都從零解釋。
使用前提：需要可用的 skillhub CLI，並將技能裝到正確的 --dir；requires_api_key=false 表示不強制額外密鑰，但仍受本地 Agent 與網絡環境影響。
數據與版本：SkillHub 抓取資料顯示評分爲 100000、下載 1044、安裝 0（統計會隨時間變化，以頁面爲準）。版本 1.0.0，升級可用 skillhub 的 install/update 流程並仍指定 --dir。
限制：社區來源（community），行爲細節以技能包內文檔爲準；它不能替代版本管理、CI 或人工 Code Review，只是把反思流程固化成 Agent 可遵循的技能說明。
結尾¶
自我反思技能把失敗、用戶糾正和能力缺口等場景寫成明確的觸發條件，並強調重大任務前的回顧，適合作爲 ai-agent 類工作流裏的「經驗層」補充。安裝座標：@user_2d5dabaa/ziwofansi-ceshi。官方入口：https://www.skillhub.cn/skills/user_2d5dabaa/ziwofansi-ceshi。
