用途:在 opencode-agents 项目中使用 context-setup 技能,把注册表中的上下文标准文件安装到项目或全局目录,让所有 AI 智能体在写代码前自动加载团队规范。
主要能力:安装三种配置档(profile)——standard(核心编码标准、安全模式、开发工作流,约30秒)、extended(在 standard 基础上加 UI、数据、内容、产品领域,约1分钟)、all(完整库,约2分钟)。安装范围可选“仅本项目”(.claude/context/)或“全局”(~/.claude/context/,被所有项目共享)。支持 --force 覆盖重装。
使用方式:触发条件是用户运行 /install-context、说“install context”“setup context”,或上下文缺失时。先运行一段快速检查命令查看环境与安装状态(检测 git、node、.claude/.context-manifest.json、~/.claude/.context-manifest.json、.oac.json),再一次性询问安装范围与配置档,等待确认后执行安装器:Mac/Linux 优先用 bash "{PLUGIN_ROOT}/scripts/install-context.sh" --profile={profile} [--global];Windows 或 bash 失败时用 node "{PLUGIN_ROOT}/scripts/install-context.js" --profile={profile} [--global]。随后验证清单文件,项目安装若缺 .oac.json 则用 printf 命令创建。
适用场景:需要在仓库或全局统一 AI 智能体编码标准、且不想每次都向智能体重复规范的团队与个人项目。
限制:git 为必需项,缺失则停止并给出各平台安装指引;node 非必需(bash 安装器不需要);全局安装不需要 .oac.json,项目安装需要;网络失败需检查连接后重试;脚本路径应读取会话上下文中的 OAC System Paths,不能用 $CLAUDE_PLUGIN_ROOT 作为 shell 变量。