skill-up

环境要求

• macOS/Linux 终端环境，可访问外网（安装脚本站点用 curl 拉取）
• 安装 skill-upper 需要 npx/Node.js 运行环境
• Windows 用户需先阅读官方 Windows 指南，存在特定设置与限制
• skill-upper 需在 Codex、Claude Code 等兼容 Agent 客户端中使用

安装与启动步骤

1. 1安装 skill-up CLI

   用官方 install.sh 一键安装 CLI，这是 README 给出的手动安装方式，适合手写 eval 的用户。

   curl -fsSL https://raw.githubusercontent.com/alibaba/skill-up/main/install.sh | bash

   复制

2. 2安装 skill-upper

   全局安装技能：Codex 用 -a codex，Claude Code 用 -a claude-code，按你使用的客户端执行其中一条。

   npx skills add https://github.com/alibaba/skill-up/tree/main/skills/skill-upper -g -a codex -y
   npx skills add https://github.com/alibaba/skill-up/tree/main/skills/skill-upper -g -a claude-code -y

   复制

3. 3初始化配置文件

   默认在 ~/.config/skill-up/config.yaml 生成带注释的 YAML 模板；加 --local 则写到当前目录。

   skill-up init

   复制

4. 4驱动首次评估

   在 Codex 或 Claude Code 打开含 SKILL.md 的项目，把该提示词发给 Agent，让它建用例并跑 skill-up。

   Use skill-upper to evaluate this Skill.
   Read SKILL.md, identify its most important behaviors, create realistic eval
   cases with appropriate judges, validate the configuration, and run skill-up.
   Summarize the results and the highest-impact failures.

   复制

5. 5查看评估结果

   评估产物落在 skill 同级的 workspace/iteration-1/result.json，据此定位影响最大的失败项。

6. 6打包插件（开发）

   仅仓库开发需要；skills/skill-upper/ 是唯一可编辑源，生成包输出到被忽略的构建目录。

   make bundle-plugins
   make package-plugins VERSION=1.0.0

   复制

关键配置

如何确认成功

skill-up init 后在 ~/.config/skill-up/config.yaml 看到 YAML 模板；评估后 iteration-1/result.json 生成。

常见问题

注意事项

• skills/skill-upper/ 是唯一可编辑源，插件包由 make 生成到被忽略的构建目录，不要手工维护副本或软链。
• 本仓库不向外部市场或 npm 发布插件；Codex 与 DSH 归档随 GitHub Release 附带校验和。
• init --config 会校验该文件为合法 skill-up 配置，并原样写入目标，注释与格式保留。
• 更多细节（Getting Started、Writing Evals、CLI Reference、用户配置）见官网用户手册。