@coda-console/review 4.2.0 → 4.2.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.
Files changed (2) hide show
  1. package/README.md +7 -4
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -2,7 +2,7 @@
2
2
 
3
3
  `review`:会话开的 PR 从开出来起由流程 `pull-request` 跟着走,一个 PR 一条运行,到合并或关闭才结束。
4
4
  它只用 Coda 流程的公开原语(PR 事件、Agent 步骤、人工任务、调用其他流程),也是写 PR 流程的样例:要不一样的流程,照着它改一份(见文末「改成自己的」)。
5
- 它依赖内置的 GitHub 插件(`extensionDependencies`):PR 事件由 GitHub 插件的「PR 观察」发布;装 review 时先装 GitHub 插件,卸载 GitHub 插件时 review 一起卸载。
5
+ 它依赖 Coda 自带的 GitHub 插件(`extensionDependencies`):PR 事件由 GitHub 插件的「PR 观察」发布;装 review 时先装 GitHub 插件,卸载 GitHub 插件时 review 一起卸载。
6
6
  运行的标题是「PR #号 标题」(手动发起的是参数 `pr`,评审查出 PR 后是「PR #号(地址)」),卡片上有「检查」「评审」「合并」三段;草稿、叠放的 PR 另有「草稿」「叠放」,勾了合并后流程的,合并后再有「合并后的流程」。
7
7
  流程通过 `coda:key` 声明 PR 地址为主键:在同一项目中,自动、手动发起共享一条未结束的运行,包括排队、等答复和取消收尾。地址不区分大小写。结束后新请求可再发起;旧请求重试仍返回原运行。
8
8
  也可以 `workflow_run pull-request` 手动发起(必填 `pr`:GitHub 返回的完整 PR 地址,可选 `focus`)。已有运行时返回它,沿用原进度、关注点和结果接收会话;草稿中的运行也照旧等标记为可评审。没有运行时只评审一次、不计次数、不进入合并;如果随后 PR 观察发来事件,在同一条运行里接上完整流程。是否接入完整流程按 `github.event.coda.heard` 判断:手动运行尚未收到事件时为空。
@@ -59,6 +59,9 @@ prompts/principles/ 评审重点,一项一段,按设置取
59
59
  - **合并前检查**:加入挂点 `premerge` 的流程(第 5 步),你批准后在要合并的提交上只跑一次;每个版本都跑嫌贵的验证(如整套回归)放这里。
60
60
  - **合并后的流程**:加入挂点 `merged` 的流程(第 6 步,下文「挂点 merged」),如部署、发布预览版、发布正式版。
61
61
 
62
+ PR 事件由 GitHub 插件的「PR 观察」发布;PR 合并或关闭后半小时内分支又被推送时,它立即告诉开 PR 的会话这次推送不会进目标分支。
63
+ 从运行启动到结束、结果交回,开 PR 的会话显示「等待中」,停止会话不影响流程运行及其结果交回。
64
+
62
65
  ## 流程
63
66
 
64
67
  1. **草稿**:PR 是草稿就等作者标记为可评审(`pull_request.ready_for_review`);有新提交时按它带来的草稿状态重新判断,关闭则结束。
@@ -255,8 +258,8 @@ PR 生命流程与简易开发声明挂点 `merged`:合并后要做的事由
255
258
 
256
259
  - **只改评审的措辞**:改 `prompts/review.md`;评审的规则在 `prompts/rules.md`,改了评审方和开 PR 的会话同时生效。
257
260
  `{{…}}` 由评审脚本换成整段文字,文件开头的注释列出各个占位(注释不发出去);只有回复末尾的 `review` 代码块是脚本读结论的约定,不能改。
258
- - **改流程**:把这个目录复制到你自己的仓库,在 Coda 的「设置 › 插件」里卸载内置的 `review`,再「从仓库添加…」装你的那份(同名替换),
259
- 之后按你的仓库更新、回退。改了插件 ID 也要先卸载内置的,否则每个 PR 会跑两条流程。
260
- - 改这里的 `review` 本身,照本仓库的规矩提 PR、升 `version`;Coda 再同步到合并后的提交(见仓库根的 README)。
261
+ - **改流程**:把这个目录复制到你自己的仓库,在 Coda 的「设置 › 插件」里「从仓库添加…」装你的那份(同名替换已装的 `review`,它是外部插件),
262
+ 之后按你的仓库更新、回退。改了插件 ID 要先卸载已装的 `review`,否则每个 PR 会跑两条流程。
263
+ - 改这里的 `review` 本身,照本仓库的规矩提 PR、升 `version`;合并并发布到 npm 后,各台 Coda 本机更新(默认自动更新,见仓库根的 README)。
261
264
 
262
265
  设备验收填写设备名时,先调用 testbed 的 `resolve-testbed` 再占用返回的组:iOS、安卓都是 `device:<设备名>` 组。此时须安装 testbed,review 不新增硬依赖。
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "displayName": "PR 生命流程",
5
5
  "description": "PR 从检查、评审到批准合并;简易开发",
6
6
  "icon": { "symbol": "checkmark.bubble.fill", "color": "purple" },
7
- "version": "4.2.0",
7
+ "version": "4.2.1",
8
8
  "categories": [
9
9
  "工作流程"
10
10
  ],