@vibe-coder/cli 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +65 -84
- package/README.zh.md +62 -79
- package/package.json +14 -3
package/README.md
CHANGED
|
@@ -4,39 +4,48 @@
|
|
|
4
4
|
|
|
5
5
|
**A vibe coding ecosystem builder tailored for OpenCode**
|
|
6
6
|
|
|
7
|
+
[](https://www.npmjs.com/package/@vibe-coder/cli)
|
|
8
|
+
[](../../LICENSE.md)
|
|
9
|
+
[](https://bun.sh)
|
|
10
|
+
|
|
7
11
|
**English** · [简体中文](https://github.com/HelloGGX/skill/blob/main/packages/vibe/README.zh.md)
|
|
8
12
|
|
|
13
|
+
> *Seamlessly aggregate AI tools and context rules, making your Agent truly understand your codebase.*
|
|
14
|
+
|
|
9
15
|
</div>
|
|
10
16
|
|
|
11
17
|
## 📖 Introduction
|
|
12
18
|
|
|
13
|
-
|
|
19
|
+
`@vibe-coder/cli` is a modern command-line scaffolding tool built specifically for the **OpenCode** platform. Its core objective is to quickly set up a Vibe Coding development environment and simplify resource management for specification-driven development.
|
|
14
20
|
|
|
15
|
-
With the `vibe` command, you can pull TypeScript/Python tool scripts or Markdown rule files from remote GitHub repositories with a single click. It
|
|
21
|
+
With the `vibe` command, you can pull TypeScript/Python tool scripts or Markdown rule files from remote GitHub repositories with a single click. It seamlessly registers them into your OpenCode configuration and manages the underlying runtime dependency environments, allowing you to focus entirely on "co-creating code with AI."
|
|
16
22
|
|
|
17
23
|
## ✨ Features
|
|
18
24
|
|
|
19
|
-
* 🛠 **Fully Automated Tool Management:** Quickly parse, select, and download `.ts` / `.py` scripts from any GitHub repository straight to your local
|
|
20
|
-
* 📜 **
|
|
21
|
-
* 📦 **Smart Configuration Injection:** Automatically intercepts and updates `.opencode/opencode.jsonc`, silently injecting tool enable-switches and Prompt instruction paths. Say goodbye to
|
|
22
|
-
* ⚡ **Lightning-Fast Parallel Updates:** Designed with a concurrency model to simultaneously handle resource comparison and pulling from multiple source repositories, drastically reducing update wait times
|
|
23
|
-
* 🪄 **Standard Skills Aggregation:** Deeply integrated with Vercel's `pnpx skills` ecosystem, allowing you to manage standard Agent skill libraries alongside
|
|
25
|
+
* 🛠 **Fully Automated Tool Management:** Quickly parse, select, and download `.ts` / `.py` scripts from any GitHub repository straight to your local setup, ready to use out of the box.
|
|
26
|
+
* 📜 **Context & Capabilities United:** A unique ecosystem aggregation capability that perfectly blends the **tools/skills** needed for Agent execution with your **guidelines and best practices**. Supports on-demand installation of `.md` rule files so the AI truly understands your architectural intent.
|
|
27
|
+
* 📦 **Smart Configuration Injection:** Automatically intercepts and updates `.opencode/opencode.jsonc`, silently injecting tool enable-switches and Prompt instruction paths. Say goodbye to manual configuration forever.
|
|
28
|
+
* ⚡ **Lightning-Fast Parallel Updates:** Designed with a concurrency model to simultaneously handle resource comparison and pulling from multiple source repositories, drastically reducing update wait times.
|
|
29
|
+
* 🪄 **Standard Skills Aggregation:** Deeply integrated with Vercel's `pnpx skills` ecosystem, allowing you to manage standard Agent skill libraries alongside local extension resources within a unified CLI workflow.
|
|
24
30
|
|
|
25
31
|
---
|
|
26
32
|
|
|
27
33
|
## 🚀 Quick Start
|
|
28
34
|
|
|
35
|
+
### Prerequisites
|
|
36
|
+
|
|
37
|
+
* [Node.js](https://www.google.com/search?q=https://nodejs.org/) >= 18.0.0 or [Bun](https://bun.sh/) >= 1.0.0
|
|
38
|
+
|
|
29
39
|
### Installation
|
|
30
40
|
|
|
31
|
-
Install as a global package
|
|
41
|
+
Install as a global package:
|
|
32
42
|
|
|
33
43
|
```bash
|
|
34
44
|
# Using npm
|
|
35
|
-
npm
|
|
45
|
+
npm i -g @vibe-coder/cli
|
|
36
46
|
|
|
37
47
|
# Using bun
|
|
38
|
-
bun add -g vibe-
|
|
39
|
-
|
|
48
|
+
bun add -g @vibe-coder/cli
|
|
40
49
|
```
|
|
41
50
|
|
|
42
51
|
### Basic Usage
|
|
@@ -45,117 +54,89 @@ Initialize and add an ecosystem library (e.g., `helloggx/skill` from this projec
|
|
|
45
54
|
|
|
46
55
|
```bash
|
|
47
56
|
vibe add helloggx/skill
|
|
48
|
-
|
|
49
57
|
```
|
|
50
58
|
|
|
51
|
-
*
|
|
59
|
+
*The CLI will pop up an interactive menu, allowing you to flexibly select the **Tools** and **Rules** you want to install, automatically configuring the entire environment for you.*
|
|
52
60
|
|
|
53
61
|
---
|
|
54
62
|
|
|
55
63
|
## 📚 Commands
|
|
56
64
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
vibe
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
**Execution Flow**:
|
|
65
|
+
| Command | Alias | Description |
|
|
66
|
+
| --- | --- | --- |
|
|
67
|
+
| `vibe add <repo>` | `a` | Parses the target GitHub repository, pops up a UI list, installs selected tools and rules on demand, and automatically injects configurations. |
|
|
68
|
+
| `vibe list` | `ls` | Prints a clear status map of all installed resources (local tools, context rules, global standard skills) in the current project. |
|
|
69
|
+
| `vibe update` | `up` | Concurrently pulls all source repositories recorded in `vibe-lock.json`, intelligently comparing and overwriting local scripts and rules. |
|
|
70
|
+
| `vibe remove [resource]` | `rm` | **No arguments:** Opens a UI multi-select list to remove local items.<br>
|
|
65
71
|
|
|
66
|
-
|
|
67
|
-
2. Clones and parses the `skill`, `tool`, and `rules` asset directories in the target repository.
|
|
68
|
-
3. Triggers an interactive multi-select list to pick specific tool scripts and rule documents on demand.
|
|
69
|
-
4. Automatically executes file copying, intelligently merges common rules, updates `opencode.jsonc`, and configures the Python dependency environment (if needed).
|
|
72
|
+
<br>**With arguments:** Quickly matches and removes specified standard skills or local tools, cleaning up configurations synchronously. |
|
|
70
73
|
|
|
71
|
-
|
|
74
|
+
---
|
|
72
75
|
|
|
73
|
-
|
|
74
|
-
vibe list
|
|
76
|
+
## 🏗️ Build Your Own Resource Repository
|
|
75
77
|
|
|
76
|
-
|
|
78
|
+
We highly encourage you or your team to create a dedicated Vibe Coding resource repository on GitHub to standardize your favorite AI tools and custom coding guidelines across all your projects.
|
|
77
79
|
|
|
78
|
-
|
|
79
|
-
Clearly prints a status map of all installed resources in the current project, including:
|
|
80
|
+
### Recommended Directory Structure
|
|
80
81
|
|
|
81
|
-
|
|
82
|
-
* 📜 Injected Context Rules (Local Rules)
|
|
83
|
-
* 🪄 Global Standard Skills
|
|
82
|
+
To ensure perfect compatibility with `@vibe-coder/cli`, we recommend the following convention (referencing the `helloggx/skill` repository):
|
|
84
83
|
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
84
|
+
```text
|
|
85
|
+
your-custom-repo/
|
|
86
|
+
├── skill/ # (Optional) Standard Vercel AI Agent skills
|
|
87
|
+
├── tool/ # Custom TS/Python executable tools
|
|
88
|
+
│ ├── get_dsl.ts
|
|
89
|
+
│ ├── get_dsl.py # 💡 Python scripts should share the exact name as the TS tool calling them
|
|
90
|
+
│ └── shadcn_vue_init.ts
|
|
91
|
+
└── rules/ # Personalized Markdown context rules
|
|
92
|
+
├── common/ # Global rules applicable to all projects
|
|
93
|
+
│ ├── coding-style.md
|
|
94
|
+
│ └── security.md
|
|
95
|
+
└── typescript/ # Tech-stack specific rules
|
|
96
|
+
└── coding-style.md # 💡 Recommended to share the name with the extended common rule
|
|
89
97
|
|
|
90
98
|
```
|
|
91
99
|
|
|
92
|
-
|
|
93
|
-
Executes a full workspace update with one click. The CLI will concurrently pull all source repositories recorded in `vibe-lock.json`, intelligently compare and overwrite the latest local scripts and rule files, and simultaneously trigger an upgrade of the standard skills library.
|
|
100
|
+
### Organization Best Practices
|
|
94
101
|
|
|
95
|
-
|
|
102
|
+
* **Cross-Language Tool Linkage**: If your `.ts` tool script relies on an underlying `.py` script, **ensure both files share the exact same base name** (e.g., `get_dsl.ts` and `get_dsl.py`). The CLI intelligently detects and pulls both files together.
|
|
103
|
+
* **Rule Inheritance & Overrides**:
|
|
104
|
+
* Always place your global, universal coding rules in the `rules/common/` directory.
|
|
105
|
+
* When creating tech-stack specific rules (e.g., under `rules/typescript/`) that need to inherit from a `common` rule, it is highly recommended to **use the exact same file name** and explicitly state the inheritance at the top of the file:
|
|
106
|
+
*> This file extends [common/coding-style.md](https://www.google.com/search?q=../common/coding-style.md) with TypeScript specific content.*
|
|
96
107
|
|
|
97
|
-
```bash
|
|
98
|
-
# Interactive mode: Pops up a UI list to select tools and rules to remove
|
|
99
|
-
vibe remove
|
|
100
|
-
|
|
101
|
-
# Shortcut mode: Directly specify the resource to remove (supports standard skills and local tools/rules)
|
|
102
|
-
vibe remove <resource>
|
|
103
|
-
|
|
104
|
-
```
|
|
105
108
|
|
|
106
|
-
**Execution Flow**:
|
|
107
|
-
|
|
108
|
-
1. Invokes native capabilities to remove standard Agent skills from the target repository (via `pnpx skills remove`).
|
|
109
|
-
2. Parses the list of installed resources in the local `vibe-lock.json`.
|
|
110
|
-
3. **Interactive Mode**: Pops up a multi-select list, allowing you to choose specific tools and rule categories for removal.
|
|
111
|
-
4. **Shortcut Mode**: Directly matches and removes local tool/rule files based on the passed arguments.
|
|
112
|
-
5. Automatically cleans up the corresponding physical files (`.opencode/tool/` and `.opencode/rules/`) and synchronously updates the `opencode.jsonc` configuration.
|
|
113
109
|
|
|
114
110
|
---
|
|
115
111
|
|
|
116
112
|
## 📂 Workspace Structure
|
|
117
113
|
|
|
118
|
-
After running `vibe add`, the tool will automatically
|
|
114
|
+
After running `vibe add`, the tool will automatically take over and maintain the following structure in your project's root directory:
|
|
119
115
|
|
|
120
116
|
```text
|
|
121
117
|
your-project/
|
|
122
118
|
├── .opencode/
|
|
123
|
-
│
|
|
124
|
-
│
|
|
125
|
-
│
|
|
126
|
-
│
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
│ ├── opencode.jsonc # Core OpenCode configuration file
|
|
130
|
-
│ │ # (vibe automatically manages "tools": {...} and "instructions": [...] inside)
|
|
131
|
-
│ └── vibe-lock.json # Internal state lock file, accurately recording resource sources, versions, and update timestamps
|
|
132
|
-
├── .venv/ # (Auto-created as needed) Isolated Python virtual environment
|
|
133
|
-
└── requirements.txt # (Auto-maintained as needed) Dependency list required for Python scripts
|
|
134
|
-
|
|
119
|
+
│ ├── tool/ # Pulled underlying .ts / .py tool scripts
|
|
120
|
+
│ ├── rules/ # Pulled .md rule files (categorized by type)
|
|
121
|
+
│ ├── opencode.jsonc # Core OpenCode config (CLI auto-injects tool switches and paths)
|
|
122
|
+
│ └── vibe-lock.json # State lock file, accurately recording resource sources and versions
|
|
123
|
+
├── .venv/ # (Auto-created as needed) Isolated Python virtual environment
|
|
124
|
+
└── requirements.txt # (Auto-maintained as needed) Python script dependencies
|
|
135
125
|
```
|
|
136
126
|
|
|
137
127
|
---
|
|
138
128
|
|
|
139
129
|
## 🛠️ Development
|
|
140
130
|
|
|
141
|
-
This project is built on top of [Bun](https://bun.sh/)
|
|
131
|
+
This project is built on top of the lightning-fast [Bun](https://bun.sh/) runtime.
|
|
142
132
|
|
|
143
133
|
```bash
|
|
144
|
-
# 1. Install
|
|
145
|
-
bun
|
|
146
|
-
|
|
147
|
-
#
|
|
148
|
-
bun run dev --help
|
|
149
|
-
|
|
150
|
-
# 3. Strict type checking
|
|
151
|
-
bun run typecheck
|
|
152
|
-
|
|
153
|
-
# 4. Build production version (outputs to ./dist)
|
|
154
|
-
bun run build
|
|
155
|
-
|
|
134
|
+
bun install # 1. Install dependencies
|
|
135
|
+
bun run dev --help # 2. Local debugging
|
|
136
|
+
bun run typecheck # 3. Type checking
|
|
137
|
+
bun run build # 4. Build production version (outputs to ./dist)
|
|
156
138
|
```
|
|
157
139
|
|
|
158
140
|
## 📄 License
|
|
159
141
|
|
|
160
|
-
|
|
161
|
-
© 2026 [HelloGGX](https://github.com/HelloGGX)
|
|
142
|
+
[MIT License](https://www.google.com/search?q=../../LICENSE.md) © 2026 [HelloGGX](https://github.com/HelloGGX)
|
package/README.zh.md
CHANGED
|
@@ -4,42 +4,47 @@
|
|
|
4
4
|
|
|
5
5
|
**专为 OpenCode 打造的 vibe coding 生态构建工具**
|
|
6
6
|
|
|
7
|
-
[](../../LICENSE.md)
|
|
9
|
-
[](https://bun.sh)
|
|
7
|
+
[](https://www.npmjs.com/package/@vibe-coder/cli)
|
|
8
|
+
[](../../LICENSE.md)
|
|
9
|
+
[](https://bun.sh)
|
|
10
10
|
|
|
11
11
|
[English](https://github.com/HelloGGX/skill/blob/main/packages/vibe/README.md) · **简体中文**
|
|
12
12
|
|
|
13
|
+
> *一键聚合 AI 工具与上下文规范，让 Agent 真正懂你的代码架构。*
|
|
14
|
+
|
|
13
15
|
</div>
|
|
14
16
|
|
|
15
17
|
## 📖 简介 (Introduction)
|
|
16
18
|
|
|
17
|
-
|
|
19
|
+
`@vibe-coder/cli` 是一个专为 **OpenCode** 平台打造的现代命令行脚手架工具。它的核心目标是快速搭建 Vibe Coding 的开发环境，简化规范驱动开发的资源管理。
|
|
18
20
|
|
|
19
|
-
通过 `vibe` 命令，你可以一键拉取远程 GitHub 仓库中的 TypeScript/Python 工具脚本或 Markdown
|
|
21
|
+
通过 `vibe` 命令，你可以一键拉取远程 GitHub 仓库中的 TypeScript/Python 工具脚本或 Markdown 规则文件，自动无缝注册到 OpenCode 配置中，并接管底层运行依赖，让你专注于**“与 AI 共创代码”**本身。
|
|
20
22
|
|
|
21
23
|
## ✨ 核心特性 (Features)
|
|
22
24
|
|
|
23
|
-
- 🛠 **全自动化工具管理**: 支持从任意 GitHub
|
|
24
|
-
- 📜
|
|
25
|
-
- 📦 **智能配置注入**: 自动拦截并更新 `.opencode/opencode.jsonc
|
|
26
|
-
- ⚡ **并行极速更新**:
|
|
27
|
-
- 🪄 **标准技能聚合**: 与 Vercel 的 `pnpx skills` 生态深度集成，在统一的 CLI 流程中同时管理标准 Agent
|
|
25
|
+
- 🛠 **全自动化工具管理**: 支持从任意 GitHub 仓库快速解析、多选并下载 `.ts` / `.py` 脚本至本地开箱即用。
|
|
26
|
+
- 📜 **Context 与 Capabilities 完美融合**: 独创生态聚合能力，将 Agent 执行所需的**工具技能**与**行为准则**深度绑定。支持按需安装 `.md` 规则文件，让 AI 真正懂你的架构意图。
|
|
27
|
+
- 📦 **智能配置注入**: 自动拦截并更新 `.opencode/opencode.jsonc`，无感注入工具开关与 Prompt 指令路径，告别繁琐的手动配置。
|
|
28
|
+
- ⚡ **并行极速更新**: 基于并发模型设计，同时处理多个源仓库的资源对比与拉取，大幅缩短更新等待时间。
|
|
29
|
+
- 🪄 **标准技能聚合**: 与 Vercel 的 `pnpx skills` 生态深度集成，在统一的 CLI 流程中同时管理标准 Agent 技能库和本地扩展资源。
|
|
28
30
|
|
|
29
31
|
---
|
|
30
32
|
|
|
31
33
|
## 🚀 快速开始 (Quick Start)
|
|
32
34
|
|
|
35
|
+
### 环境要求 (Prerequisites)
|
|
36
|
+
- [Node.js](https://nodejs.org/) >= 18.0.0 或 [Bun](https://bun.sh/) >= 1.0.0
|
|
37
|
+
|
|
33
38
|
### 安装
|
|
34
39
|
|
|
35
|
-
|
|
40
|
+
作为全局包安装：
|
|
36
41
|
|
|
37
42
|
```bash
|
|
38
43
|
# 使用 npm
|
|
39
|
-
npm
|
|
44
|
+
npm i -g @vibe-coder/cli
|
|
40
45
|
|
|
41
46
|
# 使用 bun
|
|
42
|
-
bun add -g vibe-
|
|
47
|
+
bun add -g @vibe-coder/cli
|
|
43
48
|
```
|
|
44
49
|
|
|
45
50
|
### 基础用法
|
|
@@ -50,108 +55,86 @@ bun add -g vibe-coding-cli
|
|
|
50
55
|
vibe add helloggx/skill
|
|
51
56
|
```
|
|
52
57
|
|
|
53
|
-
|
|
58
|
+
*CLI 将唤起交互式菜单，允许你灵活多选想要安装的 **Tools (工具)** 和 **Rules (规则)**，并自动为你完成所有环境配置。*
|
|
54
59
|
|
|
55
60
|
---
|
|
56
61
|
|
|
57
62
|
## 📚 命令指南 (Commands)
|
|
58
63
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
vibe
|
|
63
|
-
|
|
64
|
+
| 命令 | 别名 | 功能描述 |
|
|
65
|
+
| --- | --- | --- |
|
|
66
|
+
| `vibe add <repo>` | `a` | 解析目标 GitHub 仓库，唤起 UI 列表，按需安装工具和规则文件，并自动注入配置。 |
|
|
67
|
+
| `vibe list` | `ls` | 清晰打印当前项目中所有已安装资源（本地工具、上下文规则、全局标准技能）的态势图。 |
|
|
68
|
+
| `vibe update` | `up` | 一键并发拉取 `vibe-lock.json` 中的所有源仓库，智能比对并覆盖本地脚本与规则。 |
|
|
69
|
+
| `vibe remove [资源]` | `rm` | **无参运行**：唤起 UI 多选列表删除本地项。<br>
|
|
64
70
|
|
|
65
|
-
|
|
71
|
+
<br>**带参运行**：快捷匹配并移除指定的标准技能或本地工具，并同步清理配置。 |
|
|
66
72
|
|
|
67
|
-
|
|
68
|
-
2. 克隆并解析目标仓库中的 `skill`、`tool` 和 `rules` 资产目录。
|
|
69
|
-
3. 唤起交互式多选列表，按需挑选具体的工具脚本和规则文档。
|
|
70
|
-
4. 自动执行文件拷贝、智能合并公共规则、更新 `opencode.jsonc` 并配置 Python 依赖环境（如需）。
|
|
71
|
-
|
|
72
|
-
### 2. 查看已安装项 (`list` / `ls`)
|
|
73
|
+
---
|
|
73
74
|
|
|
74
|
-
|
|
75
|
-
vibe list
|
|
76
|
-
```
|
|
75
|
+
## 🏗️ 构建你自己的资源仓库
|
|
77
76
|
|
|
78
|
-
|
|
79
|
-
清晰打印当前项目中安装的所有资源态势图，包含：
|
|
77
|
+
我们强烈鼓励你或团队在 GitHub 上创建专属的 Vibe Coding 资源仓库，以在所有项目中标准化团队最喜欢的 AI 工具和自定义编码规范。
|
|
80
78
|
|
|
81
|
-
|
|
82
|
-
* 📜 注入的上下文规则 (Local Rules)
|
|
83
|
-
* 🪄 全局标准技能 (Standard Skills)
|
|
79
|
+
### 推荐目录结构
|
|
84
80
|
|
|
85
|
-
|
|
81
|
+
为确保与 `@vibe-coder/cli` 完美兼容，推荐采用以下约定（可参考 `helloggx/skill`）：
|
|
86
82
|
|
|
87
|
-
```
|
|
88
|
-
|
|
83
|
+
```text
|
|
84
|
+
your-custom-repo/
|
|
85
|
+
├── skill/ # (可选) 标准的 Vercel AI Agent 技能库
|
|
86
|
+
├── tool/ # 自定义 TS/Python 可执行工具
|
|
87
|
+
│ ├── get_dsl.ts
|
|
88
|
+
│ ├── get_dsl.py # 💡 Python 脚本应与其调用的 TS 工具同名
|
|
89
|
+
│ └── shadcn_vue_init.ts
|
|
90
|
+
└── rules/ # 个性化 Markdown 上下文规则
|
|
91
|
+
├── common/ # 适用于所有项目的全局通用规则
|
|
92
|
+
│ ├── coding-style.md
|
|
93
|
+
│ └── security.md
|
|
94
|
+
└── typescript/ # 特定技术栈规则
|
|
95
|
+
└── coding-style.md # 💡 建议与被扩展的通用规则同名
|
|
89
96
|
```
|
|
90
97
|
|
|
91
|
-
|
|
92
|
-
一键执行工作区全量更新。CLI 会并发拉取 `vibe-lock.json` 中记录的所有源仓库，智能比对并覆盖最新的本地脚本和规则文件，同时触发标准技能库的升级。
|
|
98
|
+
### 组织最佳实践
|
|
93
99
|
|
|
94
|
-
|
|
100
|
+
* **跨语言工具联动**：若你的 `.ts` 工具依赖底层的 `.py` 脚本，**请确保两文件基础名称完全一致**（如 `get_dsl.ts` 和 `get_dsl.py`）。CLI 会智能识别并一并拉取。
|
|
101
|
+
* **规则继承与扩展**：
|
|
102
|
+
* 全局通用规则务必放在 `rules/common/` 下。
|
|
103
|
+
* 为特定技术栈编写规则时（如 `rules/typescript/`），若需继承 `common` 规则，建议**保持同名**，并在文件顶部显式声明继承关系：
|
|
104
|
+
*> 此文件扩展了 [common/coding-style.md](https://www.google.com/search?q=../common/coding-style.md) 并增加了 TS 特定内容。*
|
|
95
105
|
|
|
96
|
-
```bash
|
|
97
|
-
# 交互式模式：弹出 UI 列表选择要移除的工具和规则
|
|
98
|
-
vibe remove
|
|
99
|
-
|
|
100
|
-
# 快捷模式：直接指定要移除的资源（支持标准 skills 和本地工具/规则）
|
|
101
|
-
vibe remove <resource>
|
|
102
|
-
```
|
|
103
106
|
|
|
104
|
-
**执行流程**:
|
|
105
|
-
|
|
106
|
-
1. 调用原生能力，移除目标仓库中的标准 Agent 技能（通过 `pnpx skills remove`）。
|
|
107
|
-
2. 解析本地 `vibe-lock.json` 中的已安装资源列表。
|
|
108
|
-
3. **交互模式**：弹出多选列表，允许你选择具体的工具和规则分类进行移除。
|
|
109
|
-
4. **快捷模式**：根据传入的参数直接匹配并移除本地工具/规则文件。
|
|
110
|
-
5. 自动清理对应的物理文件（`.opencode/tool/` 和 `.opencode/rules/`），并同步更新 `opencode.jsonc` 配置。
|
|
111
107
|
|
|
112
108
|
---
|
|
113
109
|
|
|
114
110
|
## 📂 目录与配置规范 (Workspace Structure)
|
|
115
111
|
|
|
116
|
-
运行 `vibe add`
|
|
112
|
+
运行 `vibe add` 后，工具将在项目根目录自动接管并维护以下结构：
|
|
117
113
|
|
|
118
114
|
```text
|
|
119
115
|
your-project/
|
|
120
116
|
├── .opencode/
|
|
121
|
-
│ ├── tool/ #
|
|
122
|
-
│
|
|
123
|
-
│
|
|
124
|
-
│
|
|
125
|
-
│ │ ├── common/
|
|
126
|
-
│ │ └── typescript/
|
|
127
|
-
│ ├── opencode.jsonc # OpenCode 核心配置文件
|
|
128
|
-
│ │ # (vibe 会自动管理其中的 "tools": {...} 和 "instructions": [...])
|
|
129
|
-
│ └── vibe-lock.json # 内部状态锁文件，精准记录资源来源仓库、版本与更新时间戳
|
|
117
|
+
│ ├── tool/ # 底层 .ts / .py 工具脚本
|
|
118
|
+
│ ├── rules/ # .md 规则文件（按类别归档）
|
|
119
|
+
│ ├── opencode.jsonc # OpenCode 核心配置（CLI 自动注入工具开关与指令路径）
|
|
120
|
+
│ └── vibe-lock.json # 状态锁文件，精准记录资源来源与版本
|
|
130
121
|
├── .venv/ # (按需自动创建) 隔离的 Python 虚拟环境
|
|
131
|
-
└── requirements.txt # (按需自动维护) Python
|
|
122
|
+
└── requirements.txt # (按需自动维护) Python 脚本依赖清单
|
|
132
123
|
```
|
|
133
124
|
|
|
134
125
|
---
|
|
135
126
|
|
|
136
127
|
## 🛠️ 开发者指南 (Development)
|
|
137
128
|
|
|
138
|
-
|
|
129
|
+
本项目基于极速的 [Bun](https://bun.sh/) 运行时构建。
|
|
139
130
|
|
|
140
131
|
```bash
|
|
141
|
-
# 1.
|
|
142
|
-
bun
|
|
143
|
-
|
|
144
|
-
#
|
|
145
|
-
bun run dev --help
|
|
146
|
-
|
|
147
|
-
# 3. 严格类型检查
|
|
148
|
-
bun run typecheck
|
|
149
|
-
|
|
150
|
-
# 4. 构建生产版本 (输出至 ./dist)
|
|
151
|
-
bun run build
|
|
132
|
+
bun install # 1. 安装依赖
|
|
133
|
+
bun run dev --help # 2. 本地调试
|
|
134
|
+
bun run typecheck # 3. 类型检查
|
|
135
|
+
bun run build # 4. 构建生产版本 (输出至 ./dist)
|
|
152
136
|
```
|
|
153
137
|
|
|
154
138
|
## 📄 许可证 (License)
|
|
155
139
|
|
|
156
|
-
|
|
157
|
-
© 2026 [HelloGGX](https://github.com/HelloGGX)
|
|
140
|
+
[MIT License](https://www.google.com/search?q=../../LICENSE.md) © 2026 [HelloGGX](https://github.com/HelloGGX)
|
package/package.json
CHANGED
|
@@ -1,9 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@vibe-coder/cli",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Vibe Coding development tool",
|
|
5
5
|
"private": false,
|
|
6
6
|
"type": "module",
|
|
7
|
+
"author": "HelloGGX",
|
|
8
|
+
"license": "MIT",
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/HelloGGX/skill.git"
|
|
12
|
+
},
|
|
7
13
|
"bin": {
|
|
8
14
|
"vibe": "./bin/vibe"
|
|
9
15
|
},
|
|
@@ -22,7 +28,8 @@
|
|
|
22
28
|
"keywords": [
|
|
23
29
|
"cli",
|
|
24
30
|
"agent-skills",
|
|
25
|
-
"skills"
|
|
31
|
+
"skills",
|
|
32
|
+
"vibe-coding"
|
|
26
33
|
],
|
|
27
34
|
"dependencies": {
|
|
28
35
|
"@clack/prompts": "^1.0.1",
|
|
@@ -33,5 +40,9 @@
|
|
|
33
40
|
"@types/bun": "1.3.9",
|
|
34
41
|
"@types/node": "22.13.9",
|
|
35
42
|
"typescript": "5.8.2"
|
|
36
|
-
}
|
|
43
|
+
},
|
|
44
|
+
"bugs": {
|
|
45
|
+
"url": "https://github.com/HelloGGX/skill/issues"
|
|
46
|
+
},
|
|
47
|
+
"homepage": "https://github.com/HelloGGX/skill#readme"
|
|
37
48
|
}
|