workbench-setup 是 onsager-ai/agent-workbench 项目中的一个技能，主要用于安装、检查、更新或移除 Agent Workbench 的共享全局指令及其本地启动器，并在操作过程中保留用户已有的个人指令文本。
用途与主要能力：该技能提供一套命令行工具，帮助用户在 Linux 或 macOS 系统上管理 Agent Workbench 的全局配置。它能够创建共享指令文件、建立与 Codex 和 Claude 相关配置文件的链接或导入关系，并支持后续的更新与卸载操作。安装器会创建 ~/.agents/AGENTS.md，链接 Codex 的 ~/.codex/AGENTS.md，并确保 ~/.claude/CLAUDE.md 中有一个原生导入指向共享指令。如果已存在等效的 Claude 导入，则会复用。个人文本应放置在共享文件中 <!-- BEGIN agent-workbench --> 和 <!-- END agent-workbench --> 标记之外。首次安装时，现有 Codex 普通文件的字节会迁移到共享文件；现有 Claude 文本则保留在其原文件中。
使用方式：使用随附的 Python 3.11+ 安装器，在 Linux 或 macOS 上运行。原生 npx skills 负责分发此技能，但不会执行安装器或应用全局提示。分发后，需显式执行设置，例如：python3 ~/.agents/skills/workbench-setup/scripts/workbench.py install，然后运行 ~/.local/bin/agent-workbench status 检查状态。更新时，agent-workbench update 会先通过原生 skills 锁仅更新由 onsager-ai/agent-workbench 拥有的已安装技能，然后运行新分发的设置代码。更新和分发需要 Node.js 22.20+ 和 npx。不要手动编辑原生 skills 锁。卸载时，agent-workbench uninstall 会移除公共块和自有的导入/启动器，并将 Codex 文件恢复为包含当前私有文本的普通文件。备份保留在 ~/.local/state/agent-workbench/backups 下，卸载不会用旧快照覆盖后续编辑。这是正常的回滚操作。如需历史恢复，请手动检查保留的备份。若命令报告覆盖、外部条目、缺少资源或托管块被编辑，请保留文件并先解决具体冲突再重试，没有强制覆盖模式。状态和锁位于 ~/.local/state/agent-workbench/ 下。安装不会编辑其他技能、项目文件、shell 配置、凭据、模型或权限。对于隔离测试环境，可将技能放在一次性主目录下的规范位置，然后在命令前传递 --home PATH。替代主目录更新需要显式的 --skills-cmd 可执行命令，不会默认使用真实用户的 npx 更新。原生权限选择仍由用户决定。
适用场景与限制：适用于需要在多代理环境（如 Codex 和 Claude）中统一共享全局指令的开发者或团队，以及需要安装、检查、更新或卸载 Agent Workbench 配置的用户。限制包括：仅支持 Linux 或 macOS；需要 Python 3.11+；分发和更新需要 Node.js 22.20+ 和 npx；无强制覆盖模式；不处理其他技能或项目文件的修改；备份需手动检查以进行历史恢复。