Open VibeCoding Skill 技能

技能简介 Open VibeCoding 是一个面向 AI 编程助手的「协作能力框架」（Harness），把产品、交互设计、研发、测试与视觉辅助拆成一批可组合的 Agent 技能。仓库 mileson/open-vibecoding，MIT 许可，当前版本 0.4.0，用 JavaScript 编写，要求 Node.js ≥ 20.19.0。你只需描述目标，Agent 会结合代码、会话与必要证据自行判断该调用哪些能力，而不是被固定命令或固定流程牵着走。

核心能力

• 产品域：用户问题、竞品与需求诊断，按需调研并输出产品材料
• 交互设计域：信息架构、路径、状态、视觉方向与实现对比
• 研发域：Agent 自主拆解并实现，CLI 提供确定性工具与运行态支持
• 测试域：按风险选取最小足够验证，并保留真正需要的证据
• Vibe Coding 增强：视觉精确定位与图片标注、图标获取与切图、音频证据、画布协作、工具选择与经验复用
• 最佳实践横向板块：按项目条件挑选成熟现代方案，首个独立主题是 iOS String Catalog 多语言
• 仓库 skills/ 目录下共 42 个场景技能，统一以 open-vibecoding- 前缀命名

安装配置

• 从仓库克隆代码后执行 npm install 安装依赖，package.json 的 bin 字段声明命令为 open-vibecoding
• 环境要求 Node.js ≥ 20.19.0（package.json engines 字段）
• 初始化工作区：open-vibecoding init .，会在项目下生成 .open-vibecoding/ 目录
• 未安装全局命令时，可直接使用项目 AGENTS.md 中记录的本地 Node CLI 入口

使用步骤

1. open-vibecoding init . 初始化当前项目的协作工作区
2. open-vibecoding capabilities list 查看全部能力目录，或用 capabilities get / contract 查看某个能力的说明与契约
3. open-vibecoding doctor . 对当前项目做环境与能力自检
4. open-vibecoding run . --verify 带上校验执行一次协作流程
5. 需要扩展时，在项目中放 open-vibecoding.capabilities.json，并配套 repo-local Skill 做增量扩展

适用场景

• 让 Agent 按截图调整间距、对齐卡片或定位细小目标
• 让 Agent 圈出问题区域、标注操作位置并生成标注图
• 做竞品与需求诊断、产出产品材料
• 界面与交互评审后的修复与复验
• 需要留下可复核证据的测试与验收环节

适用人群 希望把 AI 编程助手从「会写代码」带到「会协作、会自检、会留证据」的开发者，尤其是同时承担产品、交互与工程工作的个人开发者和小团队。

工作原理 框架不把五个领域排成必须依次完成的流程，而是让每个场景成为独立子能力，由统筹层按用户意图组合，不依赖固定关键词匹配：小任务只用一项，复杂任务可以在领域之间往返。视觉辅助被拆成「视觉定位」与「图片标注」两个内部子能力，前者生成红色像素网格并结合局部放大确定边界、核对缩放裁切与坐标原点，后者框住完整操作单元并检查文字遮挡与越界。原图与已有版本不会被覆盖；当坐标关系不明、计划与源图不一致或标签没有安全位置时，工具会拒绝相应处理，它也不保证模型判断绝对准确，更不会把图片像素直接当成屏幕点击或 CSS 坐标。工作原则还强调：界面视觉审查需在最终回复展示实际截图，代码是默认的实现说明，并且不会自动生成需求文档、评审记录或任务清单这类留痕文件，已有工作区历史产物保持只读、不迁移不改写。

官方链接 仓库 https://github.com/mileson/open-vibecoding ，架构与兼容边界见 docs/basic/open-vibecoding-architecture.md，视觉辅助的使用场景与边界见 docs/visual-assistance.md。