paseo-req-kit 1.8.0-beta.3 → 1.8.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/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,34 @@
|
|
|
2
2
|
|
|
3
3
|
每个版本分为"使用者会看到的变化"和"升级须知"。升级步骤见 [docs/guide/安装与升级.md](docs/guide/安装与升级.md)。
|
|
4
4
|
|
|
5
|
+
## 1.8.0
|
|
6
|
+
|
|
7
|
+
第一个正式版。汇总 1.8.0-beta.1 到 beta.3 的全部内容（各节见下），并让新机器一条命令就能从零用起来。
|
|
8
|
+
|
|
9
|
+
### 使用者会看到的变化
|
|
10
|
+
|
|
11
|
+
- **一键安装改用站点地址**：
|
|
12
|
+
- macOS、Linux、Git Bash、WSL：`curl -fsSL https://paseo-req-kit.vercel.app/install.sh | sh`
|
|
13
|
+
- Windows PowerShell：`irm https://paseo-req-kit.vercel.app/install.ps1 | iex`
|
|
14
|
+
- 原来的 GitHub 地址仍然可用。
|
|
15
|
+
- **一键安装会准备好 Paseo**：
|
|
16
|
+
- 新机器上没有 Paseo 时，脚本先安装与这个版本匹配的 Paseo 命令行（`@getpaseo/cli@~0.11.0`），开启它自带的网页界面，再启动 daemon。装完在浏览器打开 `http://localhost:6767/` 就能用 Paseo 对话，不必另装桌面版。
|
|
17
|
+
- 已有 `paseo` 命令时不重装：核对版本（不在支持范围内时提醒），开启网页界面；daemon 没在运行就启动。daemon 已在运行而网页界面是刚开启的，只提示 `paseo daemon restart`，不自动重启，因为重启会中断正在运行的 agent。
|
|
18
|
+
- 只有桌面版 Paseo 管理的 daemon（没有 `paseo` 命令）时什么都不装，只提示在桌面版中开启网页界面。
|
|
19
|
+
- 一个 agent 命令行（Claude Code、Codex、OpenCode、Pi、Copilot）都没有时会提醒。
|
|
20
|
+
- 不想让脚本动 Paseo 时加 `--skip-paseo`（PowerShell：`$ReqKitSkipPaseo = $true`）。
|
|
21
|
+
- **1.8 的内容**：
|
|
22
|
+
- 按需求类型分流（缺陷先复现、重构先锁行为、评估只出报告）。
|
|
23
|
+
- 质量门、按切片实现、范围检查、关联仓库。
|
|
24
|
+
- 带例子的验收标准、开工前确认方案、评审分规格和规范两个方向、反复出现的问题变成规则。
|
|
25
|
+
- 前后端联合需求。
|
|
26
|
+
|
|
27
|
+
### 升级须知
|
|
28
|
+
|
|
29
|
+
- 这是 npm 上的第一个 `latest` 版本：`npm i -g paseo-req-kit` 和不带 `--beta` 的一键安装从此装正式版。在 beta 通道的（`req upgrade --beta` 或 `@beta`）照常收到之后的 beta 版；没有更新的 beta 时，一键安装的 `--beta` 装正式版，而不是更早的 1.8.0-beta.3。
|
|
30
|
+
- 从 1.7.x 或更早升级：依次看下面 1.8.0-beta.1 到 beta.3 的升级须知。最重要的是在每个项目主目录的对话中再运行一次 `/req-setup`，写入检查命令、术语表和范例文件。
|
|
31
|
+
- 从 1.8.0-beta.3 升级：引擎和提示词没有变化，只改了安装脚本和文档。
|
|
32
|
+
|
|
5
33
|
## 1.8.0-beta.3
|
|
6
34
|
|
|
7
35
|
联合需求：前端和后端分在两个仓库的需求，可以作为一个需求一起做。
|
package/README.md
CHANGED
|
@@ -56,19 +56,19 @@ AI ▸ 结论：已完成，可以验收。6 条验收标准全部通过……
|
|
|
56
56
|
|
|
57
57
|
## 快速开始
|
|
58
58
|
|
|
59
|
-
|
|
59
|
+
在要运行 Paseo 的机器上（需要 Node.js 22+；还没有 Paseo 也可以，脚本会装好）：
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
62
|
# macOS、Linux、Windows 的 Git Bash 或 WSL
|
|
63
|
-
curl -fsSL https://
|
|
63
|
+
curl -fsSL https://paseo-req-kit.vercel.app/install.sh | sh
|
|
64
64
|
```
|
|
65
65
|
|
|
66
66
|
```powershell
|
|
67
67
|
# Windows PowerShell
|
|
68
|
-
irm https://
|
|
68
|
+
irm https://paseo-req-kit.vercel.app/install.ps1 | iex
|
|
69
69
|
```
|
|
70
70
|
|
|
71
|
-
安装脚本会检查环境、安装 `paseo-req-kit
|
|
71
|
+
安装脚本会检查环境、安装 `paseo-req-kit`；没有 Paseo 时安装 Paseo 命令行，开启它自带的网页界面（`http://localhost:6767/`）并启动 daemon；为 Claude Code / Codex / OpenCode / Pi 安装 `/req` 等 skill，并引导你为 builder 和 reviewer 选择 agent。再次运行即升级。然后：
|
|
72
72
|
|
|
73
73
|
1. `req doctor` —— 检查 daemon、agent 模式和额度；
|
|
74
74
|
2. 在项目的 Paseo 对话中运行 `/req-setup` —— 接入项目（每个项目一次）；
|
|
@@ -29,7 +29,7 @@ Windows 上 `~` 即 `%USERPROFILE%`（如 `D:\Users\<用户名>`）。安装器
|
|
|
29
29
|
|
|
30
30
|
| 项目 | 要求 | 如何确认 |
|
|
31
31
|
| --- | --- | --- |
|
|
32
|
-
| Paseo | 0.11，daemon
|
|
32
|
+
| Paseo | 0.11，daemon 在运行（一键安装会在没有时安装 Paseo 命令行并启动） | Paseo 桌面端能正常对话，或浏览器打开 `http://localhost:6767/`；默认地址 `ws://127.0.0.1:6767/ws` |
|
|
33
33
|
| Node.js | 22 或更新 | `node -v` |
|
|
34
34
|
| npm | Node.js 自带；公司网络需配置镜像（`npm config get registry`） | `npm -v` |
|
|
35
35
|
| git | 近期版本（只有 git 方式安装时需要） | `git --version` |
|
|
@@ -45,15 +45,24 @@ Windows 上 `~` 即 `%USERPROFILE%`（如 `D:\Users\<用户名>`）。安装器
|
|
|
45
45
|
|
|
46
46
|
```bash
|
|
47
47
|
# macOS、Linux、Windows 的 Git Bash 或 WSL
|
|
48
|
-
curl -fsSL https://
|
|
48
|
+
curl -fsSL https://paseo-req-kit.vercel.app/install.sh | sh
|
|
49
49
|
```
|
|
50
50
|
|
|
51
51
|
```powershell
|
|
52
52
|
# Windows PowerShell（不受脚本执行策略限制）
|
|
53
|
-
irm https://
|
|
53
|
+
irm https://paseo-req-kit.vercel.app/install.ps1 | iex
|
|
54
54
|
```
|
|
55
55
|
|
|
56
|
-
脚本依次：检查 Node.js 22+、npm、git；从 npm 安装 `paseo-req-kit`，npm 上没有时改用 GitHub Release 的安装包；npm 全局目录不可写时装到 `~/.req-kit/npm`（不需要 sudo
|
|
56
|
+
脚本依次：检查 Node.js 22+、npm、git；从 npm 安装 `paseo-req-kit`，npm 上没有时改用 GitHub Release 的安装包；npm 全局目录不可写时装到 `~/.req-kit/npm`（不需要 sudo）；**检查 Paseo**（见下）；运行 `req setup`；本机配置还没填时运行 `req configure`；最后提示把 `req` 加入 PATH（如需要）。选项：`install.sh` 写在 `sh -s --` 之后（`--beta`、`--version <版本>`、`--from npm|release`、`--no-configure`、`--skip-paseo`）；`install.ps1` 用变量（`$ReqKitBeta = $true; irm … | iex`，还有 `$ReqKitVersion`、`$ReqKitFrom`、`$ReqKitNoConfigure`、`$ReqKitSkipPaseo`）。
|
|
57
|
+
|
|
58
|
+
检查 Paseo 这一步：
|
|
59
|
+
|
|
60
|
+
- **有 `paseo` 命令**：核对它的版本是否在这个 req-kit 支持的范围内（不在时提醒，不替换）；开启 daemon 自带的网页界面（`paseo daemon config set features.webUi.enabled true`）；daemon 没在运行就 `paseo daemon start`。daemon 已在运行而网页界面是刚开启的，只提示 `paseo daemon restart`，不自动重启——重启会中断正在运行的 agent。
|
|
61
|
+
- **没有 `paseo` 命令，但 daemon 在运行**：通常是桌面版 Paseo 管理的 daemon，什么都不装；需要网页界面时在桌面版中开启。
|
|
62
|
+
- **都没有（新机器）**：用 npm 安装与 req-kit 匹配的 Paseo 命令行（例如 `@getpaseo/cli@~0.11.0`），开启网页界面，启动 daemon。之后在浏览器打开 `http://localhost:6767/` 就能用 Paseo 对话。
|
|
63
|
+
- 最后检查有没有 agent 命令行（Claude Code、Codex、OpenCode、Pi、Copilot），一个都没有时提醒：至少装一个并登录，再运行 `req configure`。
|
|
64
|
+
|
|
65
|
+
不想让脚本动 Paseo（例如由别人统一管理）时加 `--skip-paseo`。完成后接着做下面的**第四步**到**第六步**。
|
|
57
66
|
|
|
58
67
|
**也可以用 npm 安装（1.7.0 起）。** 一键安装做的就是这几条命令，Windows 上 `req` 命令由 npm 放进 PATH，不用自己设置：
|
|
59
68
|
|
|
@@ -77,19 +86,19 @@ req doctor --no-project # 体检
|
|
|
77
86
|
**第一步：取得程序。** 把要安装的版本放进它自己的版本目录：
|
|
78
87
|
|
|
79
88
|
```bash
|
|
80
|
-
git clone --branch 1.8.0
|
|
89
|
+
git clone --branch 1.8.0 --depth 1 https://github.com/yiyisf/paseo-req-kit ~/tools/req-kit/versions/1.8.0
|
|
81
90
|
```
|
|
82
91
|
|
|
83
92
|
Windows PowerShell：
|
|
84
93
|
|
|
85
94
|
```powershell
|
|
86
|
-
git clone --branch 1.8.0
|
|
95
|
+
git clone --branch 1.8.0 --depth 1 https://github.com/yiyisf/paseo-req-kit "$env:USERPROFILE\tools\req-kit\versions\1.8.0"
|
|
87
96
|
```
|
|
88
97
|
|
|
89
98
|
**第二步：安装依赖并启用。**
|
|
90
99
|
|
|
91
100
|
```bash
|
|
92
|
-
cd ~/tools/req-kit/versions/1.8.0
|
|
101
|
+
cd ~/tools/req-kit/versions/1.8.0
|
|
93
102
|
npm install
|
|
94
103
|
node install.mjs
|
|
95
104
|
```
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "paseo-req-kit",
|
|
3
|
-
"version": "1.8.0
|
|
3
|
+
"version": "1.8.0",
|
|
4
4
|
"description": "req-kit: a requirement-development workflow for Paseo. /req aligns a requirement in chat; the engine runs design, implementation, review and verification as Paseo agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
"type": "git",
|
|
9
9
|
"url": "git+https://github.com/yiyisf/paseo-req-kit.git"
|
|
10
10
|
},
|
|
11
|
-
"homepage": "https://
|
|
11
|
+
"homepage": "https://paseo-req-kit.vercel.app/",
|
|
12
12
|
"bugs": "https://github.com/yiyisf/paseo-req-kit/issues",
|
|
13
13
|
"keywords": [
|
|
14
14
|
"paseo",
|