关于 setup
用于检查和安装 asciinema-tools 依赖项的技能，支持安装、修复及验证，并可选择核心或可选组件，也可跳过确认提示。
主要功能
- 01预检依赖项
- 02安装缺失依赖项
- 03修复或升级组件
- 04选择核心或可选组件
- 05验证安装结果
适用场景
- 01使用 asciinema-tools 前检查依赖
- 02仅安装核心组件
- 03跳过提示安装全部组件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/setup确认已加载。
附带文件references/evolution-log.md
详细介绍
/asciinema-tools:setup
检查并安装 asciinema-tools 的所有依赖项。
自我演进技能：此技能会在使用过程中不断改进。如果说明有误、参数发生变化，或需要采用变通方法，请立即修复此文件，不要拖延。仅针对真实且可复现的问题进行更新。
参数
| 参数 | 说明 |
|---|---|
check | 运行预检（默认） |
install | 安装缺少的依赖项 |
repair | 重新安装/升级所有组件 |
--all | 安装全部（核心 + 可选） |
--core | 仅安装核心组件（asciinema、rg） |
--optional | 仅安装可选组件 |
-y, --yes | 跳过确认提示 |
依赖项
| 组件 | 类型 | 安装方式 |
|---|---|---|
| asciinema | 核心 | brew install asciinema |
| ripgrep | 核心 | brew install ripgrep |
| iTerm2 | 可选 | brew install --cask iterm2 |
| fswatch | 可选 | brew install fswatch |
| gh CLI | 可选 | brew install gh |
| YAKE | 可选 | uv run --with yake |
执行
跳过逻辑
- 如果提供了操作 -> 跳过阶段 1（选择操作）
- 如果提供了
--core/--all/--optional-> 跳过阶段 2 - 如果提供了
-y-> 跳过所有确认
工作流
- 检查：预检所有依赖项
- 操作：通过 AskUserQuestion 询问操作类型
- 选择：通过 AskUserQuestion 询问组件
- 安装：运行所选组件的安装
- 验证：确认安装成功
示例
# Check all dependencies
/asciinema-tools:setup check
# Install core dependencies
/asciinema-tools:setup install --core
# Install everything without prompts
/asciinema-tools:setup install --all -y
故障排除
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 找不到 brew | 未安装 Homebrew | 从 https://brew.sh 安装 |
| 权限被拒绝 | 安装需要 sudo | 运行 brew doctor 进行诊断 |
| 找不到 asciinema | PATH 尚未更新 | 重启终端或加载配置文件 |
| gh 身份验证失败 | 未通过身份验证 | 运行 gh auth login |
| YAKE 导入错误 | 缺少 Python 软件包 | uv pip install yake |
执行后反思
此技能运行完成后，请在结束前检查：
- 命令是否成功？ — 如果没有，请修复导致失败的说明或错误表。
- 参数或输出是否发生变化？ — 如果底层工具的接口发生变化，请更新用法示例和参数表，使其保持一致。
- 是否需要采用变通方法？ — 如果你不得不临时处理（使用不同的标志、增加额外步骤），请更新此 SKILL.md，避免下次调用时重复采用同样的变通方法。
仅当问题真实且可复现时才进行更新，不要臆测。
评论
支持 Markdown