@coda-console/review 2.13.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.
- package/.coda/workflows/simple.bpmn +3 -3
- package/README.md +3 -3
- package/package.json +1 -1
|
@@ -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
|
|
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
|
-
|
|
11
|
+
另有一个「简易开发」(流程 `simple`,见下文),由你在会话里开启,或由 Agent 发起「开工」后你在开工卡上确认;它复用这里的评审与合并。
|
|
12
12
|
|
|
13
13
|
```
|
|
14
14
|
.coda/workflows/pull-request.bpmn 流程本身
|
|
@@ -119,7 +119,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
|
|
|
119
119
|
|
|
120
120
|
## 简易开发
|
|
121
121
|
|
|
122
|
-
主 Agent 自己把活干完时,在会话的流程里开启「简易开发」(`simple
|
|
122
|
+
主 Agent 自己把活干完时,在会话的流程里开启「简易开发」(`simple`),或让 Agent 发起「开工」并在开工卡上选「开工:简易开发」:流程推送、跑检查、评审一次,你验收、批准后合并。比 PR 生命流程轻:只评审一轮,不等 PR 事件。
|
|
123
123
|
|
|
124
124
|
| 输入 | 用途 |
|
|
125
125
|
| --- | --- |
|
|
@@ -129,7 +129,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
|
|
|
129
129
|
| `device` | 「验收设备」,如 `duo-testbed`,默认空;验收期间独占这台设备 |
|
|
130
130
|
| `base` | 「目标分支」,留空用仓库默认分支 |
|
|
131
131
|
|
|
132
|
-
1. **交上改动**:第一张任务交给主 Agent
|
|
132
|
+
1. **交上改动**:第一张任务交给主 Agent。你在会话里直接开启时,这张任务不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么;Agent 经「开工」发起时,你在开工卡上选定后流程把下一步交给它,不必等你的下一条消息。它把改动提交到 `branch`,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
|
|
133
133
|
2. **推送**:流程读出 `branch` 的最新提交,推到运行自己的分支 `simple/<运行 ID>`(主 Agent 的分支不推),开 PR 到目标分支,标题是这次改动的第一个提交的标题;之后每次修改都推同一个分支(强推,主 Agent 可以变基)、更新同一个 PR。分支读不到、没有比目标分支新的提交,或答复「已修改」却没有新提交的,交回主 Agent。
|
|
134
134
|
3. **检查**:在这个提交上调用项目的 `coda:kind="check"`,没通过交回主 Agent,写明运行,它用 `workflow_status` 读失败的步骤和日志。
|
|
135
135
|
4. **评审一次**:`reviewer`(或评审组合里的那一行)在只读会话里评审,规则、阻塞级别、评审重点与 PR 生命流程相同,结论也写成 PR 评论。要求修改时交主 Agent「处理评审意见」:改了就提交、选「已修改」;不改选「不改」,必须写明理由,写进 PR 和批准卡,由你批准时判断。之后只重跑检查,不评第二轮。
|