前言¶
自己维护的 Skill 用久了，常见问题很具体：触发条件写得不准、指令冗长或含糊、线上踩坑后改动散落在对话里、想对齐社区里的写法却没时间搜。手工改 SKILL.md 能解一时，却很难把「需求驱动、BUG 沉淀、外部实践」三条线收拢到同一套流程里。下面介绍 SkillHub 社区 Skill Skill自我优化（@user_1002ca6a/skill-improver），面向「改进、优化、升级、调试、自动优化」已有 Skill 的场景。
这是什么¶
Skill自我优化 是一条面向 已存在 Skill 的改进类 Agent Skill：对目标 Skill 做全方位改进与持续进化，而不是从零写新 Skill。
- 坐标：
@user_1002ca6a/skill-improver - 版本：1.0.0（来源：community）
- 发布者：user_1002ca6a
- 分类：ai-agent
- 标签：
requires_api_key=false（官方标明无需 API Key）
在 SkillHub 上，该 Skill 评分 100000，下载 34311 次，安装 46 次（数据取自 SkillHub 页面与抓取资料，会随平台更新变化）。
核心功能¶
以下能力均来自官方简介，未在资料中出现的细节不展开。
三种改进来源¶
- 用户指定的改进需求：你说明要改描述、触发条件、指令质量或专业能力边界，Skill 按目标改动。
- 运营过程中的 BUG 与修复沉淀：使用中发现的问题与修复思路，可作为持续进化的输入。
- 联网搜索外部最佳实践：在需要时从外部检索做法，辅助确定优化方向（具体检索范围以 Skill 内指令为准）。
官方列出的适用方向¶
- 改进 Skill 描述与触发条件
- 提升指令质量
- 修复逻辑缺陷
- 增强专业能力
- 精简冗余内容
- 自动查找优化方向
- BUG 自修复
触发关键词（官方）¶
skill改进、优化skill、改进skill、skill升级、skill调试、自动优化skill、skill自修复、BUG修复skill。
当用户表达「想改进 / 优化 / 升级 / 调试 / 自动优化某个 skill」时，Agent 可加载本 Skill 处理。
安装与启用¶
Skill 基于通用 SKILL.md 格式分发。在 SkillHub 安装需先具备 skillhub CLI；完整步骤见 SkillHub 安装与优先源配置。
1、检查或安装 CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可用官方脚本安装（推荐完整安装，含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 Skill自我优化¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法识别。
skillhub install user_1002ca6a/skill-improver --dir <你的 skills 目录>
常用客户端 skills 目录（摘自 SkillHub 安装文档）：
| 环境 | 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
也可将下面提示交给 Agent，让其按安装文档拉取 @user_1002ca6a/skill-improver：
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_1002ca6a/skill-improver。
安装后按你所用客户端要求重启或刷新 Skill 列表（以各客户端文档为准）。
典型用法¶
官方未提供逐步复制的对话脚本，但触发方式与改进来源在简介中已写明。可按下面两类方式使用。
按需求改某个 Skill¶
- 在对话中点名要改的 Skill（路径或名称）。
- 说明改进目标，例如：收紧触发条件、缩短冗余段落、补充某类错误的处理步骤。
- 让 Agent 在加载 Skill自我优化 后输出修改建议或直接改
SKILL.md（以你当前工作流为准）。
示例意图（非官方原文，仅说明用法形态）：
用 skill 改进流程，优化 ~/.cursor/skills/xxx/SKILL.md：触发条件太宽，经常误触发；请精简指令并写清边界。
用 BUG 沉淀或外部实践驱动¶
- 描述一次失败案例：输入、错误表现、你已尝试的修复。
- 说明希望把结论写回 Skill，避免下次重复踩坑。
- 若需要参考外部写法，可在同一轮对话中要求结合联网检索的最佳实践（能力由本 Skill 定义）。
关键词可直接使用官方列表中的表述，例如「自动优化skill」「skill自修复」。
适用场景与注意¶
适合谁
- 已有一批自研或第三方 Skill，需要长期迭代维护的开发者。
- 希望把「改文档」和「排 BUG」统一成可重复流程，而不是每次从零 prompt 的团队。
限制与注意
- 本 Skill 改进的是 已有 Skill，不替代从零编写 Skill 的其他工具。
requires_api_key=false仅表示该 Skill 包本身不要求配置 API Key；若改进过程中需要联网搜索，仍取决于 Agent 与运行环境是否具备相应能力。- 安装目录错误是常见坑：务必
skillhub install ... --dir <正确目录>。 - 评分、下载量等为平台统计，与本地使用效果无直接对应关系；改完后应在真实任务上回归验证触发与输出。
结尾¶
Skill自我优化 把「需求、BUG 沉淀、外部实践」三类输入收敛到一条改进路径上，适合在 Skill 数量变多、维护成本上升时使用。安装与坐标以 SkillHub 为准。
- SkillHub 页面：https://www.skillhub.cn/skills/user_1002ca6a/skill-improver
- API 资源地址：https://api.skillhub.cn/user_1002ca6a/skill-improver
- 安装说明：https://skillhub.cn/install/skillhub.md
