@rowansenne/workflow-run 0.31.1 → 0.32.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
@@ -4,6 +4,12 @@
4
4
 
5
5
  ## [Unreleased]
6
6
 
7
+ ## [0.32.0] - 2026-11-02
8
+
9
+ ### 优化
10
+ - 技术方案将自动化元信息放入文件头隐藏注释,不再强制正文引用块;保留分支收尾校验、产物归组与日期统计,兼容旧文档,事实自检显式指定三点 diff。正文遵循团队模板,保留说明和组件,不重复添加 Wiki 页面标题。
11
+ - Markdown 转 Wiki 的代码宏支持 `title="标题"`,可与语言组合;保留标题转义和 CDATA 处理。明确可选 CodeGraph 缺失但已完成替代分析时不算跳过步骤,并说明反馈记录版本与 npx 汇总版本的区别。
12
+
7
13
  ## [0.31.1] - 2026-11-02
8
14
 
9
15
  ### 修复
@@ -38,9 +38,11 @@ description: "Generate a Markdown technical design doc (技术方案) from the d
38
38
 
39
39
  按 `references/diff-collection.md` 执行:用三点 `<main>...<dev>`,先 `--name-only` 分层列文件,再读具体 diff;只写 diff 中可见的事实,看不到写「待补充」。有 `prd_context` 时做 PRD 对齐校验(同见 `references/prd.md`)。
40
40
 
41
+ CodeGraph 是可选增强;未安装时用 diff 精读和代码搜索完成影响面分析,属于正常降级,不记为跳过 Step 2。确有未完成的分析才记录跳过项与原因。
42
+
41
43
  ### Step 3 — 选模板并填充
42
44
 
43
- - 模板:在项目根运行 `node <skills>/workflow/scripts/resolve.mjs template create-tech-md-doc template.md`(`<skills>` 是本 skill 所在的 skills 目录,如 `.agents/skills`),读输出的 `path`,并把 `source` 写进元数据行。模板缺失统一按 `workflow/references/templates.md` 创建或导入。
45
+ - 模板:在项目根运行 `node <skills>/workflow/scripts/resolve.mjs template create-tech-md-doc template.md`(`<skills>` 是本 skill 所在的 skills 目录,如 `.agents/skills`),读输出的 `path`,并把 `source` 写进下面的隐藏元信息。模板缺失统一按 `workflow/references/templates.md` 创建或导入。
44
46
  - 用户要修改、重新生成或换一份技术方案模板时,按 `<skills>/workflow/references/templates.md`「修改模板」用 `template.mjs` 处理(模板别名 `tech`;按样例重做用 `draft tech --from <样例>`),保存写入 DocNexus 知识库。
45
47
  - 填充:模板的章节和编号因团队而异,**按章节含义**放事实,不按编号。下表是事实的来源,放进模板里含义对应的章节;模板里没有对应章节的事实不擅自加章节,在交付摘要里列出「模板中没有位置的事实」;模板有、但 diff 和 PRD 都给不出内容的章节写「待补充」。
46
48
 
@@ -55,23 +57,25 @@ description: "Generate a Markdown technical design doc (技术方案) from the d
55
57
  | 数据链路 / 数据评审 | 有 PRD 且提及表名,或 `profile.data_review` 为 true 时;`prd_context.tables` / diff 推断 |
56
58
  | 兼容问题与方案、PRD 对齐缺口 | diff 推断 + PRD 对齐缺口(见 `references/prd.md`) |
57
59
 
58
- - 文档开头写元信息:
60
+ - 正文遵循团队生效模板,不写「自动生成 / 对比分支 / diff 概览 / PRD 参考 / 模板来源」引用块;模板中与 Wiki 页面标题重复的独立文档标题不输出到正文,保留有业务含义的章节标题。
61
+ - 保留模板里的说明文字、表格和带标题代码块(围栏信息串用 `title="标题"`,可与语言组合);具体章节编号、说明内容和标题由模板决定,不在通用 skill 中写死。
62
+ - 文件开头(有 wiki 发布记录时紧随其后)写隐藏元信息,整个注释块保持在前 20 行内。它供分支校验、事实核对和产物索引使用,Markdown / Wiki 正文不展示;这些字段保留在注释中,`meta.json` 按现有逻辑保存绑定、索引和运行:
59
63
 
60
64
  ```markdown
61
- > **自动生成** by `create-tech-md-doc` skill | 生成时间:<时间>
62
- > 对比分支:`<dev>` ←→ `<main>`(主分支为基线)
63
- > diff 概览:<files> files changed, <ins> insertions(+), <del> deletions(-)
64
- > PRD 参考:<pageId 或 URL 或「无」/「PRD 增强已跳过」>
65
- > 模板来源:<DocNexus / 项目文件>
66
- > 待补充章节:<diff 和 PRD 都给不出内容的章节,没有写「无」>
67
- > ⚠️ 内容基于代码 diff 推断,业务语义需人工校对后补充。
65
+ <!-- workflow-run:
66
+ 生成时间:<时间>
67
+ 对比分支:`<dev>` ←→ `<main>`(主分支为基线)
68
+ diff 概览:<files> files changed, <ins> insertions(+), <del> deletions(-)
69
+ PRD 参考:<pageId 或 URL 或「无」/「PRD 增强已跳过」>
70
+ 模板来源:<resolve 返回的 source>
71
+ -->
68
72
  ```
69
73
 
70
74
  ### Step 4 — 写文件
71
75
 
72
76
  - 正式收尾: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`。
73
77
  - 收尾输出 previous 非空时告诉用户上一版的归档位置,不能替用户删除;中断先 `artifact.mjs resume --id <运行id>`。独立文档仓库的提交提示用 `requirement.mjs pending`,按 requirements.md 处理;后续 wiki/沉淀元信息仍可显式 sync。
74
- - 收尾前对草稿运行 `node <skills>/workflow/scripts/lint-doc.mjs <草稿> --skill create-tech-md-doc --facts` 自检(`--facts` 按元信息行的对比分支核对正文里的类名、文件、接口、表名):有「错误」先修正再交付(缺必填章节、残留 `{{...}}` 占位符、缺元信息行);「警告」按实际情况处理,其中「在 diff 和代码里都找不到」的名字逐个核实:确属编造就改成 diff 里的真实名字或写「待补充」,是外部系统 / 配置中心的名字就保留;「提示」里的待填写位置在交付摘要中告诉用户。
78
+ - 收尾前对草稿运行 `node <skills>/workflow/scripts/lint-doc.mjs <草稿> --skill create-tech-md-doc --facts --diff <main>...<dev>` 自检,显式按三点范围核对正文里的类名、文件、接口、表名。有「错误」先修正再交付(缺必填章节、残留 `{{...}}` 占位符);不再强制可见元信息行,但隐藏分支仍须与运行一致。「警告」按实际情况处理,其中「在 diff 和代码里都找不到」的名字逐个核实:确属编造就改成 diff 里的真实名字或写「待补充」,是外部系统 / 配置中心的名字就保留;「提示」里的待填写位置在交付摘要中告诉用户。
75
79
  - 再把路径和摘要告诉用户。
76
80
 
77
81
  ### Step 5 — 后续(都需要用户同意)
@@ -1,6 +1,6 @@
1
1
  # PRD 增强(--prd)
2
2
 
3
- 拉取步骤、wiki 可用性判断与通用 `prd_context` 字段见 `references/prd-fetch.md`。任一步失败都回退纯 diff 流程,元信息写「PRD 增强已跳过」。
3
+ 拉取步骤、wiki 可用性判断与通用 `prd_context` 字段见 `references/prd-fetch.md`。任一步失败都回退纯 diff 流程,文件头隐藏元信息的「PRD 参考」写「PRD 增强已跳过」。
4
4
 
5
5
  技术方案不需要额外字段,通用 `prd_context` 用于模板里的需求背景与数据链路类章节。
6
6
 
@@ -15,12 +15,7 @@
15
15
  "title": "技术方案模板",
16
16
  "summary": "create-tech-md-doc 生成技术方案时使用的模板。不随 skills 提供:第一次生成时按用户给的样例文档创建(见 workflow/references/templates.md「创建模板」)。",
17
17
  "lint": {
18
- "requiredMeta": [
19
- "自动生成",
20
- "对比分支",
21
- "diff 概览",
22
- "模板来源"
23
- ]
18
+ "requiredMeta": []
24
19
  }
25
20
  }
26
21
  ],
@@ -193,7 +193,7 @@ footer { margin-top: 40px; font-size: 13px; color: var(--muted); }
193
193
 
194
194
  <header class="hero">
195
195
  <div>
196
- <div class="eyebrow">@rowansenne/workflow-run · 0.31.0 · 2026-10-31</div>
196
+ <div class="eyebrow">@rowansenne/workflow-run · 0.32.0 · 2026-11-02</div>
197
197
  <h1>让 AI 编程代理按团队的规矩干活</h1>
198
198
  <p class="lede">一套装进项目里的 Agent Skills:从需求澄清、开发、测试、自审到技术方案和上线方案,每一步怎么做、做到什么程度、哪些事必须先问人,都写成团队共享的规则和脚本,随代码一起提交。</p>
199
199
  <div class="facts">
@@ -406,6 +406,7 @@ footer { margin-top: 40px; font-size: 13px; color: var(--muted); }
406
406
  <div>
407
407
  <h3>项目事实只写一处</h3>
408
408
  <p>主分支、构建和测试命令、配置中心、发布平台、开发环境配置(<code>toolchain</code>:JDK / Maven / Node 的位置)都在 <code>workflow/profile.json</code>。模板里不写死任何公司或项目的约定,换个项目只改画像;个人机器不同的部分写进不提交的 <code>profile.local.json</code> 覆盖。</p>
409
+ <p>技术方案遵循 DocNexus 团队模板,保留说明和带标题代码块,不重复添加 Wiki 页面标题。分支、生成时间等机器元信息放在文件头隐藏注释中,供正式落盘与查询读取,Wiki 正文不展示;旧可见元信息仍兼容。事实自检显式指定 <code>--facts --diff &lt;main&gt;...&lt;dev&gt;</code>。</p>
409
410
  </div>
410
411
  <div>
411
412
  <h3>能用脚本就不靠模型</h3>
@@ -573,7 +574,7 @@ footer { margin-top: 40px; font-size: 13px; color: var(--muted); }
573
574
  <div class="tree"><pre>node .agents/skills/nacos-config/scripts/config.mjs inspect
574
575
  node .agents/skills/nacos-config/scripts/config.mjs get --file src/main/resources/bootstrap.yml --file src/main/resources/application-test.yml --data-id order-test.yaml --key order.timeout</pre></div>
575
576
  <p class="sub" style="margin-top:12px">支持 JSON / YAML / properties;首次解析 YAML 若缺依赖,在该 skill 目录运行 npm 安装。默认使用 Nacos 1.x / 2.x 的兼容 API,也可显式选择 2.x API 或 3.x Client API。<code>/workflow status</code> 与 <code>doctor</code> 均不测试 Nacos 远端连通性;doctor 会检查本机连接文件的忽略规则。</p>
576
- <div class="callout">本页对应 0.31.0,包含 HTTP 接口验证规则、F2 业务核对与 F3 技术澄清流程;dev 工作流仅在用户显式要求时启动。</div>
577
+ <div class="callout">本页对应 0.32.0,包含技术方案隐藏元信息、带标题代码宏、HTTP 接口验证规则、F2 业务核对与 F3 技术澄清流程;dev 工作流仅在用户显式要求时启动。</div>
577
578
  </section>
578
579
 
579
580
  <section>
@@ -4,7 +4,7 @@
4
4
 
5
5
  ## 当前架构
6
6
 
7
- 本文对应 0.31.0(2026-10-31),包括 F2 业务场景清单、F3 技术澄清、HTTP 接口验证、需求与方案证据失效规则,以及锁定依赖和发布包验证。
7
+ 本文对应 0.32.0(2026-11-02),包括技术方案隐藏元信息、带标题代码宏、F2 业务场景清单、F3 技术澄清、HTTP 接口验证、需求与方案证据失效规则,以及锁定依赖和发布包验证。
8
8
 
9
9
  安装分发与任务运行分开。运行时由宿主代理读取 skill 规则、调用脚本;workflow-run 本身不启动常驻 Agent 服务。
10
10
 
@@ -143,7 +143,7 @@ workflow-run(安装器仓库)/
143
143
  "requires": ["workflow"],
144
144
  "optional": ["md-to-wiki", "create-release-md-doc"],
145
145
  "shared": ["diff-collection-common.md", "prd-fetch.md"],
146
- "templates": [{ "id": "template.md", "src": "template.md", "title": "技术方案模板", "summary": "...", "lint": { "requiredMeta": ["模板来源"] } }],
146
+ "templates": [{ "id": "template.md", "title": "技术方案模板", "summary": "...", "lint": { "requiredMeta": [] } }],
147
147
  "docnexus": { "category": "tech-design", "reason": "create-tech-md-doc skill 从技术方案中沉淀的决策、约定与风险", "readFrom": ["create-tech-md-doc", "dev"] }
148
148
  }
149
149
  ```
package/docs/workflows.md CHANGED
@@ -56,7 +56,7 @@
56
56
  2. 运行 `feedback` 汇总(或直接拿 `workflow-run/feedback/` 下的文件),按「常被跳过的步骤」「读不懂的规则」「提问太多」精简 SKILL.md,发新版本;
57
57
  3. 各项目 `upgrade` 时清掉本项目旧版本的记录(git 历史里仍可找回),从新版本重新收集,回到第 1 步。
58
58
 
59
- 字段与记录规则见 `workflow/references/feedback.md`。
59
+ 记录中的版本是生成记录时项目内已安装的 skill 版本;用新版 npx 执行汇总不会升级项目 skills 或改写旧记录。可选 CodeGraph 不可用但已用 diff / 代码搜索完成分析时,不记为跳过;实际漏做的分析和规则冲突仍如实记录。字段与记录规则见 `workflow/references/feedback.md`。
60
60
 
61
61
  **PR / MR 描述**:`node <skills>/workflow/scripts/pr-desc.mjs [--branch b] [--base main] [--out 文件]` 把本分支的交付说明(做了什么、已确认的决定、改动、验证、配置 / SQL)、审查报告(结论、CRITICAL / HIGH、影响面)和相关文档路径汇总成描述;没有交付说明时退回用提交记录和改动文件列表。dev 交付后要提 PR 时会调用它;创建 PR 要你同意。
62
62
 
@@ -123,6 +123,8 @@ Codex 原生元数据 `dev/agents/openai.yaml` 设置 `policy.allow_implicit_inv
123
123
  * 守则:不写库、不改凭据、不擅自 commit / push、不装新依赖;测试没跑就写「未验证」。
124
124
  * DocNexus 是必装组件,缺失或查询失败时先修复;wiki、CodeGraph、数据库为可选增强,所有 Skill 共用开工能力快照与失败处理规则(`workflow/references/capabilities.md`)。
125
125
 
126
+ 技术方案正文按 DocNexus 生效模板生成,保留说明文字和带标题代码块,不重复添加 Wiki 页面标题。生成时间、对比分支、diff 概览、PRD 参考和模板来源放在文件头的 `<!-- workflow-run: … -->` 隐藏注释中,兼容正式落盘、分支查询和日期统计,Wiki 转换时不展示;旧文档的可见元信息仍可读取。事实自检显式传 `--facts --diff <main>...<dev>`,不再强制正文出现自动化元信息引用块。团队章节编号和组件内容只在模板中维护。
127
+
126
128
  ## 脚本化的规则
127
129
 
128
130
  能写成确定规则的判断都放在脚本里,SKILL.md 只说明什么时候调用,不再让 agent 按文字描述自己判断:
@@ -139,11 +141,11 @@ Codex 原生元数据 `dev/agents/openai.yaml` 设置 `policy.allow_implicit_inv
139
141
  | `workflow/lib/capabilities.mjs` | 集中探测必装 DocNexus 与可选增强;供 resolve status 输出本轮能力快照 |
140
142
  | `workflow/scripts/resolve.mjs status` | `/workflow status` 的能力探测(不输出任何凭据) |
141
143
  | `workflow/scripts/resolve.mjs infer-profile` | 按固定规则从构建文件、Makefile、依赖与配置文件、git 推断项目画像草稿,每个字段附依据;不写文件 |
142
- | `workflow/scripts/lint-doc.mjs <文档> --skill <skill> [--facts]` | 对照当前生效的模板检查生成的文档:必填章节、残留 `{{...}}` 占位符、元信息行为错误;缺普通章节、顺序不一致为警告;列出待填写位置。`--facts` 再核对正文里的类名、文件、接口、表名:在对比分支的 diff 和代码里都找不到的记为警告(防编造) |
144
+ | `workflow/scripts/lint-doc.mjs <文档> --skill <skill> [--facts --diff <main>...<dev>]` | 对照当前生效的模板检查必填章节、残留占位符和该 skill 要求的元信息;缺普通章节、顺序不一致为警告;列出待填写位置。技术方案不强制可见元信息,事实核对显式指定三点范围;正文里的类名、文件、接口、表名在 diff 和代码里都找不到时给出警告 |
143
145
  | `workflow/scripts/requirement.mjs which / bind / path / sync / pending / list / config` | 产物按需求归档(`workflow-run/docs/requirements/<需求>/<项目>/`,两种模式结构相同):查当前分支绑定的需求(没绑定时给出按分支名生成的建议名)、绑定需求名、给出本次落盘路径(不覆盖,带上一版的 wiki 记录)、重建 `meta.json`、列出所有需求;`config` 设置产物位置(文档仓库、项目名、提交提示),`pending` 看文档仓库里还没提交的产物 |
144
146
  | `workflow/scripts/view.mjs [--out f] [--open]` | 项目文档视图(`/workflow view`、`npx @rowansenne/workflow-run view`):读需求目录里的产物,生成单个 HTML,按需求列出各阶段、审查记录(各级别数量、复核、与上次对比)、交付记录、沉淀到的知识文档,正文直接渲染;顶部「知识文档」列出每篇知识文档来自哪个需求、哪份产物;数据内嵌,只读、不联网,默认写到 `workflow-run/tmp/view/index.html` |
145
147
  | `workflow/scripts/run.mjs show / start / save / complete / cancel` | 需求 meta.json 中的分支运行记录:恢复、checkpoint、已完成状态与时间、等待用户、修复回退、revision 冲突检查 |
146
- | `workflow/scripts/artifacts.mjs [--branch b \| --all]` | 按分支汇总 `workflow-run/docs/requirements/` 下的方案、交付说明、审查报告、技术方案、上线方案及其 wiki 发布记录,给出下一步建议;分支取自文档元信息行,不另存记录。上线方案没传 `--tech` 时据此自动引用同分支的技术方案;project-review 据此对照本分支方案、识别复审 |
148
+ | `workflow/scripts/artifacts.mjs [--branch b \| --all]` | 按分支汇总 `workflow-run/docs/requirements/` 下的方案、交付说明、审查报告、技术方案、上线方案及其 wiki 发布记录,给出下一步建议;分支取自文件头元信息(兼容技术方案的隐藏注释与旧可见行)。上线方案没传 `--tech` 时据此自动引用同分支的技术方案;project-review 据此对照本分支方案、识别复审 |
147
149
  | `workflow/scripts/report.mjs [--since d] [--all-branches] [--json]` | 本地效果报告(`/workflow report`、`npx @rowansenne/workflow-run report`):审查发现与修复率、复核率、需求澄清、沉淀率、知识引用、各分支链路 |
148
150
  | `workflow/scripts/feedback.mjs add … / summary [--json]` | 运行反馈:dev / project-review 交付后追加一行过程记录到 `workflow-run/feedback/<用户>.jsonl`;`summary` 按 skill 汇总,跳过的步骤和不清楚的规则按 SKILL.md 章节归类(`npx @rowansenne/workflow-run feedback`);`init` / `upgrade` 装了新版本时清掉本项目旧版本的记录 |
149
151
  | `workflow/scripts/review-scope.mjs [--diff b...h \| --base b] [--exclude a,b]` / `rules <文件…>` | 审查范围:由脚本决定审哪些文件、跳过哪些(删除、二进制、敏感文件、依赖目录、生成文件、文档、本工具产物,各带原因)、每个文件的风险级别和分批,以及按文件类型和改动内容该看审查清单的哪几节;`--base` 含未提交和未跟踪的新文件。`rules` 打印这些小节的原文和画像 `review.rules` 里匹配的项目规则。project-review 第 1、3、4 步与 dev 自审使用 |
@@ -10,7 +10,7 @@ node md-to-wiki.mjs --check <html> # 只做良构校验
10
10
  只用 Node 内置能力,不依赖第三方库,也不调用 wiki API:
11
11
 
12
12
  1. 自带 Markdown 解析:ATX 标题、段落(单换行转 `<br/>`)、引用、有序 / 无序列表(可嵌套、任务列表)、GFM 表格(含对齐)、分隔线、行内代码 / 粗体 / 斜体 / 删除线 / 链接 / 图片 / 自动链接;
13
- 2. 围栏代码块转 `<ac:structured-macro ac:name="code">` 宏,代码放进 `<![CDATA[...]]>`;
13
+ 2. 围栏代码块转 `<ac:structured-macro ac:name="code">` 宏,代码放进 `<![CDATA[...]]>`;信息串支持语言、`title="标题"`,或两者组合(如 `java title="示例"`),分别写入代码宏的 `language` / `title` 参数;
14
14
  3. 原始 HTML 一律转义成文本,HTML 注释直接丢弃,保证输出良构;
15
15
  4. 可选 banner:`--banner` 文件,或把正文第一个引用块移进 `<ac:structured-macro ac:name="info">`;
16
16
  5. 写出文件后自动做良构校验,不良构时退出码为 1 并给出行号。
@@ -41,7 +41,7 @@ function inline(text) {
41
41
 
42
42
  // ---------------------------------------------------------------- 块级
43
43
  const RE = {
44
- fence: /^ {0,3}(`{3,}|~{3,})\s*([\w+#.-]*).*$/,
44
+ fence: /^ {0,3}(`{3,}|~{3,})\s*(.*)$/,
45
45
  heading: /^ {0,3}(#{1,6})\s+(.*?)\s*#*\s*$/,
46
46
  hr: /^ {0,3}([-*_])(\s*\1){2,}\s*$/,
47
47
  quote: /^ {0,3}>\s?/,
@@ -57,9 +57,17 @@ const splitRow = (l) => {
57
57
  return t.split(/(?<!\\)\|/).map((c) => c.trim().replace(/\\\|/g, '|'));
58
58
  };
59
59
 
60
- function codeMacro(lang, code) {
60
+ // 支持 java、title="标题" 和 java title="标题";其他围栏属性不作为语言。
61
+ function parseFenceInfo(info) {
62
+ const lang = info.trim().match(/^([\w+#.-]+)(?=\s|$)/)?.[1] ?? '';
63
+ const title = info.match(/(?:^|\s)title="([^"]*)"/)?.[1] ?? '';
64
+ return { lang, title };
65
+ }
66
+
67
+ function codeMacro(lang, title, code) {
61
68
  const body = code.replace(/]]>/g, ']]]]><![CDATA[>');
62
- const p = lang ? `<ac:parameter ac:name="language">${esc(lang)}</ac:parameter>` : '';
69
+ const p = (lang ? `<ac:parameter ac:name="language">${esc(lang)}</ac:parameter>` : '')
70
+ + (title ? `<ac:parameter ac:name="title">${esc(title)}</ac:parameter>` : '');
63
71
  return `<ac:structured-macro ac:name="code" ac:schema-version="1">${p}<ac:plain-text-body><![CDATA[${body}]]></ac:plain-text-body></ac:structured-macro>`;
64
72
  }
65
73
 
@@ -74,11 +82,11 @@ function blocks(lines) {
74
82
 
75
83
  let m;
76
84
  if ((m = line.match(RE.fence))) { // 围栏代码块
77
- const fence = m[1]; const lang = m[2]; const body = [];
85
+ const fence = m[1]; const { lang, title } = parseFenceInfo(m[2]); const body = [];
78
86
  i++;
79
87
  while (i < lines.length && !new RegExp(`^ {0,3}${fence[0]}{${fence.length},}\\s*$`).test(lines[i])) body.push(lines[i++]);
80
88
  i++;
81
- out.push(codeMacro(lang, body.join('\n') + (body.length ? '\n' : '')));
89
+ out.push(codeMacro(lang, title, body.join('\n') + (body.length ? '\n' : '')));
82
90
  continue;
83
91
  }
84
92
  if ((m = line.match(RE.heading))) { out.push(`<h${m[1].length}>${inline(m[2])}</h${m[1].length}>`); i++; continue; }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rowansenne/workflow-run",
3
- "version": "0.31.1",
3
+ "version": "0.32.0",
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",
@@ -15,6 +15,7 @@ export function parseFile(name) {
15
15
  }
16
16
 
17
17
  const head = (text, n = 20) => text.split(/\r?\n/).slice(0, n).join('\n');
18
+ // 兼容旧的可见元信息行,以及文件头 workflow-run 注释里的同格式分支。
18
19
  export function parseBranch(text) {
19
20
  const m = head(text).match(/(?:对比)?分支[::]\s*`?([^`\s||←,,))]+)`?/);
20
21
  return m && !/^[{<]/.test(m[1]) ? m[1] : null;
@@ -29,8 +30,12 @@ export function parseDocnexus(text) {
29
30
  const v = /DocNexus[::]\s*([^|\n]*)/.exec(head(text))?.[1]?.trim();
30
31
  return v && /docnexus\/library\//.test(v) ? v.split(/[、,,]\s*/).map((s) => s.trim()).filter(Boolean) : null;
31
32
  }
32
- // 文档头里的日期(跳过第一行的 md-to-wiki 发布记录等 HTML 注释,那里的 at= 是发布时间)
33
- export const headerDate = (text) => /(\d{4}-\d{2}-\d{2})/.exec(head(text.replace(/<!--[\s\S]*?-->/g, ''), 8))?.[1] ?? null;
33
+ // 优先取隐藏生成时间;旧正文日期仍可读,md-to-wiki 的 at= 不作为文档日期。
34
+ export function headerDate(text) {
35
+ const hidden = /<!-- workflow-run:\s*\n([\s\S]*?)-->/.exec(head(text))?.[1];
36
+ return /生成时间[::]\s*(\d{4}-\d{2}-\d{2})/.exec(hidden ?? '')?.[1]
37
+ ?? /(\d{4}-\d{2}-\d{2})/.exec(head(text.replace(/<!--[\s\S]*?-->/g, ''), 8))?.[1] ?? null;
38
+ }
34
39
 
35
40
  const LEVELS = ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'];
36
41
 
@@ -104,6 +104,8 @@ finalize 先用知识库当前模板 lint 精确的草稿内容,再校验运
104
104
 
105
105
  正式文档先写 tmp 草稿;不要先调用 `requirement.mjs path` 归档再直接覆盖,否则绕过收尾的中断保护。tech / release 分别在 T4 / L4 用 kind tech / release 收尾,使用各自的知识模板;wiki/沉淀后只更新发布或知识元信息仍可显式 sync。
106
106
 
107
+ 技术方案将生成时间、对比分支、diff 概览、PRD 参考和模板来源放在文件头的 `<!-- workflow-run: … -->` 多行注释中(格式见 create-tech-md-doc,整个块在前 20 行内),不要求正文显示元信息引用块。分支校验仍读取注释中的 `对比分支:`,索引日期读取其中的 `生成时间:`;旧文档的可见元信息继续兼容。注释随正式文件一起归档并参与 hash 校验,Wiki 转换时移除;`meta.json` 仍按现有逻辑记录绑定、索引和运行,不自动接收全部注释字段。
108
+
107
109
  两个文件无法一次原子提交,待办保存在同一个 meta.json 的 pending_finalization,草稿副本在 tmp/finalize/。中断期间其他元信息写入会被拒绝,show 的 next 提示恢复:
108
110
 
109
111
  ```sh
@@ -7,6 +7,7 @@
7
7
  - **不问用户、不打断**:交付时静默记录,不为了记录多问一句,也不请用户打分。
8
8
  - **只写过程,不写内容**:不写代码、类名、方法名、表名、接口路径、业务名词、客户信息。这个文件会被发给维护 skill 的人。
9
9
  - **如实**:跳过了就写跳过,问了几轮就写几轮;不美化。拿不准的数字不写那个参数。
10
+ - **正常降级不算跳过**:可选 CodeGraph 未安装,但已用 diff / 代码搜索完成分析时,不写 `--skipped`;实际未完成的分析才记录。规则冲突仍用 `--unclear` 说明冲突双方,不能把校验通过当成已满足模板。
10
11
  - **失败不影响交付**:命令报错就在对话里提一句,不重试、不排查。
11
12
  - **一次运行记一行**:dev 内部调用 project-review 自审时只由 dev 记,project-review 不另记。
12
13