@coda-console/review 2.12.0 → 2.14.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.
@@ -17,7 +17,7 @@
17
17
  <message id="ready" name="pull_request.ready_for_review" />
18
18
  <message id="edited" name="pull_request.edited" />
19
19
  <message id="closed" name="pull_request.closed" />
20
- <process id="pull-request" name="PR 生命流程" isExecutable="true"
20
+ <process id="pull-request" name="PR 生命流程" isExecutable="true" coda:autoRun="=vars.review.autoRun"
21
21
  coda:key='=lower case(if github.event.pull_request.html_url != null then github.event.pull_request.html_url
22
22
  else if matches(inputs.pr, "^https://github[.]com/[a-z0-9_.-]+/[a-z0-9_.-]+/pull/[1-9][0-9]*$", "i") then inputs.pr else null)'
23
23
  coda:title='PR {{if github.event.coda.heard = null then (if review.pr = null then inputs.pr else review.pr) else "#" + string(github.event.number) + " " + github.event.pull_request.title}}'>
@@ -8,7 +8,7 @@
8
8
  合并前检查、GitHub 检查都通过后请你批准;合并后按你勾选的部署、发布。BPMN 2.0,由 Coda 执行(docs/workflows.md)。 -->
9
9
  <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:coda="https://coda.pub/schema/bpmn/1.0"
10
10
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" id="simple-definitions" targetNamespace="https://coda.pub/plugins/review">
11
- <process id="simple" name="简易开发" isExecutable="true" coda:title="简易开发">
11
+ <process id="simple" name="简易开发" isExecutable="true" coda:kind="develop" coda:title="简易开发">
12
12
  <extensionElements>
13
13
  <coda:input name="branch" label="分支" type="branch" defaultFrom="session.branch" required="true" description="主 Agent 提交改动的分支,默认是会话所在的分支" />
14
14
  <coda:input name="reviewer" label="评审方" type="agent" description="不选按插件设置「评审组合」:Claude 写的由 Codex 评,反之亦然" />
@@ -20,7 +20,7 @@
20
20
  <sequenceFlow id="start-report" sourceRef="start" targetRef="report" />
21
21
 
22
22
  <userTask id="report" name="交上改动" coda:wake="false" coda:noteLabel="写给用户的改动汇报">
23
- <documentation>用户在这个会话里开启了简易开发:你自己把这次的改动做完,流程推送、跑项目检查、请{{if inputs.reviewer = null then "评审方" else " " + inputs.reviewer.agent + " "}}评审一次,用户验收、批准后合并。
23
+ <documentation>这次用简易开发:你自己把这次的改动做完,流程推送、跑项目检查、请{{if inputs.reviewer = null then "评审方" else " " + inputs.reviewer.agent + " "}}评审一次,用户验收、批准后合并。
24
24
  把改动提交到分支 {{inputs.branch}}(不用推送、不用开 PR),再答复。备注必填,是写给用户的改动汇报,会放在 PR 描述和批准卡最上面。约 8 行以内,只写用户能感知的变化和动到的端,不放实现细节、测试数量、文件清单,不贴代码:
25
25
  做了什么
26
26
  - …(3~5 条)
@@ -306,7 +306,7 @@
306
306
  </serviceTask>
307
307
  <sequenceFlow id="published" sourceRef="publish" targetRef="done" />
308
308
  <endEvent id="done" name="已合并" coda:notify="=approval.notify">
309
- <extensionElements><coda:output name="pr" value="=pr.url" /><coda:output name="commit" value="=merge.commit" /></extensionElements>
309
+ <extensionElements><coda:output name="pr" value="=pr.url" /><coda:output name="commit" value="=merge.commit" /><coda:output name="notify" value="=approval.notify" /></extensionElements>
310
310
  </endEvent>
311
311
  </process>
312
312
  </definitions>
package/README.md CHANGED
@@ -8,7 +8,7 @@
8
8
  也可以 `workflow_run pull-request` 手动发起(必填 `pr`:GitHub 返回的完整 PR 地址,可选 `focus`)。已有运行时返回它,沿用原进度、关注点和结果接收会话;草稿中的运行也照旧等标记为可评审。没有运行时只评审一次、不计次数、不进入合并;如果随后 PR 观察发来事件,在同一条运行里接上完整流程。是否接入完整流程按 `github.event.coda.heard` 判断:手动运行尚未收到事件时为空。
9
9
  `pr` 须在创建运行前明确。编号、旧仓库地址或带后缀的链接先用 `gh pr view <编号或链接> --json url --jq .url` 取得 GitHub 返回的地址,再传入;流程不从 origin 猜仓库身份。需要查最近开的 PR 时先用 GitHub 插件的 `github-reported-pr` 找到它,再用 `gh pr view` 确认当前地址。输入不接受编号、末尾斜线、查询参数或片段,避免不同拼写创建不同主键。此版本需要支持 `coda:key` 的 Coda 流程引擎。
10
10
 
11
- 另有一个由你在会话里开启的「简易开发」(流程 `simple`,见下文),复用这里的评审与合并。
11
+ 另有一个「简易开发」(流程 `simple`,见下文),由你在会话里开启,或由 Agent 发起「开工」后你在开工卡上确认;它复用这里的评审与合并。
12
12
 
13
13
  ```
14
14
  .coda/workflows/pull-request.bpmn 流程本身
@@ -29,6 +29,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
29
29
 
30
30
  | 设置 | 类型 | 默认 |
31
31
  | --- | --- | --- |
32
+ | `review.autoRun` PR 自动运行 | 开关:会话开的 PR 新建或有新提交时是否自动开始;关掉后只能手动发起。会话或目录在「工作流」里单独设过的按它们的(流程的 `coda:autoRun`);不影响简易开发 | 开 |
32
33
  | `review.reviewers` 评审组合 | 表格:作者匹配 → Agent 组合 | Claude 由 Codex 评审,Codex 由 Claude 评审,Kimi、Grok 由 Codex 评审,OpenCode 由 Claude 评审 |
33
34
  | `review.blockingSeverity` 阻塞级别 | P0–P3 之一 | P2 |
34
35
  | `review.principles` 评审重点 | 多选:`state` 状态与失败、`defense` 多余的防御、`architecture` 架构与腐化、`tests` 测试;勾选的那几段(`prompts/principles/` 下同名文件)放进提示词 | 都选 |
@@ -118,7 +119,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
118
119
 
119
120
  ## 简易开发
120
121
 
121
- 主 Agent 自己把活干完时,在会话的流程里开启「简易开发」(`simple`):流程推送、跑检查、评审一次,你验收、批准后合并。比 PR 生命流程轻:只评审一轮,不等 PR 事件。
122
+ 主 Agent 自己把活干完时,在会话的流程里开启「简易开发」(`simple`),或让 Agent 发起「开工」并在开工卡上选「开工:简易开发」:流程推送、跑检查、评审一次,你验收、批准后合并。比 PR 生命流程轻:只评审一轮,不等 PR 事件。
122
123
 
123
124
  | 输入 | 用途 |
124
125
  | --- | --- |
@@ -128,7 +129,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
128
129
  | `device` | 「验收设备」,如 `duo-testbed`,默认空;验收期间独占这台设备 |
129
130
  | `base` | 「目标分支」,留空用仓库默认分支 |
130
131
 
131
- 1. **交上改动**:第一张任务交给主 Agent,不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么。它把改动提交到 `branch`,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
132
+ 1. **交上改动**:第一张任务交给主 Agent。你在会话里直接开启时,这张任务不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么;Agent 经「开工」发起时,你在开工卡上选定后流程把下一步交给它,不必等你的下一条消息。它把改动提交到 `branch`,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
132
133
  2. **推送**:流程读出 `branch` 的最新提交,推到运行自己的分支 `simple/<运行 ID>`(主 Agent 的分支不推),开 PR 到目标分支,标题是这次改动的第一个提交的标题;之后每次修改都推同一个分支(强推,主 Agent 可以变基)、更新同一个 PR。分支读不到、没有比目标分支新的提交,或答复「已修改」却没有新提交的,交回主 Agent。
133
134
  3. **检查**:在这个提交上调用项目的 `coda:kind="check"`,没通过交回主 Agent,写明运行,它用 `workflow_status` 读失败的步骤和日志。
134
135
  4. **评审一次**:`reviewer`(或评审组合里的那一行)在只读会话里评审,规则、阻塞级别、评审重点与 PR 生命流程相同,结论也写成 PR 评论。要求修改时交主 Agent「处理评审意见」:改了就提交、选「已修改」;不改选「不改」,必须写明理由,写进 PR 和批准卡,由你批准时判断。之后只重跑检查,不评第二轮。
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": "2.12.0",
7
+ "version": "2.14.0",
8
8
  "categories": [
9
9
  "工作流程"
10
10
  ],
@@ -15,6 +15,13 @@
15
15
  "configuration": {
16
16
  "title": "PR 生命流程",
17
17
  "properties": {
18
+ "review.autoRun": {
19
+ "title": "PR 自动运行",
20
+ "type": "boolean",
21
+ "order": 0,
22
+ "default": true,
23
+ "description": "会话开的 PR 新建或有新提交时自动开始 PR 生命流程。关掉后只能手动发起;会话或目录在「工作流」里单独设过的,按它们的。不影响简易开发。"
24
+ },
18
25
  "review.reviewers": {
19
26
  "title": "评审组合",
20
27
  "type": "object",