@rowansenne/workflow-run 0.26.1 → 0.27.0

package/workflow/references/templates.md

@@ -1,30 +1,27 @@
 # 模板来源（文档类 skill 共用）
 
-技术方案、上线方案、开发方案、审查清单的模板由脚本判定，各 skill 不自行查找：
+技术方案、上线方案、方案、审查清单的模板由脚本判定，各 skill 不自行查找：
 
 ```
 node <skills>/workflow/scripts/resolve.mjs template <skill> <文件名>
 ```
 
-`<skills>` 是本 skill 所在的 skills 目录（如 `.agents/skills`），在项目根执行。输出 JSON：`path` 是要读的模板，`source` 是 `docnexus` / `default`，写进产出的「模板来源」。
+`<skills>` 是本 Skill 所在的 skills 目录（如 `.agents/skills`）。开工快照的 `templates` 已包含解析结果；使用前按需用上述命令刷新。成功时读 `path`，`source` 固定为 `docnexus`。
 
-**skills 自带的默认模板只读**：不要直接编辑 skills 目录里的模板文件（升级时会被覆盖），也不要在 `workflow-run/templates/` 放项目模板（已不再生效）。要改模板只有一条路：写进 DocNexus 知识库，团队通过知识库共享同一份。
+DocNexus 是必装组件，知识库 `workflow-run/docnexus/library/templates/<skill>/<文件名>` 是唯一模板来源。包内模板仅用于首次导入，不作为运行时后备；`workflow-run/templates/` 里的旧项目模板不生效。必装组件不可用统一按 capabilities.md 修复。
 
-判定规则（实现在脚本里，这里只是说明）：
+缺少本次所需模板时停在该步骤，统一按输出处理：
 
-- **已接入 DocNexus**：只用 `workflow-run/docnexus/library/templates/<skill>/<文件名>`（分类 `doc-template`，普通 Markdown，手工改动立即生效）。不使用 skill 默认模板，也不使用 `workflow-run/templates/`——知识库是唯一来源，避免几份模板各自演化。
-  - 缺模板时退出码 2，输出 `expected`（应在的位置）、`import_from`（可导入的来源）和 `hint`。**停下这一步**，告诉用户缺哪份模板，给两个选择：在项目根运行 `npx @rowansenne/workflow-run seed-templates`（或重跑安装加 `--seed-templates`）；或者由你在用户确认后按 DocNexus 的 capture 流程把 `import_from` 写入 `expected`，以显式分类封存（`draft seal ... --category doc-template`，metadata.category 也写 `doc-template`）。导入后再继续。
-- **未接入 DocNexus**：只用 skill 默认模板，不能修改或新建模板。
-- 输出里 `stale_project_file` 非空：`workflow-run/templates/` 下的这份已不再生效，提醒用户导入 DocNexus 后删除（未接入时先接入）。
-- **技术方案、上线方案没有默认模板**（`create-tech-md-doc`、`create-release-md-doc` 的 `template.md`）：各团队发到 wiki 的格式不同，skills 不自带固定格式，第一次使用时按样例创建到知识库。
-  - 已接入 DocNexus、还没创建：退出码 2，输出 `on_demand: true`、`expected`（知识库里的位置）和 `hint`，按下面「创建模板」处理。
-  - 未接入 DocNexus：退出码 2，输出 `need_docnexus: true` 和 `hint`。**停下这一步**，告诉用户这两类文档的模板只保存在 DocNexus 里，要先重跑 npx @rowansenne/workflow-run 并加 `--with-docnexus` 接入，再创建模板。不要自己编一份模板凑数。
+- 有内置导入来源：运行 `npx @rowansenne/workflow-run seed-templates` 导入（已有的不覆盖），或经用户确认按 capture 流程把 `import_from` 写入 `expected`。
+- `on_demand: true`：技术方案、上线方案没有内置模板，按下文「创建模板」请用户提供团队样例，不编造通用模板。
+- 模板写入按 `doc-template` 分类封存。完成后刷新能力快照再继续；已有运行保存等待事项，不丢失进度。
+- `stale_project_file` 非空：提示这是已不生效的旧文件，确认已导入知识库后再删除。
 
-`resolve.mjs templates` 列出所有登记模板的来源；登记表在各 skill 的 `skill.json`（`templates` 字段）。`--with-docnexus` 接入时会自动导入默认模板，之后可运行 `npx @rowansenne/workflow-run seed-templates` 补导入（已存在的不覆盖）。
+`resolve.mjs templates` 列出所有登记模板；登记表在各 Skill 的 `skill.json`。安装和升级自动补入内置模板。
 
 ## 修改模板（/workflow template）
 
-用户要改某份模板（「技术方案模板加一节回滚」「上线方案去掉灰度那节」「审查报告的严重问题表加一列」），或要新建、按样例重做模板时，用 `template.mjs` 一路走完，不要直接编辑生效中的模板文件。未接入 DocNexus 时 `draft` / `save` 退出码 2、输出 `need_docnexus: true`：告诉用户默认模板不能改，要先接入 DocNexus（重跑 npx @rowansenne/workflow-run 并加 `--with-docnexus`），不要另找地方保存。`<模板>` 写别名 `tech` / `release` / `plan` / `delivery` / `review` / `checklist`，或 `<skill>/<文件名>`；没说哪份时先 `template.mjs list` 列出来问。
+用户要改某份模板（「技术方案模板加一节回滚」「上线方案去掉灰度那节」「审查报告的严重问题表加一列」），或要新建、按样例重做模板时，用 `template.mjs` 一路走完，不要直接编辑生效中的模板文件。`<模板>` 写别名 `tech` / `release` / `plan` / `delivery` / `review` / `checklist`，或 `<skill>/<文件名>`；没说哪份时先 `template.mjs list` 列出来问。
 
 1. **起草稿**：`node <skills>/workflow/scripts/template.mjs draft <模板>`，把当前生效的模板复制到 `workflow-run/tmp/template-draft/<skill>/<文件名>`（输出的 `draft`）。草稿已存在会沿用（上次没改完）；要从当前模板重来加 `--force`。
    - 退出码 2、`need_sample: true`：还没有这份模板，按下面「创建模板」第 1 步向用户要样例，再运行 `draft <模板> --from <样例文件>`（从 stdin 读用 `--from -`）。用户要「按这份文档重做模板」时同样用 `--from`。
@@ -42,7 +39,7 @@ node <skills>/workflow/scripts/resolve.mjs template <skill> <文件名>
 需要已接入 DocNexus。技术方案、上线方案第一次生成时没有模板，由用户给一份**团队现有的同类文档**作样例来创建。用户也可以随时主动要求「创建 / 重新生成技术方案（上线方案）模板」，流程相同。
 
 1. **要样例**：停下来告诉用户还没有这份模板，请用户给一份团队现有的同类文档：本地 Markdown 路径，或 wiki 页面的 pageId / URL。
-   - wiki 页面：运行 `node <skills>/md-to-wiki/scripts/upload.mjs get <pageId> --text`，取输出的 `text` 作样例（需要 wiki 已配置，见 `<skills>/workflow/SKILL.md`「增强能力探测」；没配置就请用户导出成 Markdown 或直接贴出内容）。
+   - wiki 页面：运行 `node <skills>/md-to-wiki/scripts/upload.mjs get <pageId> --text`，取输出的 `text` 作样例（需要 wiki 已配置，沿用开工 wiki 通道；无通道时请用户导出成 Markdown 或直接贴出内容）。
    - 用户手头没有样例：请用户列出要哪些章节、每节写什么，按同样的格式整理成模板。不要自己编一份「通用模板」。
 2. **抽骨架**：把样例存到临时文件（如 `workflow-run/tmp/template-sample.md`），运行 `node <skills>/workflow/scripts/template.mjs draft <模板> --from <样例文件>`（内部用 `make-template.mjs` 抽骨架，结果写进草稿，之后按「修改模板」第 2–4 步完善、校验、保存）。它保留标题层级和表格列，正文换成 `{{...}}` 填写提示，丢掉标题前的元信息块（元信息由生成文档的 skill 自己写）。
 3. **完善**：在骨架上改：

package/workflow/scripts/artifacts.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// 按分支汇总各 skill 的产物：开发方案、交付说明、审查报告、技术方案、上线方案，以及它们的 wiki 发布记录。
+// 按分支汇总各 skill 的产物：方案、交付说明、审查报告、技术方案、上线方案，以及它们的 wiki 发布记录。
 // 产物按需求归档在 workflow-run/docs/requirements/<需求>/<项目>/（两种模式结构相同，见 requirement.mjs）。
 // 直接扫描 Markdown，从元信息行读分支（「分支：」「对比分支：」），
 // 从第一行的 <!-- md-to-wiki: ... --> 读发布记录（md-to-wiki 上传后写入）。只读。
@@ -13,81 +13,19 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
-import { REQ_DIR, parseFile, artifactFiles } from './requirement.mjs';
-
-// 产物种类；顺序即链路顺序
-export const KINDS = [
-  { kind: 'plan', label: '开发方案' },
-  { kind: 'delivery', label: '交付说明' },
-  { kind: 'review', label: '审查报告' },
-  { kind: 'tech', label: '技术方案' },
-  { kind: 'release', label: '上线方案' },
-];
-
-const HEAD_LINES = 20;
-const toPosix = (p) => p.split(path.sep).join('/');
-
-// 元信息行里的分支：「对比分支：`dev` ←→ `main`」取 dev；「分支：feature/x」「分支：`feature/x`」
-export function parseBranch(text) {
-  const head = text.split(/\r?\n/).slice(0, HEAD_LINES).join('\n');
-  const m = head.match(/(?:对比)?分支[：:]\s*`?([^`\s｜|←，,）)]+)`?/);
-  return m && !/^[{<]/.test(m[1]) ? m[1] : null; // 未填写的模板占位符不算
-}
-
-export function parseWiki(text) {
-  const m = /^<!-- md-to-wiki: ([^\n]*?) -->/.exec(text);
-  if (!m) return null;
-  const kv = Object.fromEntries([...m[1].matchAll(/(\w+)=(\S+)/g)].map((x) => [x[1], x[2]]));
-  return kv.pageId ? { pageId: kv.pageId, version: kv.version ? Number(kv.version) : null, url: kv.url ?? null, at: kv.at ?? null } : null;
-}
-
-
-const headerDate = (text) => /(\d{4}-\d{2}-\d{2})/.exec(text.replace(/<!--[\s\S]*?-->/g, '').split(/\r?\n/).slice(0, 8).join('\n'))?.[1] ?? ''; // 跳过 md-to-wiki 发布记录里的 at=
-
-// workflow-run/docs/requirements/<需求>/<项目>/<文件> → 产物条目；不是已知产物返回 null。
-// 分支里还没迁移的旧结构（<需求>/<文件>，没有项目这一层）也认，project 为 null
-function entry(rel, text, mtime) {
-  const parts = rel.split('/');
-  if ((parts.length !== 5 && parts.length !== 6) || parts.slice(0, 3).join('/') !== REQ_DIR) return null;
-  const p = parseFile(parts.at(-1));
-  const k = p && KINDS.find((x) => x.kind === p.kind);
-  // 排序键：文档头里的日期 + 版本号（需求目录里的文件名不带日期）
-  return k ? { kind: k.kind, label: k.label, path: rel, requirement: parts[3], project: parts.length === 6 ? parts[4] : null, branch: parseBranch(text), date: `${headerDate(text)}#${String(p.version).padStart(3, '0')}`, mtime, wiki: parseWiki(text) } : null;
-}
-
-const byDate = (a, b) => a.date.localeCompare(b.date) || a.mtime - b.mtime;
-
-// allProjects：文档仓库模式下连同其他项目的产物一起读（跨服务视图）
-export function collect(root, { allProjects = false } = {}) {
-  const out = [];
-  for (const f of artifactFiles(root, { allProjects })) {
-    const k = KINDS.find((x) => x.kind === f.kind);
-    const text = fs.readFileSync(f.abs, 'utf8');
-    // 排序键：文档头里的日期 + 版本号（需求目录里的文件名不带日期）
-    out.push({ kind: k.kind, label: k.label, path: f.rel, cite: f.cite, requirement: f.slug, project: f.project, version: f.version, branch: parseBranch(text), date: `${headerDate(text)}#${String(f.version).padStart(3, '0')}`, mtime: fs.statSync(f.abs).mtimeMs, wiki: parseWiki(text) });
-  }
-  // 同一天、无日期的文件按修改时间排
-  return out.sort(byDate);
+import { runState } from '../lib/runs.mjs';
+import { KINDS } from '../lib/artifact-model.mjs';
+import { loadWorkspace, projectArtifacts, artifactEntry, readGitArtifacts } from '../lib/workspace-read.mjs';
+export { KINDS, parseBranch, parseWiki } from '../lib/artifact-model.mjs';
+export { localBranches } from '../lib/workspace-read.mjs';
+
+export function collect(root, { allProjects = false, workspace = null } = {}) {
+  const data = workspace ?? loadWorkspace(root, { allProjects });
+  return projectArtifacts(data, allProjects).filter((a) => a.source === 'worktree').map(artifactEntry);
 }
 
-// 只读扫描一个 git 引用（分支）里提交过的产物；条目带 ref 与 text（正文），mtime 取 0
 export function collectGit(root, ref) {
-  const ls = spawnSync('git', ['ls-tree', '-r', '--name-only', ref, '--', REQ_DIR], { cwd: root, encoding: 'utf8' });
-  if (ls.status !== 0) return [];
-  const out = [];
-  for (const rel of ls.stdout.split('\n').filter(Boolean)) {
-    const show = spawnSync('git', ['show', `${ref}:${rel}`], { cwd: root, encoding: 'utf8', maxBuffer: 16 * 1024 * 1024 });
-    if (show.status !== 0) continue;
-    const e = entry(rel, show.stdout, 0);
-    if (e) out.push({ ...e, ref, text: show.stdout });
-  }
-  return out.sort(byDate);
-}
-
-// 本地分支名列表
-export function localBranches(root) {
-  const r = spawnSync('git', ['for-each-ref', '--format=%(refname:short)', 'refs/heads'], { cwd: root, encoding: 'utf8' });
-  return r.status === 0 ? r.stdout.split('\n').filter(Boolean) : [];
+  return readGitArtifacts(root, ref).map(artifactEntry);
 }
 
 // 下一步建议：按链路顺序找第一个缺的环节，再看哪些文档还没发布到 wiki
@@ -106,16 +44,18 @@ export function nextSteps(latest) {
   return steps;
 }
 
-export function branchView(root, branch) {
-  const items = collect(root).filter((a) => a.branch === branch);
+export function branchView(root, branch, workspace = loadWorkspace(root)) {
+  const items = collect(root, { workspace }).filter((a) => a.branch === branch);
   const latest = {};
   for (const a of items) latest[a.kind] = a; // 已按时间升序，最后一个即最新
   const strip = ({ mtime, ...a }) => a;
+  const execution = runState(root, branch, workspace);
   return {
     branch,
     artifacts: items.map(strip),
     latest: Object.fromEntries(KINDS.map((k) => [k.kind, latest[k.kind] ? strip(latest[k.kind]) : null])),
-    next: nextSteps(latest),
+    execution,
+    next: execution.current && execution.current.status !== 'completed' ? [execution.next] : nextSteps(latest),
   };
 }
 
@@ -135,15 +75,16 @@ function main(argv) {
     else if (argv[i] === '--all') all = true;
     else { console.error('用法: artifacts.mjs [--root <项目根>] [--branch <分支> | --all]'); return 1; }
   }
+  const workspace = loadWorkspace(root);
   if (all) {
-    const branches = [...new Set(collect(root).map((a) => a.branch).filter(Boolean))].sort();
-    const unknown = collect(root).filter((a) => !a.branch).map((a) => a.path);
-    console.log(JSON.stringify({ branches: branches.map((b) => branchView(root, b)), without_branch: unknown }, null, 2));
+    const branches = [...new Set([...workspace.artifacts.map((a) => a.branch), ...workspace.runs.map((r) => r.branch)].filter(Boolean))].sort();
+    const unknown = collect(root, { workspace }).filter((a) => !a.branch).map((a) => a.path);
+    console.log(JSON.stringify({ branches: branches.map((b) => branchView(root, b, workspace)), without_branch: unknown }, null, 2));
     return 0;
   }
   branch ??= currentBranch(root);
   if (!branch) { console.error('无法确定当前分支（不在 git 仓库或处于 detached HEAD），请用 --branch 指定'); return 1; }
-  console.log(JSON.stringify(branchView(root, branch), null, 2));
+  console.log(JSON.stringify(branchView(root, branch, workspace), null, 2));
   return 0;
 }
 

package/workflow/scripts/doc-sections.mjs

@@ -1,55 +1,2 @@
-// 读 skill 产物（交付说明、审查报告等）的小工具：按二级标题切节、取表格行、取元信息行。
-// report.mjs 与 pr-desc.mjs 共用；标题识别与归一化复用 lint-doc.mjs（跳过代码块、去编号 / 必填 / 「如有」标记），
-// 模板标题的写法只在一处定义。只做文本解析，不读写文件。
-
-import { headings, headingKey } from './lint-doc.mjs';
-
-const stripComments = (s) => s.replace(/<!--[\s\S]*?-->/g, '');
-
-// 二级标题（归一化后的 key）→ 正文（去掉 HTML 注释与首尾空行）
-export function sections(text) {
-  const lines = text.split(/\r?\n/);
-  const hs = headings(text);
-  const out = new Map();
-  hs.forEach((h, i) => {
-    if (h.level !== 2) return;
-    const next = hs.slice(i + 1).find((x) => x.level <= 2);
-    const body = lines.slice(h.line, next ? next.line - 1 : lines.length).join('\n');
-    if (!out.has(h.key)) out.set(h.key, stripComments(body).trim());
-  });
-  return out;
-}
-
-// 按标题前缀取一节（「严重问题」匹配「严重问题（CRITICAL / HIGH）」），前缀同样归一化
-export function section(secs, prefix) {
-  const key = headingKey(prefix);
-  for (const [k, v] of secs) if (k.startsWith(key)) return v;
-  return null;
-}
-
-// 「无」「无。」或只剩占位符的节当作空
-export const isEmpty = (body) => !body || /^(无|无。|none|n\/a)$/i.test(body.trim()) || /^\{\{[^}]*\}\}$/.test(body.trim());
-
-// 表格数据行（跳过表头、分隔行、全空行和带 {{占位符}} 的模板行），返回单元格数组
-export function tableRows(body) {
-  if (!body) return [];
-  const lines = body.split('\n').filter((l) => /^\s*\|/.test(l));
-  return lines.slice(1)
-    .filter((l) => !/^\s*\|[\s:|-]+\|\s*$/.test(l))
-    .map((l) => l.trim().replace(/^\||\|$/g, '').split('|').map((c) => c.trim()))
-    .filter((cells) => cells.some((c) => c) && !cells.some((c) => /\{\{/.test(c)));
-}
-
-// 列表项（- / * / 1.），跳过「无」与占位符
-export function listItems(body) {
-  if (!body) return [];
-  return body.split('\n').map((l) => /^\s*(?:[-*]|\d+[.)])\s+(.*)$/.exec(l)?.[1]?.trim()).filter((x) => x && !isEmpty(x) && !/\{\{/.test(x));
-}
-
-// 开头引用块里的元信息：「> DocNexus：xxx」取 xxx（遇到「｜」截断）
-export function meta(text, key) {
-  const head = text.split(/\r?\n/).slice(0, 20).join('\n');
-  const m = new RegExp(`${key}[：:]\\s*([^｜\\n]*)`).exec(head);
-  const v = m?.[1]?.trim();
-  return v && !/^\{\{/.test(v) ? v : null;
-}
+// 保留原导出入口；纯文本解析统一在 document-model。
+export { sections, section, isEmpty, tableRows, listItems, meta } from '../lib/document-model.mjs';

package/workflow/scripts/docnexus-layout.mjs

@@ -1,24 +1,2 @@
-// DocNexus format 7：项目根运行，内部状态在 .docnexus/，知识输出固定到 workflow-run/docnexus/。
-import fs from 'node:fs';
-import path from 'node:path';
-
-export const DOCNEXUS_INTERNAL = '.docnexus';
-export const DOCNEXUS_OUTPUT = 'workflow-run';
-export const docnexusRoot = (root) => path.resolve(root);
-export const docnexusWorkspace = (root) => path.resolve(root, DOCNEXUS_OUTPUT, 'docnexus');
-export const docnexusInternal = (root) => path.resolve(root, DOCNEXUS_INTERNAL);
-
-export function docnexusConfigured(root) {
-  try {
-    const marker = JSON.parse(fs.readFileSync(path.join(docnexusInternal(root), 'project.json'), 'utf8'));
-    return marker.format_version === 7 && marker.output_dir === DOCNEXUS_OUTPUT;
-  } catch { return false; }
-}
-
-export function docnexusBinPath(root) {
-  const name = process.platform === 'win32' ? 'docnexus.cmd' : 'docnexus';
-  const bin = path.join(docnexusInternal(root), 'node_modules', '.bin', name);
-  return fs.existsSync(bin) ? bin : null;
-}
-
-export const docnexusConnected = (root) => docnexusConfigured(root) && docnexusBinPath(root) !== null;
+// 兼容原有导出入口；接入规则统一在共享核心。
+export { DOCNEXUS_INTERNAL, DOCNEXUS_OUTPUT, docnexusRoot, docnexusWorkspace, docnexusInternal, docnexusConfigured, docnexusBinPath, docnexusConnected } from '../lib/capabilities.mjs';

package/workflow/scripts/knowledge.mjs

@@ -15,6 +15,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
+import { DOCNEXUS_HINT } from '../lib/capabilities.mjs';
 import { skillMeta, resolveCategory, docnexusConnected, docnexusBin, docnexusRoot } from './resolve.mjs';
 
 const IS_WIN = process.platform === 'win32';
@@ -37,7 +38,7 @@ function query(root, category) {
 export function knowledge(root, skill, { match = [], limit = 20, query: question = '', recallLimit = 5 } = {}) {
   const meta = skillMeta(skill);
   if (!meta) return { ok: false, error: 'unknown', message: `未安装 skill「${skill}」` };
-  if (!docnexusConnected(root)) return { ok: false, error: 'no_docnexus', message: '未接入 DocNexus，跳过知识库参考' };
+  if (!docnexusConnected(root)) return { ok: false, error: 'no_docnexus', message: DOCNEXUS_HINT };
   const terms = match.map((t) => t.toLowerCase()).filter(Boolean);
   const hit = (d) => !terms.length || terms.some((t) => [d.title, d.summary, d.file_path, ...(d.tags ?? [])].some((v) => String(v ?? '').toLowerCase().includes(t)));
   const seen = new Set();
@@ -59,7 +60,8 @@ export function knowledge(root, skill, { match = [], limit = 20, query: question
     }
     categories.push(entry);
   }
-  const out = { ok: true, skill, categories };
+  const failed = categories.some((c) => !c.ok || c.recall?.ok === false);
+  const out = { ok: !failed, ...(failed ? { error: 'query_failed', message: 'DocNexus 查询失败，修复后重试，不能当作没有相关知识' } : {}), skill, categories };
   if (question) out.recall_by_category = true;
   return out;
 }

package/workflow/scripts/lint-doc.mjs

@@ -17,44 +17,11 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { resolveTemplate, skillMeta } from './resolve.mjs';
+import { proseLines, headings } from '../lib/document-model.mjs';
+export { headings, headingKey } from '../lib/document-model.mjs';
 
 const TODO = /待填写|待补充|待人工确认/;
 
-// 去掉代码块后返回 [{ line, text }]，行号从 1 开始
-function proseLines(md) {
-  const out = [];
-  let fence = null;
-  md.replace(/\r/g, '').split('\n').forEach((text, i) => {
-    const m = text.match(/^\s*(```+|~~~+)/);
-    if (m) { if (!fence) fence = m[1][0]; else if (m[1][0] === fence) fence = null; return; }
-    if (!fence) out.push({ line: i + 1, text });
-  });
-  return out;
-}
-
-// 章节标题归一化：去掉编号（1. / 4.1 / 一、/ 第一部分）、必填标记 *、可选标记（如有），用于模板与文档比对
-export function headingKey(text) {
-  return text
-    .replace(/\*+\s*$/, '')
-    .replace(/[（(]\s*如有[^)）]*[)）]/g, '')
-    .replace(/^\s*(?:第?[一二三四五六七八九十]+[、.．]|[0-9]+(?:\.(?:[0-9]+|x))*[.、．]?)\s*/, '')
-    .replace(/\s+/g, '')
-    .trim();
-}
-
-export function headings(md) {
-  return proseLines(md)
-    .map(({ line, text }) => ({ line, m: text.match(/^(#{1,6})\s+(.+?)\s*#*\s*$/) }))
-    .filter((h) => h.m)
-    .map(({ line, m }) => ({
-      line, level: m[1].length, text: m[2],
-      key: headingKey(m[2]),
-      required: /\*\s*$/.test(m[2]),
-      optional: /[（(]\s*如有/.test(m[2]),
-      placeholder: /\{\{|<[^>]*填写[^>]*>/.test(m[2]),
-    }));
-}
-
 export function lint(doc, template, { requiredMeta = [] } = {}) {
   const errors = [];
   const warnings = [];

package/workflow/scripts/meta-store.mjs

@@ -0,0 +1,2 @@
+// 保留原脚本导出入口。
+export { readMeta, updateMeta } from '../lib/meta-store.mjs';

package/workflow/scripts/pr-desc.mjs

@@ -13,16 +13,18 @@ import path from 'node:path';
 import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 import { branchView } from './artifacts.mjs';
-import { readProfile } from './resolve.mjs';
-import { sections, section, tableRows, isEmpty } from './doc-sections.mjs';
+import { readProfile } from '../lib/project.mjs';
+import { sections, section, tableRows, isEmpty } from '../lib/document-model.mjs';
+import { loadWorkspace } from '../lib/workspace-read.mjs';
 
 const git = (root, args) => { const r = spawnSync('git', args, { cwd: root, encoding: 'utf8' }); return r.status === 0 ? r.stdout.trim() : null; };
 const keep = (body) => (body && !isEmpty(body) ? body : null);
 const LEVEL_RE = /CRITICAL|HIGH/i;
 
-export function buildDescription(root, branch, base) {
-  const view = branchView(root, branch);
-  const read = (a) => (a ? fs.readFileSync(path.join(root, a.path), 'utf8') : null);
+export function buildDescription(root, branch, base, workspace = loadWorkspace(root)) {
+  const view = branchView(root, branch, workspace);
+  const texts = new Map(workspace.artifacts.map((a) => [a.path, a.text]));
+  const read = (a) => a ? texts.get(a.path) : null;
   const { delivery, review, plan, tech, release } = view.latest;
   const L = [];
   const add = (title, body) => { if (body) L.push(`## ${title}`, '', body, ''); };
@@ -55,7 +57,7 @@ export function buildDescription(root, branch, base) {
     add('影响面', keep(section(s, '影响面')));
   }
 
-  const docs = [['开发方案', plan], ['交付说明', delivery], ['审查报告', review], ['技术方案', tech], ['上线方案', release]]
+  const docs = [['方案', plan], ['交付说明', delivery], ['审查报告', review], ['技术方案', tech], ['上线方案', release]]
     
     .filter(([, a]) => a).map(([label, a]) => `- ${label}：\`${a.cite ?? a.path}\`${a.wiki?.url ? `（wiki：${a.wiki.url}）` : a.wiki ? `（wiki pageId ${a.wiki.pageId}）` : ''}`);
   add('相关文档', docs.length ? docs.join('\n') : null);

package/workflow/scripts/report.mjs

@@ -3,10 +3,10 @@
 // 数据全部来自已经落盘的产物，不上报、不另存记录：
 //   - 审查：每份报告的 CRITICAL / HIGH / MEDIUM / LOW 条数、复核通过率；复审报告里上次问题的「已修复 / 仍存在 / 不再适用」→ 修复率
 //   - 交付：功能 / 缺陷、S / M / L、需求澄清中确认的决定条数、带「未验证项」的交付
-//   - 沉淀：交付说明与审查报告的「DocNexus」元信息行 → 已沉淀 / 未沉淀 / 未接入
+//   - 沉淀：交付说明与审查报告的「DocNexus」元信息行 → 已沉淀 / 未沉淀 / 未询问 / 无需沉淀 / 未接入
 //   - 知识复用：正文里引用 docnexus/library/ 的产物（开工前召回到并用上了）
 //   - 链路完整度：每个分支有哪些产物、文档有没有发布到 wiki
-// S 规模走快速通道的交付不落盘，不在统计内。
+// S 快速通道不落盘（不绑定需求，也不写审查报告 / 交付说明），不在统计内。
 // 默认只看工作区；产物随特性分支提交、还没合并时，加 --all-branches 用 git 只读扫描所有本地分支（同一路径以工作区为准）。
 //
 // 用法（在项目根执行；--root 可指定项目根）：
@@ -16,97 +16,47 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { collect, collectGit, localBranches, KINDS } from './artifacts.mjs';
-import { sections, section, tableRows, listItems, meta, isEmpty } from './doc-sections.mjs';
+import { KINDS } from '../lib/artifact-model.mjs';
+import { loadWorkspace, projectArtifacts, artifactEntry } from '../lib/workspace-read.mjs';
+export { captureState, citesKnowledge, parseReview, parseDelivery } from '../lib/artifact-model.mjs';
 
 const LEVELS = ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'];
 const pct = (a, b) => (b ? Math.round((a / b) * 100) : null);
 
-// DocNexus 元信息行 → captured / not_captured / not_connected / missing
-export function captureState(text) {
-  const v = meta(text, 'DocNexus');
-  if (!v) return 'missing';
-  if (/docnexus\/library\//.test(v)) return 'captured';
-  if (/未接入/.test(v)) return 'not_connected';
-  if (/未沉淀/.test(v)) return 'not_captured';
-  return 'missing';
-}
-
-// 正文（元信息行之外）有没有引用知识库文档
-export const citesKnowledge = (text) => text.split(/\r?\n/).some((l) => !/^>\s*DocNexus[：:]/.test(l) && /docnexus\/library\//.test(l));
-
-export function parseReview(text) {
-  const secs = sections(text);
-  const levels = Object.fromEntries(LEVELS.map((l) => [l, 0]));
-  let verified = 0; let pending = 0;
-  for (const cells of tableRows(section(secs, '严重问题'))) {
-    const lv = LEVELS.find((l) => cells[1]?.toUpperCase().includes(l));
-    if (lv) levels[lv]++;
-    const last = cells[cells.length - 1] ?? '';
-    if (last.includes('✅')) verified++; else if (last.includes('⚠')) pending++;
-  }
-  levels.MEDIUM += tableRows(section(secs, '一般问题')).length;
-  levels.LOW += tableRows(section(secs, '优化建议')).length;
-  const followUp = { fixed: 0, open: 0, obsolete: 0 };
-  for (const cells of tableRows(section(secs, '与上次审查对比'))) {
-    const s = cells[2] ?? '';
-    if (s.includes('已修复')) followUp.fixed++; else if (s.includes('仍存在')) followUp.open++; else if (s.includes('不再适用')) followUp.obsolete++;
-  }
-  return { levels, verified, pending, follow_up: followUp, is_rereview: followUp.fixed + followUp.open + followUp.obsolete > 0 };
-}
-
-export function parseDelivery(text) {
-  const secs = sections(text);
-  const type = meta(text, '类型');
-  const scale = meta(text, '规模');
-  const unverified = section(secs, '验证')?.match(/未验证项[：:]\s*(.*)/)?.[1]?.trim();
-  return {
-    type: type && /缺陷/.test(type) ? 'bug' : type ? 'feature' : null,
-    scale: scale && /^[SML]$/.test(scale) ? scale : null,
-    decisions: listItems(section(secs, '已确认的决定')).length,
-    has_unverified: !!unverified && !isEmpty(unverified) && !/^\{\{/.test(unverified),
-  };
-}
-
 // 工作区 + （可选）各本地分支提交过的产物；同一路径只取第一次见到的（工作区优先）
-export function gather(root, allBranches) {
-  const seen = new Set(); const out = [];
-  const add = (list) => { for (const a of list) if (!seen.has(a.path)) { seen.add(a.path); out.push(a); } };
-  add(collect(root));
-  const branches = allBranches ? localBranches(root) : [];
-  for (const b of branches) add(collectGit(root, b));
-  return { items: out, scanned: branches };
+export function gather(root, allBranches, workspace = loadWorkspace(root, { allBranches })) {
+  return { items: projectArtifacts(workspace).map(artifactEntry), scanned: workspace.scanned_branches };
 }
 
-export function buildReport(root, { since = null, allBranches = false } = {}) {
-  const g = gather(root, allBranches);
+export function buildReport(root, { since = null, allBranches = false, workspace = loadWorkspace(root, { allBranches }) } = {}) {
+  const g = gather(root, allBranches, workspace);
   const all = g.items.filter((a) => !since || !a.date || a.date.slice(0, 10) >= since);
-  const read = (a) => a.text ?? fs.readFileSync(path.join(root, a.path), 'utf8');
+  const models = new Map(workspace.artifacts.map((a) => [a.path, a]));
   const counts = Object.fromEntries(KINDS.map((k) => [k.kind, all.filter((a) => a.kind === k.kind).length]));
 
   const review = { reports: 0, rereviews: 0, levels: Object.fromEntries(LEVELS.map((l) => [l, 0])), verified: 0, pending: 0, follow_up: { fixed: 0, open: 0, obsolete: 0 } };
   const delivery = { total: 0, feature: 0, bug: 0, scale: { S: 0, M: 0, L: 0 }, with_decisions: 0, decisions: 0, with_unverified: 0 };
-  const capture = { captured: 0, not_captured: 0, not_connected: 0, missing: 0 };
+  const capture = { captured: 0, not_captured: 0, not_asked: 0, not_needed: 0, not_connected: 0, missing: 0 };
   let cites = 0;
   for (const a of all) {
-    const text = read(a);
-    if (citesKnowledge(text)) cites++;
+    const model = models.get(a.path);
+    if (model.citesKnowledge) cites++;
     if (a.kind === 'review') {
-      const r = parseReview(text);
+      const r = model.review;
       review.reports++; if (r.is_rereview) review.rereviews++;
       for (const l of LEVELS) review.levels[l] += r.levels[l];
       review.verified += r.verified; review.pending += r.pending;
       for (const k of Object.keys(review.follow_up)) review.follow_up[k] += r.follow_up[k];
     }
     if (a.kind === 'delivery') {
-      const d = parseDelivery(text);
+      const d = model.delivery;
       delivery.total++;
       if (d.type) delivery[d.type]++;
       if (d.scale) delivery.scale[d.scale]++;
       if (d.decisions) { delivery.with_decisions++; delivery.decisions += d.decisions; }
       if (d.has_unverified) delivery.with_unverified++;
     }
-    if (a.kind === 'delivery' || a.kind === 'review') capture[captureState(text)]++;
+    if (a.kind === 'delivery' || a.kind === 'review') capture[model.capture]++;
   }
   const f = review.follow_up;
   review.fix_rate = pct(f.fixed, f.fixed + f.open);
@@ -127,6 +77,7 @@ export function buildReport(root, { since = null, allBranches = false } = {}) {
     knowledge: { citing: cites, rate: pct(cites, all.length) },
     branches,
     without_branch: all.filter((a) => !a.branch).map((a) => a.path),
+    ...(workspace.diagnostics.length ? { diagnostics: workspace.diagnostics } : {}),
   };
 }
 
@@ -135,6 +86,7 @@ const show = (v) => (v == null ? '—' : `${v}%`);
 export function toMarkdown(r) {
   const L = [];
   L.push(`# 工作流效果报告${r.since ? `（${r.since} 起）` : ''}`, '');
+  for (const d of r.diagnostics ?? []) L.push(`> 数据检查：${d.path}：${d.message}`, '');
   L.push(r.scanned_branches.length
     ? `范围：工作区 + ${r.scanned_branches.length} 个本地分支（其中 ${r.from_branches} 份只在分支里）。`
     : '范围：只看工作区。随特性分支提交、还没合并的产物不在内，加 `--all-branches` 一起统计。', '');
@@ -142,7 +94,7 @@ export function toMarkdown(r) {
     L.push('`workflow-run/docs/requirements/` 下还没有产物。dev 交付（M / L 规模）、审查报告、技术方案、上线方案落盘后，这里才有数据。');
     return L.join('\n');
   }
-  L.push(`产物 ${r.artifacts} 份：${KINDS.map((k) => `${k.label} ${r.counts[k.kind]}`).join('、')}。S 规模走快速通道的交付不落盘，不在统计内。`, '');
+  L.push(`产物 ${r.artifacts} 份：${KINDS.map((k) => `${k.label} ${r.counts[k.kind]}`).join('、')}。S 快速通道不落盘，不在统计内。`, '');
   const v = r.review;
   L.push('## 审查', '');
   L.push(`- 报告 ${v.reports} 份（其中复审 ${v.rereviews} 份）；发现 CRITICAL ${v.levels.CRITICAL} / HIGH ${v.levels.HIGH} / MEDIUM ${v.levels.MEDIUM} / LOW ${v.levels.LOW}`);
@@ -155,7 +107,7 @@ export function toMarkdown(r) {
   L.push(`- 带「未验证项」的交付：${d.with_unverified} 份`, '');
   const c = r.capture;
   L.push('## 知识沉淀与复用', '');
-  L.push(`- 交付与审查问过沉淀的 ${c.captured + c.not_captured} 次中，沉淀 ${c.captured} 次（${show(c.capture_rate)}）；未接入 DocNexus ${c.not_connected}，元信息缺失 ${c.missing}`);
+  L.push(`- 交付与审查问过沉淀的 ${c.captured + c.not_captured} 次中，沉淀 ${c.captured} 次（${show(c.capture_rate)}）；未询问 ${c.not_asked}，没有值得沉淀的内容 ${c.not_needed}，未接入 DocNexus ${c.not_connected}，元信息缺失 ${c.missing}`);
   L.push(`- 正文引用知识库文档的产物：${r.knowledge.citing} 份（${show(r.knowledge.rate)}）`, '');
   L.push('## 各分支链路', '');
   L.push(`| 分支（需求） | ${KINDS.map((k) => k.label).join(' | ')} | 未发布到 wiki |`);