@rowansenne/workflow-run 0.22.1 → 0.22.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/CHANGELOG.md +6 -0
- package/README.md +12 -10
- package/bin/lib/docsrepo.mjs +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,12 @@
|
|
|
4
4
|
|
|
5
5
|
## [Unreleased]
|
|
6
6
|
|
|
7
|
+
## [0.22.2] - 2026-10-19
|
|
8
|
+
|
|
9
|
+
### 文档
|
|
10
|
+
- 新增架构介绍页 `docs/architecture.html`：五层结构、dev 主线流程与规模分级、设计约定、8 个 skill 与依赖、产物与 DocNexus 知识闭环、运行反馈；README 快速开始里加了链接。
|
|
11
|
+
- 推荐的安装命令默认带 `--with-docnexus --with-codegraph`：README 快速开始和非交互示例、架构介绍页、`docs-repo` 在还没安装时的提示都改成全量安装；最小安装（只装 skills）作为示例保留。
|
|
12
|
+
|
|
7
13
|
## [0.22.1] - 2026-10-19
|
|
8
14
|
|
|
9
15
|
### 变更
|
package/README.md
CHANGED
|
@@ -13,28 +13,30 @@
|
|
|
13
13
|
> 本工具在项目里的产出（需求产物、DocNexus 工作区、项目模板、临时文件）都放在项目根的
|
|
14
14
|
> `workflow-run/`
|
|
15
15
|
> 一个目录里，不往项目的其他地方写；它可以随代码提交，也可以整个是团队的独立文档仓库（见「独立文档仓库」）。
|
|
16
|
-
> 安装只用 `npx @rowansenne/workflow-run
|
|
16
|
+
> 安装只用 npx，在项目根执行。推荐 `npx @rowansenne/workflow-run --with-docnexus --with-codegraph`，同时接入 DocNexus 文档库和 CodeGraph 代码图谱。
|
|
17
17
|
|
|
18
18
|
## 快速开始
|
|
19
19
|
|
|
20
|
-
需要 **Node.js >= 22
|
|
20
|
+
需要 **Node.js >= 22.13**（DocNexus 的要求；不接 DocNexus 时 >= 22 即可，code-graph 的 `impact` / `entry` 需 >= 22.5）。只用 npx 安装，在项目根执行（以当前目录为项目根；Windows 要在管理员终端里运行）。推荐全量安装：
|
|
21
21
|
|
|
22
22
|
```
|
|
23
|
-
npx @rowansenne/workflow-run
|
|
23
|
+
npx @rowansenne/workflow-run --with-docnexus --with-codegraph
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
按提示：选择环境（编号多选，回车 = 全部）→ 确认 / 填写数据库连接 →
|
|
26
|
+
按提示：选择环境（编号多选，回车 = 全部）→ 确认 / 填写数据库连接 → 自动生成。`--with-docnexus` 接入 DocNexus 文档库（开发约定与审查问题的沉淀和召回、团队定制的文档模板），`--with-codegraph` 接入 CodeGraph 代码图谱（改动影响到的接口、MQ、定时任务和测试）；不需要哪一项就去掉对应参数。装完后在 agent 里运行 `/workflow profile` 填写项目画像。
|
|
27
27
|
|
|
28
|
-
|
|
28
|
+
全量安装的分步说明见图文教程 [docs/full-install.html](docs/full-install.html)（下载后用浏览器打开）。
|
|
29
|
+
|
|
30
|
+
整体架构（五层结构、dev 主线流程、设计约定、产物与知识闭环）见 [docs/architecture.html](docs/architecture.html)（下载后用浏览器打开）。
|
|
29
31
|
|
|
30
32
|
非交互示例（bash、zsh、PowerShell 写法一样）：
|
|
31
33
|
|
|
32
34
|
```
|
|
33
|
-
npx @rowansenne/workflow-run --envs all --yes
|
|
34
|
-
npx @rowansenne/workflow-run --envs codex,qwen --skip-db
|
|
35
|
-
npx @rowansenne/workflow-run --envs
|
|
36
|
-
npx @rowansenne/workflow-run --envs
|
|
37
|
-
npx @rowansenne/workflow-run uninstall
|
|
35
|
+
npx @rowansenne/workflow-run --envs all --yes --with-docnexus --with-codegraph # 用现有数据库配置，装全部环境
|
|
36
|
+
npx @rowansenne/workflow-run --envs codex,qwen --skip-db --with-docnexus --with-codegraph # 跳过数据库
|
|
37
|
+
npx @rowansenne/workflow-run --envs all --skip-db --copy --with-docnexus --with-codegraph # 不用软链接，各环境独立拷贝
|
|
38
|
+
npx @rowansenne/workflow-run --envs claude --skip-db # 最小安装：只装 skills，不接 DocNexus 和 CodeGraph
|
|
39
|
+
npx @rowansenne/workflow-run uninstall # 按安装清单卸载
|
|
38
40
|
```
|
|
39
41
|
|
|
40
42
|
### 子命令
|
package/bin/lib/docsrepo.mjs
CHANGED
|
@@ -95,7 +95,7 @@ export function docsRepo(root, { url, project }) {
|
|
|
95
95
|
if (tracked) warn(`代码仓库里还跟踪着 ${HOME}/ 下的文件，运行 git rm -r --cached ${HOME} 后提交，代码仓库就不再管它`);
|
|
96
96
|
|
|
97
97
|
if (!installed) {
|
|
98
|
-
warn(`本项目还没安装 skills：先运行 npx @rowansenne/workflow-run，项目名之后用 docs-repo --project <项目名> 配置（或第一次落盘时 skill 会问）`);
|
|
98
|
+
warn(`本项目还没安装 skills：先运行 npx @rowansenne/workflow-run --with-docnexus --with-codegraph，项目名之后用 docs-repo --project <项目名> 配置（或第一次落盘时 skill 会问）`);
|
|
99
99
|
return 0;
|
|
100
100
|
}
|
|
101
101
|
const name = project || artifactsConfig(root).project || suggestProject(root);
|
package/package.json
CHANGED