@coda-console/review 2.17.0 → 2.17.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 +4 -4
  2. package/package.json +1 -1
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`,见下文),由你在会话里开启,或由 Agent 发起「开工」后你在开工卡上确认;它复用这里的评审与合并。
11
+ 另有一个「简易开发」(流程 `simple`,见下文),由你在会话里开启,或由 Agent 填好交你在开工卡上确认;它复用这里的评审与合并。
12
12
  还有一个能力「评审一段提交」(`review-commit`,见下文):没有 PR 时,别的流程按名字调用它,用同一套规则评一段提交。
13
13
 
14
14
  ```
@@ -121,7 +121,7 @@ prompts/principles/ 评审重点,一项一段,按设置取
121
121
 
122
122
  ## 简易开发
123
123
 
124
- 主 Agent 自己把活干完时,在会话的流程里开启「简易开发」(`simple`),或让 Agent 发起「开工」并在开工卡上选「开工:简易开发」:流程推送、跑检查、评审一次,你验收、批准后合并。比 PR 生命流程轻:只评审一轮,不等 PR 事件。
124
+ 主 Agent 自己把活干完时,在输入框「+」里开启「简易开发」(`simple`),或由 Agent 用 `workflow_run` 带 `confirm: true` 填好、你在开工卡上确认:流程推送、跑检查、评审一次,你验收、批准后合并。比 PR 生命流程轻:只评审一轮,不等 PR 事件。
125
125
 
126
126
  | 输入 | 用途 |
127
127
  | --- | --- |
@@ -132,9 +132,9 @@ prompts/principles/ 评审重点,一项一段,按设置取
132
132
  | `base` | 「目标分支」,留空用仓库默认分支 |
133
133
 
134
134
  1. **准备分支**:改动交在哪条分支上,由发起的 Agent 负责:开在别的目录、或要指定分支时,它自己开好分支,发起时传 `branch`。传了(或会话所在的分支)就用它;
135
- 都没有时(被「开工」从别的目录调用,会话不在这个仓库),流程从目标分支的最新提交开 `agent/simple-<运行 ID>`,在第一张任务里告诉主 Agent 分支名和仓库路径,
135
+ 都没有时(从别的目录发起,会话不在这个仓库),流程从目标分支的最新提交开 `agent/simple-<运行 ID>`,在第一张任务里告诉主 Agent 分支名和仓库路径,
136
136
  主 Agent 自己在那里开工作树。只开分支,不建工作树、不清理;再走到这一步时分支已在就沿用。
137
- 2. **交上改动**:第一张任务交给主 Agent。你在会话里直接开启时,这张任务不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么;Agent 经「开工」发起时,你在开工卡上选定后流程把下一步交给它,不必等你的下一条消息。它把改动提交到上一步定下的分支,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
137
+ 2. **交上改动**:第一张任务交给主 Agent。你在会话里直接开启时,这张任务不叫醒它(`coda:wake="false"`),随你在会话里的下一条消息告诉它:你开启了简易开发、它要做什么;Agent 填好交你确认的,你在开工卡上开工后,任务随需求消息交给它。它把改动提交到上一步定下的分支,答复时备注必填,是写给你的改动汇报,放在 PR 描述和批准卡最上面。
138
138
  3. **推送**:流程读出这条分支的最新提交,推到运行自己的分支 `simple/<运行 ID>`(主 Agent 的分支不推),开 PR 到目标分支,标题是这次改动的第一个提交的标题;之后每次修改都推同一个分支(强推,主 Agent 可以变基)、更新同一个 PR。分支读不到、没有比目标分支新的提交,或答复「已修改」却没有新提交的,交回主 Agent。
139
139
  4. **检查**:在这个提交上调用项目的 `coda:kind="check"`,没通过交回主 Agent,写明运行,它用 `workflow_status` 读失败的步骤和日志。
140
140
  5. **评审一次**:`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.17.0",
7
+ "version": "2.17.1",
8
8
  "categories": [
9
9
  "工作流程"
10
10
  ],