ai-jue 1.0.0
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 +107 -0
- package/package.json +13 -0
package/README.md
ADDED
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
# jue (诀) - 你的个人 AI 编码心法
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/jue-core)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://travis-ci.org/your-username/jue)
|
|
6
|
+
|
|
7
|
+
> “道生一，一生二，二生三，三生万物。此为心法，亦为神诀。”
|
|
8
|
+
|
|
9
|
+
**jue (诀)** 是一个可扩展的、插件化的 AI 编码能力管理框架。它旨在解决开发者在使用 AI 辅助编码时，宝贵经验（Prompts, Workflows, Rules）散落各处、难以复用、无法沉淀的问题。
|
|
10
|
+
|
|
11
|
+
通过 `jue`，你可以将这些零散的“灵光一闪”提炼为可被版本控制、一键应用的“心法秘诀”，构建一个真正属于你自己的、不断进化的 AI 能力库。
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## 核心理念
|
|
16
|
+
|
|
17
|
+
我们常常发现，高质量的 AI 指令（Prompts）是提升编码效率的关键，但这些指令却：
|
|
18
|
+
|
|
19
|
+
- **难以管理**：散落在聊天记录、笔记、甚至大脑的记忆里。
|
|
20
|
+
- **难以复用**：在项目 A 中好用的 Prompt，很难方便地应用到项目 B。
|
|
21
|
+
- **工具锁定**：为 VSCode Copilot 优化的经验，无法直接用于 Gemini 或其他工具。
|
|
22
|
+
|
|
23
|
+
**`jue` 的核心哲学，就是将这些宝贵的、无形的经验，转化为结构化的、可移植的“能力模块”。**
|
|
24
|
+
|
|
25
|
+
它通过一个**“核心引擎 + 插件生态”**的架构，让你能够：
|
|
26
|
+
|
|
27
|
+
1. **沉淀经验**：将你的 AI 使用技巧，以标准化的形式固化下来。
|
|
28
|
+
2. **按需组合**：像搭乐高一样，为不同项目组合不同的“能力画像 (Profile)”。
|
|
29
|
+
3. **一键应用**：通过 `jue` 命令，将这些能力一键应用到任何项目、任何 AI 工具上。
|
|
30
|
+
|
|
31
|
+
## 它是如何工作的？
|
|
32
|
+
|
|
33
|
+
`jue` 的生态系统由两部分构成：
|
|
34
|
+
|
|
35
|
+
- **`jue-core` (核心引擎)**: 一个轻量的命令行工具，负责发现插件、解析画像、生成配置。
|
|
36
|
+
- **`jue-plugin-*` (插件包)**: 独立的 npm 包，提供实际的“物料”，包括：
|
|
37
|
+
- **模块 (Modules)**: 原子化的能力单元（如，一个用于代码审查的 `skill`，一个关于 React 技术栈的 `context`）。
|
|
38
|
+
- **画像 (Profiles)**: 预设的模块组合，为特定场景（如 `React 前端开发`）服务。
|
|
39
|
+
- **模板 (Templates)**: 针对特定 AI 工具（如 Gemini, VSCode）的配置文件模板。
|
|
40
|
+
|
|
41
|
+
**工作流示意**:
|
|
42
|
+
`jue apply` -> `jue-core` 读取 `Profile` -> 从各插件中“装配”`Modules` -> 填入 `Template` -> 生成最终配置文件
|
|
43
|
+
|
|
44
|
+
## 快速开始
|
|
45
|
+
|
|
46
|
+
1. **安装核心引擎与插件**
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# 安装核心引擎
|
|
50
|
+
npm install -g jue-core
|
|
51
|
+
|
|
52
|
+
# 按需安装官方或社区的“物料包”
|
|
53
|
+
npm install -g jue-plugin-base # 基础技能包
|
|
54
|
+
npm install -g jue-plugin-react # React 技能包
|
|
55
|
+
npm install -g jue-plugin-gemini # Gemini 适配包
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
2. **使用 `jue`**
|
|
59
|
+
|
|
60
|
+
**场景一：为你的系统设置一套通用的“全局心法”**
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
# 将 base/default 画像中的能力，应用到用户全局的 gemini 配置中
|
|
64
|
+
jue apply --profile base/default --scope user --tools gemini
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
现在，无论在哪个项目，你的 Gemini 都具备了基础的代码审查等能力。
|
|
68
|
+
|
|
69
|
+
**场景二：为一个 React 项目赋予“专属诀窍”**
|
|
70
|
+
|
|
71
|
+
```bash
|
|
72
|
+
# 进入你的 React 项目目录
|
|
73
|
+
cd my-react-app
|
|
74
|
+
|
|
75
|
+
# 应用 React 画像，仅在此项目生效
|
|
76
|
+
jue apply --profile react/standard --tools gemini
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
项目下会立刻生成一个包含 React 专属技能的 `GEMINI.md` 文件。
|
|
80
|
+
|
|
81
|
+
## 核心旅程：经验的“成长飞轮”
|
|
82
|
+
|
|
83
|
+
`jue` 的使用是一个螺旋上升的成长过程：
|
|
84
|
+
|
|
85
|
+
1. **应用 (Apply)**: 在项目中，通过 `jue apply` 复用你已有的 AI 经验。
|
|
86
|
+
2. **发现 (Discover)**: 在实践中，你创造出一段更高效、更惊艳的 Prompt。
|
|
87
|
+
3. **沉淀 (Capture)**: 你将这段新 Prompt 抽象出来，保存为你个人插件包 (`jue-plugin-personal`) 中的一个新 `skill` 模块。
|
|
88
|
+
4. **成长 (Grow)**: 你的个人“秘诀库”变得更强大。下一次，你可以将这个新 `skill` 应用到任何项目中。
|
|
89
|
+
|
|
90
|
+
## 参与贡献与生态建设
|
|
91
|
+
|
|
92
|
+
`jue` 的魅力在于其开放的插件生态。我们欢迎任何开发者创建和发布自己的 `jue-plugin-*` 包。
|
|
93
|
+
|
|
94
|
+
创建一个插件非常简单：
|
|
95
|
+
|
|
96
|
+
1. 遵循 `jue-plugin-*` 的命名约定。
|
|
97
|
+
2. 在 `package.json` 中加入 `"keywords": ["jue-plugin"]`。
|
|
98
|
+
3. 按照规范组织你的 `modules/` 和 `profiles/` 目录。
|
|
99
|
+
4. 发布到 npm！
|
|
100
|
+
|
|
101
|
+
## 项目愿景
|
|
102
|
+
|
|
103
|
+
我们希望 `jue` 能成为每位开发者手中的“神兵利器”——一个不断成长的、个性化的、跨平台的 AI 编码“心法总纲”。它将开发者从繁琐的、重复的 AI 指令调优中解放出来，专注于创造本身，让 AI 真正成为开发者心意相通的伙伴。
|
|
104
|
+
|
|
105
|
+
## License
|
|
106
|
+
|
|
107
|
+
[MIT](LICENSE)
|
package/package.json
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "ai-jue",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "[](https://www.npmjs.com/package/jue-core) [](LICENSE) [](https://travis-ci.org/your-username/jue)",
|
|
5
|
+
"main": "index.js",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"test": "echo \"Error: no test specified\" && exit 1"
|
|
8
|
+
},
|
|
9
|
+
"keywords": [],
|
|
10
|
+
"author": "",
|
|
11
|
+
"license": "ISC",
|
|
12
|
+
"type": "commonjs"
|
|
13
|
+
}
|