@coda-console/review 3.1.0 → 3.3.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.
@@ -1,10 +1,10 @@
1
1
  <?xml version="1.0" encoding="UTF-8"?>
2
2
  <!-- PR 生命流程(docs/plugins.md「内置插件:PR 生命流程」):会话开的 PR 从开出来起一条运行,走到合并或关闭才结束。
3
3
  草稿:等作者标记为可评审。
4
- 检查:在这个提交上调用项目声明为检查的流程(coda:kind="check"),再等它在 GitHub 上的检查都有结果;有没通过的交给开 PR 的会话。
4
+ 检查:在这个提交上调用项目加入挂点 check 的流程(检查),再等它在 GitHub 上的检查都有结果;有没通过的交给开 PR 的会话。
5
5
  评审:另一家 Agent 评审这个版本;要求修改交给开 PR 的会话,它不同意交给你仲裁。有新提交就从头再来。
6
6
  叠放:base 不是默认分支的不合并,等 base 改过去再接着走。
7
- 合并:请你批准,再在这个提交上调用项目声明为合并前检查的流程(coda:kind="premerge"),都通过才合并;没通过或 GitHub 没合并就交给开 PR 的会话,
7
+ 合并:请你批准,再在这个提交上调用项目加入挂点 premerge 的流程(合并前检查),都通过才合并;没通过或 GitHub 没合并就交给开 PR 的会话,
8
8
  它推了新提交、评审通过后按你的批准合并,不再问。
9
9
  删除分支:你勾选后,等 GitHub 确认合并,再删除仍指向该提交的远程源分支;本地分支与工作树保留。
10
10
  合并后的流程:合并后在合并提交上运行你在批准卡上勾的流程(项目里加入挂点 merged 的)。
@@ -69,7 +69,7 @@
69
69
  <boundaryEvent id="closed-while-drafted" name="PR 关闭" attachedToRef="drafting"><messageEventDefinition messageRef="closed" /></boundaryEvent>
70
70
  <sequenceFlow id="drafted-closed" sourceRef="closed-while-drafted" targetRef="ended" />
71
71
 
72
- <!-- 检查:机器检查便宜,先过了它们再请 Agent 评审。项目在自己的仓库里声明哪些流程是检查(coda:kind="check"):这里在这个提交上调用它们,
72
+ <!-- 检查:机器检查便宜,先过了它们再请 Agent 评审。项目在自己的仓库里让检查流程加入挂点 check:这里在这个提交上调用它们,
73
73
  一个没通过(运行失败)就交给开 PR 的会话;都通过了,再等这个提交在 GitHub 上的全部检查(项目检查写的状态、GitHub Actions 等)有结果,
74
74
  它们的一句话结论交给评审方、写在批准卡上。会话推了新提交就答复「已推送新版本」,等新提交从头再来;重跑外部检查或处理好别的后答复,再跑一遍。 -->
75
75
  <subProcess id="checking" name="检查">
@@ -77,7 +77,7 @@
77
77
  <sequenceFlow id="c-in" sourceRef="checking-in" targetRef="run-checks" />
78
78
  <serviceTask id="run-checks" name="跑项目的检查" coda:action="run-workflows" coda:status="跑项目的检查">
79
79
  <extensionElements>
80
- <coda:param name="kind" value="check" />
80
+ <coda:param name="hook" value="check" />
81
81
  <coda:param name="commit" value="=github.event.pull_request.head.sha" />
82
82
  </extensionElements>
83
83
  </serviceTask>
@@ -377,16 +377,17 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
377
377
  <coda:output name="inputs" />
378
378
  <coda:output name="missing" />
379
379
  <coda:output name="asks" />
380
+ <coda:output name="needs" />
380
381
  </extensionElements>
381
382
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs"</script>
382
383
  </scriptTask>
383
384
  <sequenceFlow id="to-premerge" sourceRef="approval" targetRef="premerge" />
384
385
 
385
- <!-- 合并前检查:每个版本都跑嫌贵的验证(如后端全套),项目声明为 coda:kind="premerge",批准后在要合并的提交上只跑一次。
386
+ <!-- 合并前检查:每个版本都跑嫌贵的验证(如后端全套),项目让它加入挂点 premerge,批准后在要合并的提交上只跑一次。
386
387
  没通过交给开 PR 的会话:推了新提交答复「已推送新版本」,等新提交从头再来,评审通过后按原批准合并;检查本身出了问题,处理好后答复,再跑一遍。 -->
387
388
  <serviceTask id="premerge" name="合并前检查" coda:action="run-workflows" coda:status="合并前检查">
388
389
  <extensionElements>
389
- <coda:param name="kind" value="premerge" />
390
+ <coda:param name="hook" value="premerge" />
390
391
  <coda:param name="commit" value="=reviewing.head" />
391
392
  </extensionElements>
392
393
  </serviceTask>
@@ -614,8 +615,9 @@ GitHub 上各项检查用 `gh pr checks {{github.event.pull_request.html_url}}`
614
615
  <documentation>用户批准合并时勾的流程要一段文字,批准卡上没有写:
615
616
  {{split(approval.asks, "\n")[loopCounter]}}
616
617
  PR #{{github.event.number}}({{github.event.pull_request.html_url}})已合并。
617
- 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。</documentation>
618
- <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /></extensionElements>
618
+ 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。
619
+ 选「这一项这次不跑」(备注可不写):这段文字不写,要它的流程这次都不跑,其余勾了的照常运行;都不跑了就直接结束。不想发出这段文字、写不出时选它,不要答复 rejected。</documentation>
620
+ <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /><coda:choice id="skip" name="这一项这次不跑" /></extensionElements>
619
621
  <multiInstanceLoopCharacteristics isSequential="true" coda:inputCollection='=split(approval.missing, ",")' coda:inputElement="input" />
620
622
  </userTask>
621
623
  <sequenceFlow id="filled" sourceRef="fill" targetRef="merged-inputs" />
@@ -624,22 +626,26 @@ PR #{{github.event.number}}({{github.event.pull_request.html_url}})已合并
624
626
  <coda:env name="INPUTS" value="=approval.inputs" />
625
627
  <coda:env name="MISSING" value="=approval.missing" />
626
628
  <coda:env name="ASKS" value="=approval.asks" />
627
- <coda:env name="FILLS" value="=fill" />
628
- <coda:output name="inputs" />
629
+ <coda:env name="FILLS" value="=fill" /><coda:env name="NEEDS" value="=approval.needs" /><coda:env name="ONLY" value="=approval.only" />
630
+ <coda:output name="inputs" /><coda:output name="only" />
629
631
  </extensionElements>
630
632
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs" inputs</script>
631
633
  </scriptTask>
632
- <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="run-merged" />
634
+ <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="left" />
635
+ <exclusiveGateway id="left" name="还有要跑的合并后流程吗" default="left-run" />
636
+ <sequenceFlow id="left-none" sourceRef="left" targetRef="delivered-none"><conditionExpression xsi:type="tFormalExpression">=merged-inputs.only = "[]"</conditionExpression></sequenceFlow>
637
+ <sequenceFlow id="left-run" sourceRef="left" targetRef="run-merged" />
633
638
  <serviceTask id="run-merged" name="合并后的流程" coda:action="run-workflows" coda:status="运行合并后的流程">
634
639
  <extensionElements>
635
640
  <coda:param name="hook" value="merged" />
636
- <coda:param name="only" value="=approval.only" />
641
+ <coda:param name="only" value="=merged-inputs.only" />
637
642
  <coda:param name="commit" value="=github.event.pull_request.merge_commit_sha" />
638
643
  <coda:param name="inputs" value="=merged-inputs.inputs" />
639
644
  </extensionElements>
640
645
  </serviceTask>
641
646
  <sequenceFlow id="ran-merged" sourceRef="run-merged" targetRef="delivered" />
642
647
  <endEvent id="delivered" coda:status="已合并,合并后的流程已结束" />
648
+ <endEvent id="delivered-none" coda:status="已合并,没有要跑的合并后流程" />
643
649
  </subProcess>
644
650
  <sequenceFlow id="to-delivered" sourceRef="delivering" targetRef="delivering-done" />
645
651
  <endEvent id="delivering-done" coda:notify="=approval.notify" />
@@ -3,14 +3,15 @@
3
3
  准备分支:改动交在哪条分支上由发起的 Agent 定,给了(或会话所在的)就用它;都没有时从目标分支的最新提交替它开一条。
4
4
  交上改动:第一张任务交给主 Agent,不叫醒它,随会话的下一条输入告诉它;它把改动提交到那条分支,答复改动汇报。
5
5
  推送:流程把那个分支的最新提交推到自己的分支 simple/<运行>,开 PR 到目标分支;之后每次修改都推同一个分支、更新同一个 PR。
6
- 检查:在这个提交上调用项目声明为检查的流程(coda:kind="check"),没通过交回主 Agent。
6
+ 检查:在这个提交上调用项目加入挂点 check 的流程(检查),没通过交回主 Agent。
7
7
  评审:评审方(发起时选的,没选按设置「评审组合」)在只读会话里评审一次;要求修改交回主 Agent,它改,或写明不改的理由。之后只重跑检查,不评第二轮。
8
8
  设备验收(可选):主 Agent 装预览版,你在设备上验收,「不行」交回主 Agent。
9
9
  合并前检查、GitHub 检查都通过后请你批准;合并后运行你勾选的合并后流程(挂点 merged)。BPMN 2.0,由 Coda 执行(docs/workflows.md)。 -->
10
10
  <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:coda="https://coda.pub/schema/bpmn/1.0"
11
11
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="simple-definitions" targetNamespace="https://coda.pub/plugins/review">
12
- <process id="simple" name="简易开发" isExecutable="true" coda:kind="develop" coda:title="简易开发">
12
+ <process id="simple" name="简易开发" isExecutable="true" coda:title="简易开发">
13
13
  <extensionElements>
14
+ <coda:join hook="develop" />
14
15
  <coda:input name="branch" label="分支" type="branch" defaultFrom="session.branch" description="主 Agent 提交改动的分支,默认是会话所在的分支;都没有时流程从目标分支替它开 agent/simple-&lt;运行 ID&gt;" />
15
16
  <coda:input name="reviewer" label="评审方" type="agent" description="不选按插件设置「评审组合」:Claude 写的由 Codex 评,反之亦然" />
16
17
  <coda:input name="devices" label="设备验收" type="boolean" default="false" description="改了客户端、要在 Mac 或 iPhone 上验收时打开" />
@@ -60,7 +61,7 @@
60
61
  <sequenceFlow id="push-checks" sourceRef="pushed" targetRef="checks" />
61
62
 
62
63
  <serviceTask id="checks" name="项目检查" coda:action="run-workflows" coda:status="跑项目的检查">
63
- <extensionElements><coda:param name="kind" value="check" /><coda:param name="commit" value="=push.head" /></extensionElements>
64
+ <extensionElements><coda:param name="hook" value="check" /><coda:param name="commit" value="=push.head" /></extensionElements>
64
65
  </serviceTask>
65
66
  <boundaryEvent id="checks-failed" name="没通过" attachedToRef="checks"><errorEventDefinition /></boundaryEvent>
66
67
  <sequenceFlow id="checks-problem" sourceRef="checks-failed" targetRef="checks-feedback" />
@@ -201,7 +202,7 @@
201
202
  <sequenceFlow id="acceptance-premerge" sourceRef="after-acceptance" targetRef="premerge" />
202
203
 
203
204
  <serviceTask id="premerge" name="合并前检查" coda:action="run-workflows" coda:status="合并前检查">
204
- <extensionElements><coda:param name="kind" value="premerge" /><coda:param name="commit" value="=pr.head" /></extensionElements>
205
+ <extensionElements><coda:param name="hook" value="premerge" /><coda:param name="commit" value="=pr.head" /></extensionElements>
205
206
  </serviceTask>
206
207
  <boundaryEvent id="premerge-failed" name="没通过" attachedToRef="premerge"><errorEventDefinition /></boundaryEvent>
207
208
  <sequenceFlow id="premerge-problem" sourceRef="premerge-failed" targetRef="premerge-feedback" />
@@ -271,7 +272,7 @@
271
272
  <extensionElements>
272
273
  <coda:env name="APPROVED" value="=approve" /><coda:env name="JOINERS" value="=joiners.list" />
273
274
  <coda:output name="at" /><coda:output name="deleteBranch" /><coda:output name="notify" /><coda:output name="what" />
274
- <coda:output name="only" /><coda:output name="inputs" /><coda:output name="missing" /><coda:output name="asks" />
275
+ <coda:output name="only" /><coda:output name="inputs" /><coda:output name="missing" /><coda:output name="asks" /><coda:output name="needs" />
275
276
  </extensionElements>
276
277
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs"</script>
277
278
  </scriptTask>
@@ -300,27 +301,34 @@
300
301
  <documentation>用户批准合并时勾的流程要一段文字,批准卡上没有写:
301
302
  {{split(approval.asks, "\n")[loopCounter]}}
302
303
  PR {{pr.url}} 已合并,合并提交 {{merge.commit}}。
303
- 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。</documentation>
304
- <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /></extensionElements>
304
+ 按这次合并进来的改动写这段面向用户的文字(Markdown,不写内部实现,不用审查意见),备注只放文字本身。
305
+ 选「这一项这次不跑」(备注可不写):这段文字不写,要它的流程这次都不跑,其余勾了的照常运行;都不跑了就直接结束。不想发出这段文字、写不出时选它,不要答复 rejected。</documentation>
306
+ <extensionElements><coda:choice id="done" name="已写好" primary="true" note="required" /><coda:choice id="skip" name="这一项这次不跑" /></extensionElements>
305
307
  <multiInstanceLoopCharacteristics isSequential="true" coda:inputCollection='=split(approval.missing, ",")' coda:inputElement="input" />
306
308
  </userTask>
307
309
  <sequenceFlow id="filled" sourceRef="fill" targetRef="merged-inputs" />
308
310
  <scriptTask id="merged-inputs" name="整理合并后流程的参数" coda:timeout="5" coda:checkout="false" scriptFormat="bash">
309
311
  <extensionElements>
310
312
  <coda:env name="INPUTS" value="=approval.inputs" /><coda:env name="MISSING" value="=approval.missing" />
311
- <coda:env name="ASKS" value="=approval.asks" /><coda:env name="FILLS" value="=fill" />
312
- <coda:output name="inputs" />
313
+ <coda:env name="ASKS" value="=approval.asks" /><coda:env name="FILLS" value="=fill" /><coda:env name="NEEDS" value="=approval.needs" /><coda:env name="ONLY" value="=approval.only" />
314
+ <coda:output name="inputs" /><coda:output name="only" />
313
315
  </extensionElements>
314
316
  <script>node "${CODA_PLUGIN_PATH}/scripts/approval.mjs" inputs</script>
315
317
  </scriptTask>
316
- <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="run-merged" />
318
+ <sequenceFlow id="to-run-merged" sourceRef="merged-inputs" targetRef="left" />
319
+ <exclusiveGateway id="left" name="还有要跑的合并后流程吗" default="left-run" />
320
+ <sequenceFlow id="left-none" sourceRef="left" targetRef="done-none"><conditionExpression xsi:type="tFormalExpression">=merged-inputs.only = "[]"</conditionExpression></sequenceFlow>
321
+ <sequenceFlow id="left-run" sourceRef="left" targetRef="run-merged" />
317
322
  <serviceTask id="run-merged" name="合并后的流程" coda:action="run-workflows" coda:status="运行合并后的流程">
318
323
  <extensionElements>
319
- <coda:param name="hook" value="merged" /><coda:param name="only" value="=approval.only" />
324
+ <coda:param name="hook" value="merged" /><coda:param name="only" value="=merged-inputs.only" />
320
325
  <coda:param name="commit" value="=merge.commit" /><coda:param name="inputs" value="=merged-inputs.inputs" />
321
326
  </extensionElements>
322
327
  </serviceTask>
323
328
  <sequenceFlow id="ran-merged" sourceRef="run-merged" targetRef="done" />
329
+ <endEvent id="done-none" name="已合并" coda:status="已合并,没有要跑的合并后流程" coda:notify="=approval.notify">
330
+ <extensionElements><coda:output name="pr" value="=pr.url" /><coda:output name="commit" value="=merge.commit" /><coda:output name="notify" value="=approval.notify" /></extensionElements>
331
+ </endEvent>
324
332
  <endEvent id="done" name="已合并" coda:notify="=approval.notify">
325
333
  <extensionElements><coda:output name="pr" value="=pr.url" /><coda:output name="commit" value="=merge.commit" /><coda:output name="notify" value="=approval.notify" /></extensionElements>
326
334
  </endEvent>
package/README.md CHANGED
@@ -45,13 +45,17 @@ prompts/principles/ 评审重点,一项一段,按设置取
45
45
 
46
46
  3.0.0 把批准卡上写死的「部署」「发布预览版」「发布正式版」换成挂点 `merged`([Coda #2521](https://github.com/coda-console/coda/issues/2521) 第 4 步):勾选项是项目里加入这个挂点的流程,合并后只运行勾了的;去掉「写更新说明」,加入者要的文字卡上没写时由开 PR 的会话(简易开发是主 Agent)逐项补写。`review.mergeOptions` 只剩 `deleteBranch`、`notify`,原来的 `deploy`、`preview`、`release` 不再认。卡上去掉了说明性的文字,只留做决定用的数据。需要支持 `hook-joiners` 与 `coda:optionList` 的 Coda(协议 5.17.0)。
47
47
 
48
+ 3.2.0 给「填写合并后流程要的文字」加了第二个选项「这一项这次不跑」:不写这段文字,要它的流程这次都不跑,其余勾了的照常运行(下文「挂点 merged」)。
49
+
50
+ 3.3.0 不再用流程类别([Coda #2521](https://github.com/coda-console/coda/issues/2521) 第 5 步):检查、合并前检查改为调用加入挂点 `check`、`premerge` 的流程(`run-workflows hook=…`),简易开发改为加入挂点 `develop`,不再写 `coda:kind`。项目里检查流程要显式写 `<coda:join hook="…"/>`。
51
+
48
52
  ## 项目提供的部分
49
53
 
50
54
  插件管流程,项目在自己的仓库里提供四样,跟着代码走:
51
55
 
52
56
  - **评审准则**:`.coda/review.md`,从 PR 的 **base 提交**读取,交给评审方,也写进「处理评审意见」交给开 PR 的会话。PR 改它只从合并后的评审起生效;文件不存在就省略,读不出 base 提交时这次评审失败。
53
- - **检查**:仓库里声明为 `coda:kind="check"` 的流程(第 2 步),每个版本都跑。
54
- - **合并前检查**:声明为 `coda:kind="premerge"` 的流程(第 5 步),你批准后在要合并的提交上只跑一次;每个版本都跑嫌贵的验证(如整套回归)放这里。
57
+ - **检查**:仓库里加入挂点 `check` 的流程(第 2 步),每个版本都跑。
58
+ - **合并前检查**:加入挂点 `premerge` 的流程(第 5 步),你批准后在要合并的提交上只跑一次;每个版本都跑嫌贵的验证(如整套回归)放这里。
55
59
  - **合并后的流程**:加入挂点 `merged` 的流程(第 6 步,下文「挂点 merged」),如部署、发布预览版、发布正式版。
56
60
 
57
61
  ## 流程
@@ -59,7 +63,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
59
63
  1. **草稿**:PR 是草稿就等作者标记为可评审(`pull_request.ready_for_review`);有新提交时按它带来的草稿状态重新判断,关闭则结束。
60
64
  推送和标记为可评审落在 Coda 的同一次查看之间时,只有新提交这一个事件,它说已不是草稿就去评审。
61
65
  2. **检查**:机器检查便宜,先过了它们再请 Agent 评审。
62
- - 「跑项目的检查」在 PR 的提交上调用项目声明的检查(`coda:kind="check"`)并等它们结束;没通过的检查让自己的运行失败,有一个失败就交给开 PR 的会话。
66
+ - 「跑项目的检查」在 PR 的提交上调用项目加入挂点 `check` 的流程并等它们结束;没通过的检查让自己的运行失败,有一个失败就交给开 PR 的会话。
63
67
  检查可以同时往提交上写一条 GitHub 状态,一句话结论在描述里。项目没有检查就直接过去。
64
68
  - 「等 GitHub 检查」(`checks.mjs`)再每隔几秒读一次 `gh pr checks`,等这个提交在 GitHub 上的检查(commit status 与 check run,包括 GitHub Actions)都有了结果,
65
69
  一小时没等到这一步失败。都通过就去评审,各项的一句话结论交给评审方、写在批准卡上;有没通过的同样交给开 PR 的会话。
@@ -94,7 +98,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
94
98
  主按钮「合并」按默认值提交;「更多」里的勾选项依次是「合并后删除远程分支」、这些流程(默认勾不勾由各自的 `default` 定)、「全部完成后通知 Agent」,删分支与通知初始按 `review.mergeOptions` 勾选。
95
99
  勾上要文字的流程(如发布要发布说明)时卡上出现对应的输入框,可以不写。
96
100
  另有「让 Agent 处理评审意见」:连同你的备注交给开 PR 的会话「处理你交付的评审意见」,它推送后重新评审、再请你批准,它做不了就回到批准卡;以及「关闭 PR」(`gh pr close`)。
97
- - 「合并前检查」:你选了合并后,先「记下批准」(`approval.mjs`):批准的时刻,和你勾的删分支、合并后的流程(连同卡上写的文字、没写的输入)、通知(合并后都照它做),再在评审通过的提交上调用项目声明的合并前检查(`coda:kind="premerge"`)并等它们结束;
101
+ - 「合并前检查」:你选了合并后,先「记下批准」(`approval.mjs`):批准的时刻,和你勾的删分支、合并后的流程(连同卡上写的文字、没写的输入)、通知(合并后都照它做),再在评审通过的提交上调用项目加入挂点 `premerge` 的流程(合并前检查)并等它们结束;
98
102
  项目没有就直接过去。有一个没通过就交给开 PR 的会话「合并前检查没通过:处理后答复」:改动导致的就推送新提交,照常检查、评审,通过后按你这次的选择合并,不再问;
99
103
  检查本身出了问题就处理好后答复,再跑一遍。它做不了交给你「合并前检查没通过:等你处理」。合并没成功后重试合并不再跑合并前检查(同一个提交已经通过)。
100
104
  需要认识 `premerge` 这一类的 Coda。
@@ -115,7 +119,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
115
119
  删除用 Git 的 `--force-with-lease=<ref>:<sha>`,推送期间分支变动也不会误删。读取或删除失败会让运行失败,处理后可从失败处继续,之后再运行合并后的流程。
116
120
  不勾选时流程不主动删分支;GitHub 仓库自身的「合并后自动删除分支」设置仍独立生效。
117
121
  6. **合并后的流程**:合并确认后,勾了的(`approval.only`)在合并提交(`merge_commit_sha`)上用 `run-workflows hook=merged` 运行,参数是卡上写的文字;
118
- 它们要的文字卡上没写的,先交开 PR 的会话「填写合并后流程要的文字」(下文「挂点 merged」)。一个都没勾就直接结束。
122
+ 它们要的文字卡上没写的,先交开 PR 的会话「填写合并后流程要的文字」(下文「挂点 merged」)。一个都没勾,或勾了的都被选了「这一项这次不跑」,就直接结束。
119
123
  失败时运行失败,结果交回开 PR 的会话,由它查明后手动重跑对应的流程。
120
124
 
121
125
  - PR 在 GitHub 网页上合并或关闭(不经这条运行的「等 GitHub 确认」,也不是上面那种你批准的版本在合并时先送到的关闭),运行随之结束,交出去的任务和卡片撤回,不删除分支、不运行合并后的流程。
@@ -167,15 +171,19 @@ GitHub 插件的 PR 观察看到这样的 PR,发 `foreign_pull_request.opened`
167
171
  主 Agent 自己在那里开工作树。只开分支,不建工作树、不清理;再走到这一步时分支已在就沿用。
168
172
  2. **交上改动**:第一张任务交给主 Agent。你在会话里直接开启时,这张任务不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么;Agent 填好交你确认的,你在开工卡上开工后,任务随需求消息交给它。它把改动提交到上一步定下的分支,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
169
173
  3. **推送**:流程读出这条分支的最新提交,推到运行自己的分支 `simple/<运行 ID>`(主 Agent 的分支不推),开 PR 到目标分支,标题是这次改动的第一个提交的标题;之后每次修改都推同一个分支(强推,主 Agent 可以变基)、更新同一个 PR。分支读不到、没有比目标分支新的提交,或答复「已修改」却没有新提交的,交回主 Agent。
170
- 4. **检查**:在这个提交上调用项目的 `coda:kind="check"`,没通过交回主 Agent,写明运行,它用 `workflow_status` 读失败的步骤和日志。
174
+ 4. **检查**:在这个提交上调用项目加入挂点 `check` 的流程,没通过交回主 Agent,写明运行,它用 `workflow_status` 读失败的步骤和日志。
171
175
  5. **评审一次**:`reviewer`(或评审组合里的那一行)在只读会话里评审,规则、阻塞级别、评审重点与 PR 生命流程相同,结论也写成 PR 评论。要求修改时交主 Agent「处理评审意见」:改了就提交、选「已修改」;不改选「不改」,必须写明理由,写进 PR 和批准卡,由你批准时判断。之后只重跑检查,不评第二轮。
172
176
  6. **设备验收**(`devices` 打开时):主 Agent 只装改到的那一端(`mac-preview-install`、`ios-preview-install`,传 PR 的提交),你在设备上验收;「不行」必须附言(写意见或附截图),交回主 Agent 修改,改好后重新验收。验收过的提交之后又改了,也要重新验收。
173
- 7. **合并前检查与 GitHub 检查**:在 PR 的提交上跑一次 `coda:kind="premerge"`,再等 GitHub 上的检查都有结果;没通过交回主 Agent。
177
+ 7. **合并前检查与 GitHub 检查**:在 PR 的提交上跑一次加入挂点 `premerge` 的流程,再等 GitHub 上的检查都有结果;没通过交回主 Agent。
174
178
  8. **批准合并**:卡片上是改动汇报、评审结论、不改的理由、检查结果与 PR。「合并」按 `review.mergeMethod` 合并这个提交,可勾项目里加入挂点 `merged` 的流程(`hook-joiners` 列出,默认由各自声明)与「全部完成后通知 Agent」(默认勾选);「暂不合并」必须写明原因,交给主 Agent 跟进。合并时删除运行自己的分支;与目标分支冲突时交回主 Agent 合入、解冲突,再重跑检查、重新批准。其余合并失败让这一步失败。
175
179
  9. **合并后的流程**:合并后在合并提交上运行勾了的;它们要的文字卡上没写的先交主 Agent 逐项补写(下文「挂点 merged」)。
176
180
 
177
181
  所有交回主 Agent 修改的(评审意见除外)都是同一张「修改后答复」,写明要改的是什么;答复后从推送重新走。进度存在本次运行的产物 `simple.json` 里。需要支持流程参数 `agent` 类型、`coda:wake` 与 `note="required"` 的 Coda。
178
182
 
183
+ ## 挂点 check、premerge
184
+
185
+ PR 生命流程与简易开发在一个提交上调用项目加入挂点 `check`(每个版本都跑)、`premerge`(批准后、合并前只跑一次)的流程,传 `commit`,全部运行并等结束,有一个失败就算没通过。项目在检查流程的 `process` 上写 `<coda:join hook="check" />` 或 `<coda:join hook="premerge" />` 加入。简易开发自己加入挂点 `develop`:Coda 在「+」和开工卡上列出加入这个挂点的流程作为开发流程。
186
+
179
187
  ## 挂点 merged
180
188
 
181
189
  PR 生命流程与简易开发声明挂点 `merged`:合并后要做的事由项目自己的流程(或启用插件的流程)在 `process` 上写 `<coda:join hook="merged" …/>` 加入(Coda 的 `docs/workflows.md`「调用其他流程」),本插件不认识任何一类。约定:
@@ -183,7 +191,7 @@ PR 生命流程与简易开发声明挂点 `merged`:合并后要做的事由
183
191
  - **加入者带什么**:`name` 是卡上勾选项的名字(不写用流程名),`detail` 一行说明,`default` 是否默认勾(不写为不勾,默认不勾就由加入者这样表达),`order` 排序(小的在前),可选 `inputs`:它要从卡上拿的自己的文字参数(本流程 `type` 为 string 的 `coda:input`,标签取参数的 `label`),如发布说明 `notes`。
184
192
  - **卡上**:批准前用 `hook-joiners`(`hook=merged`,`commit` 是要合并的提交)列出加入者,作为「合并」的勾选项,你可以勾任意几个;勾上带 `inputs` 的出现对应的输入框。
185
193
  - **合并后**:在合并提交上用 `run-workflows`(`hook=merged`,`only` 是勾了的流程名,`commit` 是合并提交,`inputs` 是卡上写的文字加补写的)运行勾了的,等它们都结束;每个加入者只拿到它声明的参数。没勾任何一个就不调用。
186
- - **卡上没写的文字**:勾了的加入者要、卡上没写的输入,先交开 PR 的会话(简易开发是主 Agent)「填写合并后流程要的文字」,每个输入一张、依次,任务里写明是哪一项、哪几个流程要;备注必填,只附文件没写字时「整理合并后流程的参数」失败并写明是哪一项。
194
+ - **卡上没写的文字**:勾了的加入者要、卡上没写的输入,先交开 PR 的会话(简易开发是主 Agent)「填写合并后流程要的文字」,每个输入一张、依次,任务里写明是哪一项、哪几个流程要;「已写好」的备注必填,只附文件没写字时「整理合并后流程的参数」失败并写明是哪一项。选「这一项这次不跑」(备注可不写)是这段文字不写:「整理合并后流程的参数」把所有勾了且要这段文字的加入者(几个加入者共用一段文字,如预览发布与正式发布都要 `notes`,就全部)从 `only` 里去掉,输出新的 `only` 交给 `run-workflows`,其余勾了的照常运行;新的 `only` 为空就不调用 `run-workflows`,运行照常成功结束,状态写「已合并,没有要跑的合并后流程」。
187
195
 
188
196
  ## 评审一段提交
189
197
 
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": "3.1.0",
7
+ "version": "3.3.0",
8
8
  "categories": [
9
9
  "工作流程"
10
10
  ],
@@ -2,23 +2,28 @@
2
2
  // asking for changes later voids it), and what they chose to follow the merge: `deleteBranch`, `notify`, and the workflows
3
3
  // joining the hook `merged` they ticked (JOINERS is the list hook-joiners gave the card): `only`, their names as JSON for
4
4
  // run-workflows; `inputs`, the text the card took for them; `missing`, the ids (comma separated) of the inputs they ask
5
- // for that the card left empty, and `asks`, a line for each, in the same order, saying which of them asks. `what` is the
5
+ // for that the card left empty, `asks`, a line for each, in the same order, saying which of them asks, and `needs`, for
6
+ // each of those ids the ticked workflows that ask for it (JSON). `what` is the
6
7
  // choice as the merge step says it. Put out here, not by the merge step, so that the process follows the choice however it
7
8
  // hears of the merge: after the merge step, or from GitHub while that step still runs.
8
9
  //
9
10
  // With `inputs`, after the merge: what run-workflows gives them, the card's text and what the session wrote for each of
10
- // `missing` (FILLS, one task each, in order); one written with no text fails the step, naming it.
11
+ // `missing` (FILLS, one task each, in order); one written with no text fails the step, naming it. A text the session
12
+ // answered `skip` for is not written, and every ticked workflow asking for it drops out of `only` (ONLY, NEEDS): the
13
+ // `only` to run, `[]` when none is left.
11
14
  import { json, output } from './step.mjs';
12
15
 
13
16
  if (process.argv[2] === 'inputs') {
14
- const inputs = json('INPUTS', {}), ids = (process.env.MISSING || '').split(',').filter(Boolean);
15
- const fills = json('FILLS', []), asks = (process.env.ASKS || '').split('\n');
17
+ const inputs = json('INPUTS', {}), ids = (process.env.MISSING || '').split(',').filter(Boolean), needs = json('NEEDS', {});
18
+ const fills = json('FILLS', []), asks = (process.env.ASKS || '').split('\n'), dropped = new Set();
16
19
  ids.forEach((id, i) => {
20
+ if (fills[i]?.choice === 'skip') { needs[id].forEach(joiner => dropped.add(joiner)); return; }
17
21
  const text = String(fills[i]?.note ?? '').trim();
18
22
  if (!text) { console.error(`${asks[i] || id}:没有填写,不运行合并后的流程`); process.exit(1); }
19
23
  inputs[id] = text;
20
24
  });
21
25
  output('inputs', JSON.stringify(inputs));
26
+ output('only', JSON.stringify(json('ONLY', []).filter(id => !dropped.has(id))));
22
27
  process.exit(0);
23
28
  }
24
29
 
@@ -28,7 +33,7 @@ const ticked = json('JOINERS', []).filter(joiner => chosen(joiner.id)), inputs =
28
33
  for (const joiner of ticked) for (const { id, label } of joiner.inputs ?? []) {
29
34
  const text = String(written[id] ?? '').trim();
30
35
  if (text) inputs[id] = text;
31
- else (missing.get(id) ?? missing.set(id, { label, for: [] }).get(id)).for.push(joiner.name);
36
+ else (missing.get(id) ?? missing.set(id, { label, for: [] }).get(id)).for.push(joiner);
32
37
  }
33
38
  output('at', Date.now());
34
39
  output('deleteBranch', chosen('deleteBranch'));
@@ -36,6 +41,7 @@ output('notify', chosen('notify'));
36
41
  output('only', JSON.stringify(ticked.map(joiner => joiner.id)));
37
42
  output('inputs', JSON.stringify(inputs));
38
43
  output('missing', [...missing.keys()].join(','));
39
- output('asks', [...missing.values()].map(m => `「${m.label}」:${m.for.join('、')}要`).join('\n'));
44
+ output('asks', [...missing.values()].map(m => `「${m.label}」:${m.for.map(joiner => joiner.name).join('、')}要`).join('\n'));
45
+ output('needs', JSON.stringify(Object.fromEntries([...missing].map(([id, m]) => [id, m.for.map(joiner => joiner.id)]))));
40
46
  output('what', ['合并', ...(chosen('deleteBranch') ? ['合并后删除远程分支'] : []), ...ticked.map(joiner => joiner.name),
41
47
  ...(chosen('notify') ? ['全部完成后通知 Agent'] : [])].join(' · '));
@@ -1,5 +1,5 @@
1
1
  // Waits for the pull request's checks on GitHub (../.coda/workflows/pull-request.bpmn「等 GitHub 检查」): what GitHub has on
2
- // its head commit, commit statuses and check runs alike, whoever ran them. The project's own checks (coda:kind="check")
2
+ // its head commit, commit statuses and check runs alike, whoever ran them. The project's own checks (workflows joining hook check)
3
3
  // have ended by now, and wrote what they found as statuses if they do; others (GitHub Actions) are waited for until each
4
4
  // has a result. Then it says whether all passed (`passed`) and each check in a line (`lines`, for the reviewer and the
5
5
  // approval card). Asked every `EVERY` seconds; it gives up when the step times out.