@rowansenne/workflow-run 0.37.0 → 0.37.1

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
@@ -4,6 +4,12 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.37.1] - 2026-11-21
8
+
9
+ ### 修复
10
+
11
+ - Wiki 发布记录直接从 Markdown 读取,本地产物索引不再保存或检查 Wiki 字段。首次发布和再次发布后,报告与视图会直接显示最新发布记录,无需手动刷新索引。[#10](https://github.com/guilianerde/skills-init/issues/10)
12
+
7
13
  ## [0.37.0] - 2026-11-20
8
14
 
9
15
  ### 变更
@@ -75,7 +75,7 @@ description: "Generate a Markdown release/deployment plan (上线方案) from th
75
75
  ### Step 4 — 写文件
76
76
 
77
77
  - 正式收尾:Step 4 进入 L4,先写 `workflow-run/tmp/release-doc.md` 草稿,再用 `node <skills>/workflow/scripts/artifact.mjs finalize --id <运行id> --expect-revision <revision> --kind release --draft <草稿> --branch <dev分支>` 自检、归档旧版、发布并更新索引/运行证据;使用返回的 path / cite,规则见 `<skills>/workflow/references/execution.md`。
78
- - 收尾输出 previous 非空时告诉用户上一版的归档位置,不能替用户删除;中断先 `artifact.mjs resume --id <运行id>`。独立文档仓库的提交提示用 `requirement.mjs pending`,按 requirements.md 处理;后续 wiki/沉淀元信息只刷新派生索引时显式运行 `requirement.mjs reindex`。
78
+ - 收尾输出 previous 非空时告诉用户上一版的归档位置,不能替用户删除;中断先 `artifact.mjs resume --id <运行id>`。独立文档仓库的提交提示用 `requirement.mjs pending`,按 requirements.md 处理。更新知识沉淀元信息后用 `requirement.mjs reindex` 刷新派生索引。
79
79
  - 收尾前对草稿运行 `node <skills>/workflow/scripts/lint-doc.mjs <草稿> --skill create-release-md-doc --facts` 自检(`--facts` 按元信息行的对比分支核对正文里的类名、文件、接口、表名):有「错误」先修正再交付(缺必填章节、残留 `{{...}}` 占位符、缺元信息行);「警告」按实际情况处理,其中「在 diff 和代码里都找不到」的名字逐个核实:确属编造就改成 diff 里的真实名字或写「待补充」,是外部系统 / 配置中心的名字就保留;「提示」里的待填写位置在交付摘要中告诉用户。
80
80
  - 再把路径和摘要告诉用户,按取材规则列出实际引用的 dev 产物及版本。
81
81
 
@@ -78,7 +78,7 @@ PRD 参考:<pageId 或 URL 或「无」/「PRD 增强已跳过」>
78
78
  ### Step 4 — 写文件
79
79
 
80
80
  - 正式收尾:Step 4 进入 T4,先写 `workflow-run/tmp/tech-doc.md` 草稿,再用 `node <skills>/workflow/scripts/artifact.mjs finalize --id <运行id> --expect-revision <revision> --kind tech --draft <草稿> --branch <dev分支>` 自检、归档旧版、发布并更新索引/运行证据;使用返回的 path / cite,规则见 `<skills>/workflow/references/execution.md`。
81
- - 收尾输出 previous 非空时告诉用户上一版的归档位置,不能替用户删除;中断先 `artifact.mjs resume --id <运行id>`。独立文档仓库的提交提示用 `requirement.mjs pending`,按 requirements.md 处理;后续 wiki/沉淀元信息只刷新派生索引时显式运行 `requirement.mjs reindex`。
81
+ - 收尾输出 previous 非空时告诉用户上一版的归档位置,不能替用户删除;中断先 `artifact.mjs resume --id <运行id>`。独立文档仓库的提交提示用 `requirement.mjs pending`,按 requirements.md 处理。更新知识沉淀元信息后用 `requirement.mjs reindex` 刷新派生索引。
82
82
  - 收尾前对草稿运行 `node <skills>/workflow/scripts/lint-doc.mjs <草稿> --skill create-tech-md-doc --facts --diff <main>...<dev>` 自检,显式按三点范围核对正文里的类名、文件、接口、表名。有「错误」先修正再交付(缺必填章节、残留 `{{...}}` 占位符);不再强制可见元信息行,但隐藏分支仍须与运行一致。「警告」按实际情况处理,其中「在 diff 和代码里都找不到」的名字逐个核实:确属编造就改成 diff 里的真实名字或写「待补充」,是外部系统 / 配置中心的名字就保留;「提示」里的待填写位置在交付摘要中告诉用户。
83
83
  - 再把路径和摘要告诉用户,按取材规则列出实际引用的 dev 产物及版本。
84
84
 
@@ -47,4 +47,4 @@
47
47
 
48
48
  - **需求名**:Step 0 已运行 `requirement.mjs which` 并问定名字。第一次落盘前运行 `requirement.mjs bind --name "<需求名>"`(用户明确同意按分支名生成时不带 `--name`);S 快速通道不 bind、不落盘。缺陷修复同样处理(可以选择挂到原需求下)。
49
49
  - **正式写入**:按 `<skills>/workflow/references/execution.md`,澄清清单、需求、方案、审查、交付都先写 tmp 草稿,再用 `artifact.mjs finalize --kind clarification|requirement|plan|review|delivery` 完成自检、旧版归档、索引与运行证据登记。缺陷修复在 B4 的方案草稿中保留原文并追加修复方案,不另建正式文件。
50
- - 使用输出的 path / cite 引用;previous 非空时告知上一版归档位置,不能替用户删除。中断先 `artifact.mjs resume --id <id>`,不能继续 reindex / save 覆盖待办。独立文档仓库在交付完成后运行 pending,按 requirements.md 提示提交。已完成交付的 wiki/DocNexus 元信息更新使用显式 reindex。
50
+ - 使用输出的 path / cite 引用;previous 非空时告知上一版归档位置,不能替用户删除。中断先 `artifact.mjs resume --id <id>`,不能继续 reindex / save 覆盖待办。独立文档仓库在交付完成后运行 pending,按 requirements.md 提示提交。已完成交付的 DocNexus 元信息更新使用显式 reindex。
@@ -73,7 +73,7 @@ git status --short --ignored
73
73
 
74
74
  ```
75
75
  workflow-run/docs/requirements/<需求名>/<项目名>/
76
- ├── meta.json # runs 保存分支运行状态、逐步完成标记与完成时间;另含 需求名、绑定的分支、各产物(版本、日期、wiki 发布记录、DocNexus 沉淀),给以后的可视化用
76
+ ├── meta.json # runs 保存分支运行状态、逐步完成标记与完成时间;另含 需求名、绑定的分支、各产物(版本、日期、DocNexus 沉淀)
77
77
  ├── clarification.md # 业务场景清单(F2 / B3,多轮核对产品答复)
78
78
  ├── requirement.md # 需求文档(F3 / B3 收尾:目标、范围、AC 验收与澄清决定)
79
79
  ├── plan.md # 方案(dev,非快速通道都写;S / M 简版;缺陷修复追加修复方案节)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rowansenne/workflow-run",
3
- "version": "0.37.0",
3
+ "version": "0.37.1",
4
4
  "description": "项目级 Agent Skills 一键初始化:workflow / dev / project-review / code-graph / database-query / nacos-config / md-to-wiki / 需求文档与技术上线方案生成",
5
5
  "keywords": [
6
6
  "agent-skills",
@@ -3,7 +3,7 @@ import fs from 'node:fs';
3
3
  import path from 'node:path';
4
4
  import { spawnSync } from 'node:child_process';
5
5
  import { updateMeta } from './meta-store.mjs';
6
- import { FILES, LABELS, parseFile, parseBranch, parseWiki, parseDocnexus, headerDate } from './artifact-model.mjs';
6
+ import { FILES, LABELS, parseFile, parseBranch, parseDocnexus, headerDate } from './artifact-model.mjs';
7
7
  import { HOME, REQ_DIR, TMP_DIR, dirName, profileDir, layout, setConfig } from './project.mjs';
8
8
  import { requirements, repoRequirements, find } from './requirement-read.mjs';
9
9
  import { loadWorkspace } from './workspace-read.mjs';
@@ -31,7 +31,6 @@ export function indexArtifacts(dir, versions = {}, { requireVersion = false } =
31
31
  file: name,
32
32
  branch: parseBranch(text),
33
33
  date: headerDate(text),
34
- wiki: parseWiki(text),
35
34
  docnexus: parseDocnexus(text),
36
35
  ...(requireVersion && !registered ? { registered: false } : {}),
37
36
  };
@@ -84,7 +84,7 @@ export function loadWorkspace(root, { allProjects = false, allBranches = false }
84
84
  artifacts.push(a);
85
85
  const indexed = index.find((i) => i.file === entry.name);
86
86
  if ((Array.isArray(req.meta.artifacts) && !indexed) || (indexed && (indexed.branch !== a.branch || indexed.date !== a.date
87
- || JSON.stringify(indexed.wiki) !== JSON.stringify(a.wiki) || (indexed.registered !== false && indexed.version !== a.version)
87
+ || (indexed.registered !== false && indexed.version !== a.version)
88
88
  || JSON.stringify(indexed.docnexus ?? []) !== JSON.stringify(a.knowledge)))) {
89
89
  diagnostics.push({ code: 'stale_index', path: file, message: '文档与已登记索引不一致,请显式 reindex' });
90
90
  }
@@ -50,7 +50,7 @@ Skills 命令脚本保留参数解析和人类可读输出,不转导出底层
50
50
 
51
51
  只允许写以下派生字段:
52
52
 
53
- - `artifacts`:当前目录内已识别产物的派生索引。
53
+ - `artifacts`:当前目录内已识别产物的派生索引。Wiki 发布记录直接从 Markdown 读取,重建索引时会移除旧索引项中的 `wiki` 字段。
54
54
  - `latest`:每种产物的最新文件,可能包含未登记版本。
55
55
  - `indexed_at`:只在 `artifacts` 或 `latest` 变化、或旧数据缺少该字段时更新。
56
56
 
@@ -127,7 +127,7 @@ feature 可在 checkpoint 标 F7 completed;bug 的 B5 此时仍 in_progress。
127
127
 
128
128
  finalize 先用知识库当前模板 lint 精确的草稿内容,再校验运行 revision、阶段、分支和证据;通过后归档旧版、发布正式文件、更新版本/索引、登记运行证据。checkpoint 只能更新当前产物所属步骤、等待状态和上下文,不能夹带下游阶段或用户确认。输出正式 path、cite、previous、version、lint、run;自检警告和待填写项要告知用户,引用用 cite,归档遵循 requirements.md,不能替用户删除。
129
129
 
130
- 正式文档先写 tmp 草稿;旧 `requirement.mjs path` 入口已删除,不能通过直接覆盖正式文件绕过收尾中断保护。tech / release 分别在 T4 / L4 用 kind tech / release 收尾,使用各自的知识模板;wiki/沉淀后只更新发布或知识元信息仍可显式 reindex,但 reindex 不修复正文 hash 或旧证据。
130
+ 正式文档先写 tmp 草稿;旧 `requirement.mjs path` 入口已删除,不能通过直接覆盖正式文件绕过收尾中断保护。tech / release 分别在 T4 / L4 用 kind tech / release 收尾,使用各自的知识模板。Wiki 发布记录直接从 Markdown 读取。更新知识沉淀元信息后显式 reindex,仅刷新派生索引。
131
131
 
132
132
  技术方案将生成时间、对比分支、diff 概览、PRD 参考和模板来源放在文件头的 `<!-- workflow-run: … -->` 多行注释中(格式见 create-tech-md-doc,整个块在前 20 行内),不要求正文显示元信息引用块。分支校验仍读取注释中的 `对比分支:`,索引日期读取其中的 `生成时间:`;旧文档的可见元信息继续兼容。注释随正式文件一起归档并参与 hash 校验,Wiki 转换时移除;`meta.json` 仍按现有逻辑记录绑定、索引和运行,不自动接收全部注释字段。
133
133
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  ```
8
8
  workflow-run/docs/requirements/<需求名>/<项目名>/
9
- ├── meta.json # 运行记录 runs(阶段、步骤完成标记、等待决定、上下文、完成时间)及 需求名、绑定的分支、各产物(种类、版本、日期、wiki 发布记录、DocNexus 沉淀)
9
+ ├── meta.json # 运行记录 runs(阶段、步骤完成标记、等待决定、上下文、完成时间)及 需求名、绑定的分支、各产物(种类、版本、日期、DocNexus 沉淀)
10
10
  ├── clarification.md # 业务场景清单(F2 / B3,多轮场景核对、产品答复与追加问题)
11
11
  ├── requirement.md # 需求文档(F3 / B3 收尾;目标、范围、AC 验收与澄清决定)
12
12
  ├── plan.md # 方案(dev,非快速通道都写;S / M 简版;缺陷修复追加修复方案节)
@@ -59,7 +59,7 @@ node <skills>/workflow/scripts/requirement.mjs which
59
59
  - 原文第一行的 md-to-wiki 页面记录自动保留,新版仍发布同一页;不能在普通文档收尾中替换页面归属。
60
60
  - 文件发布与元信息不能跨文件一次原子提交。待完成收尾保存在同一 meta.json;中断先 `artifact.mjs resume --id <id>`,不能继续 reindex / save 越过待办。代码或正文冲突时停止,取消和恢复规则见 execution.md。
61
61
  - 旧 `requirement.mjs path` 和 `sync` 写入命令已删除。查询已有产物用 artifacts / list,正式写入与 cite 用 finalize 输出。
62
- - wiki 发布或知识沉淀更新文档元信息后显式 `requirement.mjs reindex`。它只重建派生索引并保留 runs、versions 和证据;需求绑定只由 bind 修改,不根据文档头隐式新增。
62
+ - Wiki 发布记录直接从 Markdown 读取,写回后即可在状态、报告和视图中看到。知识沉淀更新文档元信息后显式运行 `requirement.mjs reindex`,只重建派生索引。需求绑定由 bind 修改。
63
63
  - 文档/索引不一致、元信息损坏或引用缺失进入只读诊断;文件存在不代表运行完成。确认正文后显式 reindex,损坏的 meta 先人工核对修复。已有旧运行缺少新证据时回到对应阶段重新收尾/验证,不自动补用户确认。
64
64
  - 独立文档仓库在允许提示提交的阶段运行 `requirement.mjs pending`,沿用下节规则;dev 内部审查延后到 F8。
65
65
 
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  // 产物按需求归档:方案、交付说明、审查报告、技术方案、上线方案按需求放在一起,meta.json 汇总需求名、绑定的分支、各产物、
3
- // wiki 发布记录与 DocNexus 沉淀,供 /workflow view 等直接读取。
3
+ // DocNexus 沉淀。/workflow view 等从 Markdown 读取 Wiki 发布记录。
4
4
  // 本工具的产出都在项目根的 workflow-run/ 里(需求产物 docs/requirements/、DocNexus 工作区 docnexus/、项目模板 templates/、临时文件 tmp/),
5
5
  // 不往项目的其他地方写。两种用法:
6
6
  // 两种用法的目录结构完全一样:产物都在 workflow-run/docs/requirements/<需求名>/<项目名>/,一个需求横跨多个服务时各项目各占一个子目录,