setup

用途

setup 是 asciinema-tools 的依赖检查与安装技能。它用于在运行 asciinema-tools 之前，检查并安装所需依赖，避免因缺少组件而执行失败。调用命令为 /asciinema-tools:setup。

根据资料，该技能定位为“Self-Evolving Skill”（自我进化技能）：它会通过使用不断改进，如果发现指令错误、参数漂移或需要变通方案，应立即修正文件，而不是推迟；但仅在问题真实且可复现时才更新。

主要能力

该技能支持三种参数操作：

• check：运行 preflight 检查（默认行为）
• install：安装缺失的依赖
• repair：重装/升级全部组件

同时支持组件范围与确认控制参数：

• --all：安装全部（核心 + 可选）
• --core：仅安装核心依赖
• --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

使用方式

调用时可通过参数控制流程。技能包含跳过逻辑：

• 若提供了 action 参数，则跳过 Phase 1（动作选择）
• 若提供了 --core/--all/--optional，则跳过 Phase 2
• 若提供了 -y，则跳过所有确认

工作流步骤为：

1. Check：对所有依赖运行 preflight 检查
2. Action：通过 AskUserQuestion 询问动作类型
3. Selection：通过 AskUserQuestion 询问组件范围
4. Install：运行所选的安装
5. Verify：确认安装成功

命令示例：

# 检查所有依赖
/asciinema-tools:setup check

# 安装核心依赖
/asciinema-tools:setup install --core

# 无提示安装全部
/asciinema-tools:setup install --all -y

故障排查

资料中提供的常见问题及处理方式：

问题	原因	解决方案
brew not found	未安装 Homebrew	从 https://brew.sh 安装
Permission denied	安装需要 sudo	运行 brew doctor 进行诊断
asciinema not found	PATH 未更新	重启终端或 source profile
gh auth failed	未认证	运行 gh auth login
YAKE import error	Python 包缺失	uv pip install yake

适用场景

该技能适用于在使用 asciinema-tools 前确认环境是否就绪、补装缺失依赖，以及在组件损坏或版本落后时执行重装/升级。它面向 macOS 环境（依赖中以 Homebrew 安装为主），并涉及 asciinema 终端录制相关工具链。

限制

资料未说明该技能支持的平台范围、权限要求细节、安装耗时、网络条件或失败重试策略。核心与可选依赖的具体用途、版本要求，以及 YAKE 与 asciinema-tools 的关系，资料中暂未提供。