@autobest-ui/agent 1.0.5 → 1.0.6
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/package.json
CHANGED
|
@@ -1,21 +1,24 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: code-pr-submit
|
|
3
|
-
description:
|
|
3
|
+
description: 从当前 Git 项目自动识别 Azure DevOps 仓库、当前分支及其父分支，生成 PR 标题和描述，并通过 code-mcp-pr 创建从当前分支合并到父分支的 PR。用户要求创建或提交 Azure PR、为当前分支提 PR，或预览待提交 PR 时使用。用户显式参数优先；只在本地项目无法推断必要信息时询问。
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Azure DevOps
|
|
6
|
+
# Azure DevOps PR 提交
|
|
7
7
|
|
|
8
|
-
##
|
|
8
|
+
## 目标
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
在当前项目中创建普通方向的 PR：
|
|
11
11
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
```text
|
|
13
|
+
from = 当前开发分支（携带变更）
|
|
14
|
+
to = 当前分支的父分支（创建该分支时所基于的分支）
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
面向用户始终使用 `from -> to`、源分支和目标分支等常规 Git 术语。MCP 的历史字段命名只在最终参数映射时内部处理。
|
|
15
18
|
|
|
16
|
-
|
|
19
|
+
只通过 `code-mcp-pr` MCP 访问 Azure DevOps 和钉钉。PAT 与钉钉 token 由 MCP 从 `AZURE_DEVOPS_PAT`、`DINGDING_ALERT_TOKEN` 读取；Skill 不读取、持有或传递凭据。
|
|
17
20
|
|
|
18
|
-
|
|
21
|
+
可用 MCP 工具：
|
|
19
22
|
|
|
20
23
|
- `code-mcp-pr.code-mcp-pr`
|
|
21
24
|
- `code-mcp-pr.get_repo_default_branch`
|
|
@@ -23,218 +26,183 @@ description: 编排 Azure DevOps 反向 PR：将用户所说的目标分支作
|
|
|
23
26
|
- `code-mcp-pr.get_branch_diff`
|
|
24
27
|
- `code-mcp-pr.read_file_at_ref`
|
|
25
28
|
|
|
26
|
-
##
|
|
29
|
+
## 输入优先级
|
|
27
30
|
|
|
28
|
-
|
|
31
|
+
用户显式提供的值始终优先。用户没有提供时，从当前 Git 项目自动发现，不先展示参数清单，不要求用户重复填写能够查到的信息。
|
|
29
32
|
|
|
30
|
-
|
|
31
|
-
| --- | --- | --- |
|
|
32
|
-
| `orgName` | 是 | ADO 组织 |
|
|
33
|
-
| `projectName` | 是 | ADO 项目 |
|
|
34
|
-
| `repoId` | 是 | 仓库 ID/Guid |
|
|
35
|
-
| `currentBranch` | 否 | 运行环境明确提供的当前分支；远程 ADO 无法探测 |
|
|
36
|
-
| `targetBranch` | 条件必填 | 用户所说的目标分支，携带变更 |
|
|
37
|
-
| `sourceBranch` | 条件必填 | 用户所说的来源分支，接收合并 |
|
|
38
|
-
| `prTitle` | 是 | PR 标题 |
|
|
39
|
-
| `prDescription` | 否 | 用户手动提供的 PR 描述；未提供时自动生成 |
|
|
40
|
-
| `reviewers` | 否 | 评审人 ID 列表 |
|
|
33
|
+
内部使用以下清晰字段：
|
|
41
34
|
|
|
42
|
-
|
|
35
|
+
| 字段 | 自动来源 |
|
|
36
|
+
| --- | --- |
|
|
37
|
+
| `orgName` | Azure DevOps `origin` URL |
|
|
38
|
+
| `projectName` | Azure DevOps `origin` URL |
|
|
39
|
+
| `repoId` | Azure DevOps `origin` URL 中的仓库名；ADO API 接受仓库名或 GUID |
|
|
40
|
+
| `fromBranch` | 当前 Git 分支 |
|
|
41
|
+
| `toBranch` | 分支创建 reflog、本地 merge-base 或 MCP 启发结果 |
|
|
42
|
+
| `prTitle` | 用户输入；否则使用当前分支最新的非合并 commit 标题，并结合分支名清理 |
|
|
43
|
+
| `prDescription` | 用户输入；否则根据远端 diff 和当前分支的 `spec.md` 自动生成 |
|
|
44
|
+
| `reviewers` | 仅使用用户明确提供的评审人 ID；缺失时省略 |
|
|
43
45
|
|
|
44
|
-
##
|
|
46
|
+
## 自动发现项目
|
|
45
47
|
|
|
46
|
-
|
|
48
|
+
收到请求后立即在当前工作目录执行只读 Git 命令，不先向用户索要字段：
|
|
47
49
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
50
|
+
```bash
|
|
51
|
+
git rev-parse --show-toplevel
|
|
52
|
+
git branch --show-current
|
|
53
|
+
git remote get-url origin
|
|
54
|
+
```
|
|
53
55
|
|
|
54
|
-
|
|
56
|
+
从 `origin` 解析 ADO 信息，至少支持：
|
|
55
57
|
|
|
56
|
-
|
|
58
|
+
```text
|
|
59
|
+
https://dev.azure.com/{org}/{project}/_git/{repo}
|
|
60
|
+
https://{user}@dev.azure.com/{org}/{project}/_git/{repo}
|
|
61
|
+
https://{org}.visualstudio.com/{project}/_git/{repo}
|
|
62
|
+
git@ssh.dev.azure.com:v3/{org}/{project}/{repo}
|
|
63
|
+
ssh://git@ssh.dev.azure.com/v3/{org}/{project}/{repo}
|
|
64
|
+
```
|
|
57
65
|
|
|
58
|
-
|
|
66
|
+
对 URL decode 后的值去除仓库名末尾 `.git`。如果有多个 remote，优先 `origin`；`origin` 不存在时检查唯一的 ADO remote。不要把 remote 用户名误当成组织名。
|
|
59
67
|
|
|
60
|
-
|
|
68
|
+
以下情况才询问用户对应的最少信息：当前目录不在 Git 仓库；处于 detached HEAD 且用户未给 `fromBranch`；没有可解析的 ADO remote；必要字段存在多个冲突候选。一次只汇总真正无法发现的字段。
|
|
61
69
|
|
|
62
|
-
|
|
70
|
+
## 自动发现父分支
|
|
63
71
|
|
|
64
|
-
|
|
72
|
+
目标是找出 `fromBranch` 创建时所基于的分支，而不是无条件返回默认分支。按以下优先级执行：
|
|
65
73
|
|
|
66
|
-
|
|
74
|
+
1. 用户明确提供 `toBranch` 时直接使用。
|
|
75
|
+
2. 检查当前分支最早的 reflog 记录：
|
|
67
76
|
|
|
68
|
-
|
|
77
|
+
```bash
|
|
78
|
+
git reflog show --format='%H%x09%gs' -- "${fromBranch}"
|
|
79
|
+
```
|
|
69
80
|
|
|
70
|
-
|
|
81
|
+
从最早记录中的 `branch: Created from <ref>` 提取父分支。`<ref>` 是明确分支名且能被 `git rev-parse --verify` 解析时采用；`HEAD`、commit SHA 或已失效 ref 继续下一步。
|
|
82
|
+
3. 使用本地 refs 做 merge-base 启发：列出 `refs/heads` 和 `refs/remotes/origin`，排除当前分支、其远端同名分支、`*/HEAD`，计算各候选与 `fromBranch` 的 merge-base。优先选择 merge-base 等于 reflog 创建 commit 的候选；多个候选并列时，优先远端跟踪分支和 `origin` 默认分支。仍并列时根据从 merge-base 到 `fromBranch` 的提交距离选择最近者。
|
|
83
|
+
4. 本地历史不足时调用 `code-mcp-pr.guess_parent_branch`，传入自动发现的仓库信息和 `fromBranch`。
|
|
84
|
+
5. 所有方式均失败或仍有多个同等可信候选时，展示候选及推断依据，请用户只选择 `toBranch`。
|
|
71
85
|
|
|
72
|
-
|
|
73
|
-
- 用户未提供 `targetBranch`，且 `currentBranch` 为空：直接询问用户提供“目标分支（携带变更的分支）”。远程 ADO API 没有全局当前分支，不能调用 MCP 或根据仓库信息编造当前分支。
|
|
86
|
+
将 `origin/foo`、`refs/remotes/origin/foo` 和 `refs/heads/foo` 规范成业务分支名 `foo`。父分支推断完成后比较规范化的 `fromBranch` 与 `toBranch`；相同时停止并请求修正。
|
|
74
87
|
|
|
75
|
-
|
|
88
|
+
父分支推断属于启发式，但不要在正常成功路径输出长篇限制说明。只在置信度较低或需要用户选择时简短说明依据。
|
|
76
89
|
|
|
77
|
-
|
|
90
|
+
## 收集 PR 内容
|
|
78
91
|
|
|
79
|
-
|
|
80
|
-
- 用户未提供 `sourceBranch`：调用 `code-mcp-pr.guess_parent_branch`：
|
|
92
|
+
分支确定后调用 `code-mcp-pr.get_branch_diff`：
|
|
81
93
|
|
|
82
94
|
```yaml
|
|
83
95
|
orgName: ${orgName}
|
|
84
96
|
projectName: ${projectName}
|
|
85
97
|
repoId: ${repoId}
|
|
86
|
-
|
|
98
|
+
sourceBranch: ${fromBranch}
|
|
99
|
+
targetBranch: ${toBranch}
|
|
87
100
|
```
|
|
88
101
|
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
> ⚠️ 无法获取该分支真实创建父分支，启发推测父分支为：${guessedParentBranch}，${hint}
|
|
92
|
-
> 是否使用 ${guessedParentBranch} 作为 PR 目标分支（接收合并）？
|
|
93
|
-
|
|
94
|
-
ADO Git 不持久保存分支创建时的父分支；此结果只是启发式猜测。用户确认后才赋值给 `sourceBranch`。用户拒绝时请其手动输入来源分支，再展示其 PR 目标语义并确认。
|
|
95
|
-
|
|
96
|
-
当工具失败、`guessedParentBranch` 为空，或目标分支本身是默认分支而无法推测时，说明工具返回的 `errorMsg`/`hint`，请用户手动提供来源分支。`get_repo_default_branch` 仅在用户明确查询仓库默认分支时使用，不能用其结果静默代替父分支确认。
|
|
97
|
-
|
|
98
|
-
两个分支均确定后，按去除 `refs/heads/` 前缀后的规范分支名比较；若相同，拒绝创建并要求用户修正，不能仅依赖 MCP 校验。
|
|
99
|
-
|
|
100
|
-
### 4. 确认 PR 描述
|
|
101
|
-
|
|
102
|
-
用户已手动提供 `prDescription` 时，保留其原文并视为用户明确选择；最终创建确认仍需在该描述已确定后进行。
|
|
103
|
-
|
|
104
|
-
用户未提供时，只有在两个分支均已确认后才执行以下读取：
|
|
105
|
-
|
|
106
|
-
1. 调用 `code-mcp-pr.get_branch_diff`，固定以携带变更的分支为 source、接收合并的分支为 target：
|
|
102
|
+
随后调用 `code-mcp-pr.read_file_at_ref` 读取当前分支根目录的 `spec.md`：
|
|
107
103
|
|
|
108
104
|
```yaml
|
|
109
105
|
orgName: ${orgName}
|
|
110
106
|
projectName: ${projectName}
|
|
111
107
|
repoId: ${repoId}
|
|
112
|
-
|
|
113
|
-
targetBranch: ${sourceBranch}
|
|
114
|
-
```
|
|
115
|
-
|
|
116
|
-
2. 调用 `code-mcp-pr.read_file_at_ref` 读取变更分支根目录的 `spec.md`：
|
|
117
|
-
|
|
118
|
-
```yaml
|
|
119
|
-
orgName: ${orgName}
|
|
120
|
-
projectName: ${projectName}
|
|
121
|
-
repoId: ${repoId}
|
|
122
|
-
refName: ${targetBranch}
|
|
108
|
+
refName: ${fromBranch}
|
|
123
109
|
filePath: spec.md
|
|
124
110
|
```
|
|
125
111
|
|
|
126
|
-
|
|
127
|
-
4. 当前 LLM 使用原始 `diffFiles`、`diffShortText` 和 `specMdContent` 生成描述；MCP 只负责读取材料，不承担总结。
|
|
112
|
+
文件不存在时继续。其他读取错误保留错误事实，但只要 diff 可用就继续生成描述。diff 失败时报告 MCP 的 `errorMsg`，不要基于猜测创建 PR。
|
|
128
113
|
|
|
129
|
-
|
|
114
|
+
用户未给标题时，先读取：
|
|
115
|
+
|
|
116
|
+
```bash
|
|
117
|
+
git log --no-merges -1 --format=%s -- "${fromBranch}"
|
|
118
|
+
```
|
|
130
119
|
|
|
131
|
-
|
|
132
|
-
- `specMdContent` 为空时，仅根据 diff 按文件维度说明修改内容。
|
|
133
|
-
- 使用简洁、面向评审人的 Markdown；开头是短概述，详情只用 `- ` 无序列表。
|
|
134
|
-
- 不粘贴大段原始 diff，不声称材料中无法证明的行为。diff 被截断时只总结可见材料，不推测缺失部分。
|
|
120
|
+
用最新提交标题作为基础；仅在它为空或明显无意义时，根据分支名、`spec.md` 和 diff 生成简洁标题。不要为标题单独询问用户。
|
|
135
121
|
|
|
136
|
-
|
|
122
|
+
用户未给描述时，根据 `spec.md` 和 diff 生成面向评审人的 Markdown：
|
|
137
123
|
|
|
138
124
|
```markdown
|
|
139
125
|
## 变更概述
|
|
140
|
-
|
|
126
|
+
一句话说明本次改动。
|
|
141
127
|
|
|
142
128
|
## 变更详情
|
|
143
|
-
- `path/to/file
|
|
144
|
-
- `path/to/file`：修复 xx 问题。
|
|
129
|
+
- `path/to/file`：说明可由材料证明的改动。
|
|
145
130
|
```
|
|
146
131
|
|
|
147
|
-
|
|
132
|
+
只总结可见材料，不粘贴大段 diff，不补造功能。用户提供标题或描述时保留其原意，不擅自替换。
|
|
148
133
|
|
|
149
|
-
|
|
134
|
+
## 创建授权
|
|
150
135
|
|
|
151
|
-
|
|
136
|
+
如果用户本次请求明确包含“创建 PR”“提交 PR”“提 PR”等写操作意图，该请求本身就是创建授权。完成自动发现和内容生成后直接创建，不再逐项确认分支、描述或重复询问最终授权。
|
|
152
137
|
|
|
153
|
-
|
|
138
|
+
如果用户只要求“准备”“生成”“预览”PR，则展示以下简洁预览并停止，不调用创建工具：
|
|
154
139
|
|
|
155
|
-
|
|
140
|
+
```text
|
|
141
|
+
PR: ${fromBranch} -> ${toBranch}
|
|
142
|
+
标题：${prTitle}
|
|
143
|
+
描述：${prDescription}
|
|
144
|
+
```
|
|
156
145
|
|
|
157
|
-
|
|
158
|
-
> PR 源（携带变更）：${targetBranch}
|
|
159
|
-
> PR 目标（合并进入）：${sourceBranch}
|
|
160
|
-
> PR 标题：${prTitle}
|
|
161
|
-
> 是否确认调用 MCP 工具 code-mcp-pr 创建 Azure DevOps PR？
|
|
146
|
+
如果用户的表达无法判断是创建还是预览，只询问这一项，不重新询问已自动发现的数据。
|
|
162
147
|
|
|
163
|
-
|
|
148
|
+
创建前检查当前工作区：
|
|
164
149
|
|
|
165
|
-
|
|
150
|
+
```bash
|
|
151
|
+
git status --short
|
|
152
|
+
git ls-remote --exit-code origin "refs/heads/${fromBranch}"
|
|
153
|
+
```
|
|
166
154
|
|
|
167
|
-
|
|
155
|
+
未提交改动不会包含在 PR 中，发现时明确告知并停止创建。远端不存在 `fromBranch` 时告知需要先推送；Skill 不自行 push。
|
|
168
156
|
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
157
|
+
## 创建与通知
|
|
158
|
+
|
|
159
|
+
根据最终描述提炼 3 至 5 条钉钉变更要点，保留字面量 `{{PR_WEB_URL}}`：
|
|
172
160
|
|
|
173
161
|
```markdown
|
|
174
162
|
**PR 标题：${prTitle}**
|
|
175
163
|
|
|
176
164
|
PR 链接：[{{PR_WEB_URL}}]({{PR_WEB_URL}})
|
|
177
165
|
|
|
178
|
-
分支流向：${
|
|
166
|
+
分支流向：${fromBranch} -> ${toBranch}
|
|
179
167
|
|
|
180
168
|
变更要点：
|
|
181
169
|
|
|
182
170
|
- 要点 1
|
|
183
171
|
- 要点 2
|
|
184
|
-
- 要点 3
|
|
185
172
|
```
|
|
186
173
|
|
|
187
|
-
|
|
174
|
+
调用一次 `code-mcp-pr.code-mcp-pr`。MCP 的业务字段名与普通 Git 术语不同，严格按以下映射，不向用户展示该内部差异：
|
|
188
175
|
|
|
189
176
|
```yaml
|
|
190
177
|
orgName: ${orgName}
|
|
191
178
|
projectName: ${projectName}
|
|
192
179
|
repoId: ${repoId}
|
|
193
|
-
businessTargetBranch: ${
|
|
194
|
-
businessSourceBranch: ${
|
|
180
|
+
businessTargetBranch: ${fromBranch}
|
|
181
|
+
businessSourceBranch: ${toBranch}
|
|
195
182
|
prTitle: ${prTitle}
|
|
196
183
|
prDescription: ${prDescription}
|
|
197
184
|
reviewers: ${reviewers}
|
|
198
|
-
dingtalkMarkdownTitle: "
|
|
199
|
-
dingtalkMarkdownContent: ${
|
|
185
|
+
dingtalkMarkdownTitle: "ADO PR 已创建"
|
|
186
|
+
dingtalkMarkdownContent: ${markdownWithLiteralPrWebUrlPlaceholder}
|
|
200
187
|
```
|
|
201
188
|
|
|
202
|
-
`reviewers`
|
|
203
|
-
|
|
204
|
-
## MCP 返回处理
|
|
189
|
+
`reviewers` 未提供时省略。创建工具非幂等：调用中断或响应不明确时不自动重试，先查询或请用户核查是否已经创建。
|
|
205
190
|
|
|
206
|
-
|
|
191
|
+
## 返回结果
|
|
207
192
|
|
|
208
|
-
|
|
193
|
+
成功时简洁输出：
|
|
209
194
|
|
|
210
195
|
```text
|
|
211
|
-
|
|
212
|
-
|
|
213
|
-
|
|
214
|
-
|
|
215
|
-
${dingtalkSendSuccess === true ? "✅ 已推送通知至钉钉群" : "⚠️ PR 创建成功，但钉钉群通知发送失败，请检查环境变量 DINGDING_ALERT_TOKEN"}
|
|
196
|
+
PR 创建成功
|
|
197
|
+
${fromBranch} -> ${toBranch}
|
|
198
|
+
${prWebUrl}
|
|
199
|
+
钉钉通知：已发送 | 发送失败 | 已跳过
|
|
216
200
|
```
|
|
217
201
|
|
|
218
|
-
`dingtalkSendSuccess`
|
|
219
|
-
|
|
220
|
-
### 创建失败
|
|
221
|
-
|
|
222
|
-
当 `success=false`，根据 `errorMsg` 中的状态码和资源信息转为自然语言，并附上不会发送钉钉通知：
|
|
202
|
+
`dingtalkSendSuccess=true` 表示已发送，`false` 表示失败，`null` 表示未请求通知；不要把 `null` 说成发送失败。
|
|
223
203
|
|
|
224
|
-
|
|
225
|
-
- `404` 且指向仓库：请检查 `projectName`、`repoId` 是否正确。
|
|
226
|
-
- `404` 且指向分支/ref：分支不存在，请核对分支名。
|
|
227
|
-
- `404` 且指向文件：文件读取失败；自动描述阶段的 `spec.md` 正常不存在应由 `fileExists=false` 表示，不归入此错误。
|
|
228
|
-
- 其他错误：保留原始 `errorMsg`，不要臆测原因。
|
|
229
|
-
|
|
230
|
-
输出格式：
|
|
231
|
-
|
|
232
|
-
```text
|
|
233
|
-
❌ PR 创建失败
|
|
234
|
-
${friendlyError}
|
|
235
|
-
PR 创建失败不会触发钉钉通知。
|
|
236
|
-
```
|
|
204
|
+
失败时保留 `errorMsg` 的关键信息并说明 PR 未创建、钉钉未触发。钉钉失败不改变 PR 创建成功状态。
|
|
237
205
|
|
|
238
|
-
##
|
|
206
|
+
## 完成条件
|
|
239
207
|
|
|
240
|
-
|
|
208
|
+
结束前确认：用户值覆盖自动值；仓库信息来自当前项目；`fromBranch` 是当前或用户指定的开发分支；`toBranch` 是可解释的父分支；远端已有源分支；描述由实际材料支持；MCP 映射为 `businessTargetBranch=fromBranch`、`businessSourceBranch=toBranch`；创建结果与钉钉状态准确呈现。
|
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Code PR Submit"
|
|
3
|
-
short_description: "
|
|
4
|
-
default_prompt: "使用 $code-pr-submit
|
|
3
|
+
short_description: "从当前 Git 项目自动创建 Azure DevOps PR"
|
|
4
|
+
default_prompt: "使用 $code-pr-submit 自动读取当前项目和分支，创建合并到父分支的 Azure DevOps PR。"
|