agiledev-cli 0.1.4 → 0.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.
- package/README.md +300 -173
- package/SKILL.md +114 -98
- package/adev.js +1319 -1285
- package/autofix/agents/antigravity.js +379 -0
- package/autofix/agents/claude.js +147 -0
- package/autofix/agents/codex.js +179 -0
- package/autofix/agents/exec.js +230 -0
- package/autofix/agents/index.js +400 -0
- package/autofix/agents/opencode.js +233 -0
- package/autofix/agents/pi.js +247 -0
- package/autofix/agiledev.js +98 -0
- package/autofix/bridge.js +371 -0
- package/autofix/cli.js +712 -0
- package/autofix/context.js +152 -0
- package/autofix/conversation.js +302 -0
- package/autofix/coordinator.js +2892 -0
- package/autofix/git.js +459 -0
- package/autofix/policy.js +230 -0
- package/autofix/profile.js +578 -0
- package/autofix/public/app.js +3668 -0
- package/autofix/public/i18n-id.js +282 -0
- package/autofix/public/index.html +32 -0
- package/autofix/public/style.css +2463 -0
- package/autofix/queue.js +146 -0
- package/autofix/scheduler.js +994 -0
- package/autofix/scope.js +32 -0
- package/autofix/service.js +1940 -0
- package/autofix/store.js +375 -0
- package/autofix/workspace.js +298 -0
- package/autofix/worktree.js +379 -0
- package/docs/autofix-design.md +801 -0
- package/docs/autofix-profiles.example.json +65 -0
- package/imgs/Bug/350/247/243/345/206/263/345/244/207/346/263/250.png +0 -0
- package/imgs/logo.png +0 -0
- package/imgs//344/277/256/346/224/271Bug/347/212/266/346/200/201.png +0 -0
- package/imgs//345/270/256/346/210/221/344/277/256/345/244/215Bug-20260922-010.png +0 -0
- package/imgs//346/237/245/347/234/213/345/271/266/345/210/206/346/236/220/351/234/200/346/261/202/346/226/207/346/241/243.png +0 -0
- package/imgs//347/234/213/344/270/200/344/270/213/346/210/221/347/216/260/345/234/250/346/234/211/345/223/252/344/272/233/345/274/200/345/217/221/344/273/273/345/212/241.png +0 -0
- package/imgs//347/234/213/344/270/200/344/270/213/346/210/221/350/277/230/346/234/211/345/223/252/344/272/233Bug/346/234/252/350/247/243/345/206/263.png +0 -0
- package/package.json +39 -36
package/README.md
CHANGED
|
@@ -1,173 +1,300 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
|
|
3
|
-
<img src="logo.
|
|
4
|
-
|
|
5
|
-
# AgileDev-Cli
|
|
6
|
-
|
|
7
|
-
**AgileDev 敏捷研发管理系统的命令行工具**
|
|
8
|
-
|
|
9
|
-
不用打开网页,终端一条命令搞定:提 bug · 修 bug · 提需求 · 看迭代 · 设提测 · 查知识库 · 发周报,也可以直接对 AI 说人话 🗣️
|
|
10
|
-
|
|
11
|
-
[](https://nodejs.org)
|
|
12
|
-
[](LICENSE)
|
|
13
|
-
[]()
|
|
14
|
-
[]()
|
|
15
|
-
|
|
16
|
-
面向所有角色:**开发 · 测试 · 产品**,不需要懂编程 ✨
|
|
17
|
-
|
|
18
|
-
</div>
|
|
19
|
-
|
|
20
|
-
---
|
|
21
|
-
|
|
22
|
-
## 📦 安装
|
|
23
|
-
|
|
24
|
-
前提:电脑装有 [Node.js](https://nodejs.org) 18 或更高版本(下载 LTS 版一路下一步即可;不确定的话找身边开发同事帮忙装一次)。
|
|
25
|
-
|
|
26
|
-
```bash
|
|
27
|
-
npm install -g agiledev-cli
|
|
28
|
-
```
|
|
29
|
-
|
|
30
|
-
如果你打算让 AI 助手(ZCode 等)直接操作敏捷系统,再执行一步,把 Skill 装到本机:
|
|
31
|
-
|
|
32
|
-
```bash
|
|
33
|
-
adev setup
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
## 🔐 登录
|
|
37
|
-
|
|
38
|
-
登录方式有两种,选其中任何一种都可以。
|
|
39
|
-
|
|
40
|
-
### 方式一:通过账号密码
|
|
41
|
-
|
|
42
|
-
在终端输入 `adev login`,或者跟 AI 说「登录敏捷系统」,然后按提示输入账号和密码。就是登录敏捷系统(scrum.chitem.com)用的那个账号。输入密码时屏幕不会显示任何字符,正常输完回车即可。
|
|
43
|
-
|
|
44
|
-
```bash
|
|
45
|
-
adev login
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
### 方式二:使用 API Key(长期使用推荐)
|
|
49
|
-
|
|
50
|
-
- 在网页打开敏捷系统并登录
|
|
51
|
-
- 右上角点击用户名称 → **API 密钥** → **新建 API Key**
|
|
52
|
-
- 名称:可以随便写,例如 `AgileDev-Cli`
|
|
53
|
-
- 过期时间:可以留空,推荐填个时间
|
|
54
|
-
- 权限:将需要用到的功能勾选上
|
|
55
|
-
- 创建好 API Key 后复制下来,然后在命令行执行:
|
|
56
|
-
|
|
57
|
-
```bash
|
|
58
|
-
adev config set-token 你的ApiKey
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
> 📌 凭证统一保存在用户目录的 `~/.agiledev-cli.json`(含密钥,⚠️ 不要提交到任何仓库或聊天中);Key 的权限在平台上按模块分配,写操作需要对应模块的写权限。两种方式后配置的生效,随时可以换。
|
|
62
|
-
|
|
63
|
-
## 🚀 使用
|
|
64
|
-
|
|
65
|
-
### 🤖 直接和 AI 说
|
|
66
|
-
|
|
67
|
-
安装时已通过 `adev setup` 装好 Skill 的话,就可以直接说人话了:
|
|
68
|
-
|
|
69
|
-
- 💬 「帮我登录敏捷系统」
|
|
70
|
-
- 💬
|
|
71
|
-
- 💬
|
|
72
|
-
- 💬
|
|
73
|
-
- 💬
|
|
74
|
-
- 💬
|
|
75
|
-
- 💬
|
|
76
|
-
- 💬
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
adev bugs
|
|
128
|
-
adev
|
|
129
|
-
adev
|
|
130
|
-
adev
|
|
131
|
-
|
|
132
|
-
adev
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
```
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
<img src="imgs/logo.png" alt="AgileDev CLI" width="120"/>
|
|
4
|
+
|
|
5
|
+
# AgileDev-Cli
|
|
6
|
+
|
|
7
|
+
**AgileDev 敏捷研发管理系统的命令行工具**
|
|
8
|
+
|
|
9
|
+
不用打开网页,终端一条命令搞定:提 bug · 修 bug · 提需求 · 看迭代 · 设提测 · 查知识库 · 发周报,也可以直接对 AI 说人话 🗣️
|
|
10
|
+
|
|
11
|
+
[](https://nodejs.org)
|
|
12
|
+
[](LICENSE)
|
|
13
|
+
[]()
|
|
14
|
+
[]()
|
|
15
|
+
|
|
16
|
+
面向所有角色:**开发 · 测试 · 产品**,不需要懂编程 ✨
|
|
17
|
+
|
|
18
|
+
</div>
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 📦 安装
|
|
23
|
+
|
|
24
|
+
前提:电脑装有 [Node.js](https://nodejs.org) 18 或更高版本(下载 LTS 版一路下一步即可;不确定的话找身边开发同事帮忙装一次)。
|
|
25
|
+
|
|
26
|
+
```bash
|
|
27
|
+
npm install -g agiledev-cli
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
如果你打算让 AI 助手(ZCode 等)直接操作敏捷系统,再执行一步,把 Skill 装到本机:
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
adev setup
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
## 🔐 登录
|
|
37
|
+
|
|
38
|
+
登录方式有两种,选其中任何一种都可以。
|
|
39
|
+
|
|
40
|
+
### 方式一:通过账号密码
|
|
41
|
+
|
|
42
|
+
在终端输入 `adev login`,或者跟 AI 说「登录敏捷系统」,然后按提示输入账号和密码。就是登录敏捷系统(scrum.chitem.com)用的那个账号。输入密码时屏幕不会显示任何字符,正常输完回车即可。
|
|
43
|
+
|
|
44
|
+
```bash
|
|
45
|
+
adev login
|
|
46
|
+
```
|
|
47
|
+
|
|
48
|
+
### 方式二:使用 API Key(长期使用推荐)
|
|
49
|
+
|
|
50
|
+
- 在网页打开敏捷系统并登录
|
|
51
|
+
- 右上角点击用户名称 → **API 密钥** → **新建 API Key**
|
|
52
|
+
- 名称:可以随便写,例如 `AgileDev-Cli`
|
|
53
|
+
- 过期时间:可以留空,推荐填个时间
|
|
54
|
+
- 权限:将需要用到的功能勾选上
|
|
55
|
+
- 创建好 API Key 后复制下来,然后在命令行执行:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
adev config set-token 你的ApiKey
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
> 📌 凭证统一保存在用户目录的 `~/.agiledev-cli.json`(含密钥,⚠️ 不要提交到任何仓库或聊天中);Key 的权限在平台上按模块分配,写操作需要对应模块的写权限。两种方式后配置的生效,随时可以换。
|
|
62
|
+
|
|
63
|
+
## 🚀 使用
|
|
64
|
+
|
|
65
|
+
### 🤖 直接和 AI 说
|
|
66
|
+
|
|
67
|
+
安装时已通过 `adev setup` 装好 Skill 的话,就可以直接说人话了:
|
|
68
|
+
|
|
69
|
+
- 💬 「帮我登录敏捷系统」
|
|
70
|
+
- 💬 「敏捷系统里有哪些项目」
|
|
71
|
+
- 💬 「我的工作台上有什么待办」
|
|
72
|
+
- 💬 「看看测试今天提了哪些 bug」
|
|
73
|
+
- 💬 「看一下我还有哪些 bug 未解决」
|
|
74
|
+
- 💬 「BUG-20260922-011」← 只发编号:AI 会查出来给你看,并**询问**你要不要修,不会擅自动手
|
|
75
|
+
- 💬 「帮我修复 BUG-20260922-011」← 明确说了修复才会开始:看详情和截图 → 改代码 → 转待验证
|
|
76
|
+
- 💬 「登记一个 bug:销售订单导出没反应,P2」← 把现象说清楚,AI 会帮你把表单信息组好
|
|
77
|
+
- 💬 「BUG-20260922-008 验证不通过,打回」
|
|
78
|
+
- 💬 「在 BUG-20260922-011 上加个评论:已安排下版本处理」
|
|
79
|
+
- 💬 「创建一个需求:销售统计增加欠款金额字段」
|
|
80
|
+
- 💬 「给需求 401 设置 10 月 1 号提测」
|
|
81
|
+
- 💬 「需求 401 先暂缓」
|
|
82
|
+
- 💬 「看一下我现在有哪些开发任务」
|
|
83
|
+
- 💬 「把这个需求拆成开发任务」← AI 读需求内容,拆成任务清单批量创建
|
|
84
|
+
- 💬 「迭代 103 启动开发」
|
|
85
|
+
- 💬 「看看最近的线上故障」
|
|
86
|
+
- 💬 「知识库里有哪些文档」
|
|
87
|
+
- 💬 「查看并分析知识库中的 V1.1.3 需求文档」
|
|
88
|
+
- 💬 「看看我的周报提交了没」
|
|
89
|
+
|
|
90
|
+
#### 📸 实际效果
|
|
91
|
+
|
|
92
|
+
**说「帮我修复 BUG-20260922-010」,AI 完成修复闭环(定位根因 → 改代码 → 敏捷系统流转"待验证"):**
|
|
93
|
+
|
|
94
|
+

|
|
95
|
+
|
|
96
|
+
**说「看一下我还有哪些 bug 未解决」,AI 给出分组统计和下一步建议:**
|
|
97
|
+
|
|
98
|
+

|
|
99
|
+
|
|
100
|
+
**说「看一下我现在有哪些开发任务」,AI 结合当前迭代给出实际待办:**
|
|
101
|
+
|
|
102
|
+

|
|
103
|
+
|
|
104
|
+
**说「BUG-20260923-003 改好了,修改状态」,AI 完成状态流转并说明标准流程:**
|
|
105
|
+
|
|
106
|
+

|
|
107
|
+
|
|
108
|
+
**修复说明和评论自动写回敏捷系统:**
|
|
109
|
+
|
|
110
|
+

|
|
111
|
+
|
|
112
|
+
**查看并分析知识库中的需求文档:**
|
|
113
|
+
|
|
114
|
+

|
|
115
|
+
|
|
116
|
+
### ⌨️ 使用 CLI
|
|
117
|
+
|
|
118
|
+
以下命令都可以直接复制执行,把引号里的内容换成你自己的。忘了命令怎么写就执行 `adev --help`。
|
|
119
|
+
|
|
120
|
+
#### 🔍 查询(所有人)
|
|
121
|
+
|
|
122
|
+
```bash
|
|
123
|
+
adev projects # 有哪些项目(记住项目名,后面都能用名字代替 id)
|
|
124
|
+
adev dashboard # 我的工作台:待办、即将到期、今日完成
|
|
125
|
+
adev bugs list --status Pending # 待处理的 bug
|
|
126
|
+
adev bugs list --mine # 分配给我的(加 --status ToVerify 看待我验证的)
|
|
127
|
+
adev bugs show BUG-20260922-011 # 看某个 bug 的详情和截图(直接用编号)
|
|
128
|
+
adev reqs list --status 开发中 # 开发中的需求
|
|
129
|
+
adev reqs show 401 # 需求详情(支持 REQ-xxx 编号)
|
|
130
|
+
adev versions list # 版本迭代列表
|
|
131
|
+
adev kb list # 知识库文档列表;adev kb show <id> 看正文
|
|
132
|
+
adev weekly list --mine # 我的周报
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
#### 🧪 测试同学
|
|
136
|
+
|
|
137
|
+
```bash
|
|
138
|
+
# 登记缺陷(不用打开网页填表单)
|
|
139
|
+
adev bugs create --title "销售订单-导出按钮点击无反应" --project 海外线下零售 --severity P2 --data '{"actual_behavior":"点导出后无任何反应,复现步骤:订单列表→勾选→导出"}'
|
|
140
|
+
|
|
141
|
+
# 级别说明:P0 阻塞 / P1 严重 / P2 一般 / P3 建议
|
|
142
|
+
# 项目名写关键词即可(如"海外线下零售"),不必写全称
|
|
143
|
+
|
|
144
|
+
adev bugs comment BUG-20260922-011 --content "已复现,和 BUG-20260922-008 是同一个问题" # 补充评论
|
|
145
|
+
adev bugs reopen BUG-20260922-008 --notes "验证不通过,问题依旧" # 验证不通过时打回
|
|
146
|
+
adev reqs set-test-date 401 --date 2026-10-01 # 设置需求提测时间
|
|
147
|
+
adev tests list --project 海外线下零售 # 查看测试计划
|
|
148
|
+
```
|
|
149
|
+
|
|
150
|
+
#### 📋 产品同学
|
|
151
|
+
|
|
152
|
+
```bash
|
|
153
|
+
# 创建需求
|
|
154
|
+
adev reqs create --title "销售统计增加欠款金额字段" --project 海外线下零售 --data '{"type":"新功能","description":"销售统计列表增加当前欠款金额列"}'
|
|
155
|
+
# 类型:新功能 / 优化 / 技术债 / Bug修复
|
|
156
|
+
|
|
157
|
+
adev reqs list --status 待处理 # 跟踪各状态需求:待处理/已准入/开发中/已发布/暂缓
|
|
158
|
+
adev reqs data-sources 401 # 查看/维护需求的数据源对接清单
|
|
159
|
+
adev versions list # 看各迭代的进度和排期
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
#### 💻 开发同学
|
|
163
|
+
|
|
164
|
+
```bash
|
|
165
|
+
adev bugs list --status Pending --mine # 今天要修的 bug
|
|
166
|
+
adev bugs claim BUG-20260922-011 # 认领
|
|
167
|
+
adev bugs resolve BUG-20260922-011 --notes "本位币取值字段写反,已修正" # 修复完成,转待验证
|
|
168
|
+
adev bugs reject BUG-20260922-011 --reason "与 BUG-20260922-008 重复" # 拒绝重复/无效缺陷
|
|
169
|
+
|
|
170
|
+
adev tasks list --mine # 我的开发任务
|
|
171
|
+
adev tasks create --title "订单导出接口优化" --project 海外线下零售 --assignee me
|
|
172
|
+
adev versions start 103 # 迭代启动开发(另有 start-testing/complete/accept/release)
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## 🤖 自动巡检修复(`adev autofix`)
|
|
176
|
+
|
|
177
|
+
在**要修复代码的仓库目录**里执行一条命令即可,不需要参数:
|
|
178
|
+
|
|
179
|
+
```bash
|
|
180
|
+
cd D:\Project\your-repo
|
|
181
|
+
adev autofix
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
它会先打开本机控制台 `http://127.0.0.1:3210/`,**不会立刻拉取缺陷**。在页面上完成配置后点击「启动自动修复」:
|
|
185
|
+
|
|
186
|
+
- 分别选择主 Agent 与修复 Agent(Claude Code / OpenCode / Antigravity / Codex / Pi,仅显示本机已安装的),可以给两者分配不同的大模型
|
|
187
|
+
- 从敏捷系统拉取项目列表并多选;仓库指纹匹配到的项目会标为「推荐」
|
|
188
|
+
- 确认一次「Agent 以最大权限在本机运行」,设置轮询间隔、验证命令(`npm test` 等)与自动验证策略
|
|
189
|
+
- 启动后进入三栏控制台:左侧主 Agent 卡片 + Bug 列表,中间实时 Agent 会话,右侧缺陷详情与待决问题;Bug 状态随修复进度实时更新
|
|
190
|
+
- 只想先看看:可选「仅观察,不拉取」,或在运行后通过顶部提示条绑定项目
|
|
191
|
+
|
|
192
|
+
页面会预填上次保存的 Agent / 模型 / 项目 / 验证命令 / 工作树隔离方式;同目录再次运行 `adev autofix` 会直接打开已运行的控制台。需要在脚本或 CI 中跳过人工点击时加 `--yes`。
|
|
193
|
+
|
|
194
|
+
### 工作区配置档(Profile)
|
|
195
|
+
|
|
196
|
+
一个敏捷项目常常横跨**前端 / 后端 / 移动端多个仓库**。用配置档把「项目 ↔ 仓库 ↔ 分支 ↔ 巡检时段 ↔ 复核阈值」一次说清楚,修复 Agent 就不会改错仓库:
|
|
197
|
+
|
|
198
|
+
```jsonc
|
|
199
|
+
// D:\Project\your-repo\.autofix.json
|
|
200
|
+
{
|
|
201
|
+
"version": 1,
|
|
202
|
+
"profiles": {
|
|
203
|
+
"myapp": {
|
|
204
|
+
"label": "我的项目",
|
|
205
|
+
"projectIds": ["36"],
|
|
206
|
+
"root": "D:\\Project\\your-repo",
|
|
207
|
+
"repos": [
|
|
208
|
+
{ "name": "web", "path": "web", "role": "frontend",
|
|
209
|
+
"branch": "feature/x", "testBranch": "test", "verify": ["npm run lint"] },
|
|
210
|
+
{ "name": "api", "path": "api", "role": "backend",
|
|
211
|
+
"branch": "feature/x", "testBranch": "test" }
|
|
212
|
+
],
|
|
213
|
+
"schedule": { "workdaysOnly": true, "from": "09:30", "to": "18:30" },
|
|
214
|
+
"review": { "fileThreshold": 6 }
|
|
215
|
+
}
|
|
216
|
+
}
|
|
217
|
+
}
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
```bash
|
|
221
|
+
adev autofix profiles # 列出本机可见的配置档及其仓库结构
|
|
222
|
+
adev autofix --profile myapp # 显式指定用哪个档
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
- 目录命中某个档时自动使用它;`--profile` 找不到会直接报错,不会静默回退
|
|
226
|
+
- 巡检时段外**只跳过检测**,任务记录一条不删,到下一个时段自动恢复
|
|
227
|
+
- 完整字段说明见 [docs/autofix-design.md](docs/autofix-design.md#25-工作区配置档profile),示例见 [docs/autofix-profiles.example.json](docs/autofix-profiles.example.json)
|
|
228
|
+
|
|
229
|
+
### 修复闭环
|
|
230
|
+
|
|
231
|
+
- 只处理分配给你、状态为 `Pending` / `Reopened` 的缺陷,按 P1 → P3 排序
|
|
232
|
+
- **缺陷上下文自动装载**:复现步骤、预期/实际行为、截图与评论由调度器拉好再交给修复 Agent,不靠主 Agent 转述
|
|
233
|
+
- 修复后跑独立验证命令(按实际改动的仓库分别跑)
|
|
234
|
+
- **分级复核**:文案/单文件小改免复核;核心业务逻辑、系统底层、改动 ≥6 个文件或跨前后端时,先派一个**只读复核 Agent** 看实际 diff,给出 PASS / ISSUES
|
|
235
|
+
- 复核通过后自动 `commit` → 合并测试分支 → `push` → 切回开发分支,并把缺陷转为待验证(未开启 `--auto-verify` 时先问你)
|
|
236
|
+
- 交付后会在缺陷下留一条「验证要点」评论给测试同学
|
|
237
|
+
- 验证不过、合并冲突、业务取舍不明确时**转人工**,控制台上每个阻塞都有可点按钮,不会自作主张
|
|
238
|
+
- **确定性调度**:优先级(严重度 → 返工次数 → 等待时长)、空闲槽位、范围冲突由调度器先算好,主 Agent 可调用 `get_dispatch_plan` 直接采纳;主 Agent 卡住时自动兜底派工
|
|
239
|
+
- **任务级工作树隔离**:每个缺陷在自己的 `git worktree` 与 `autofix/<任务号>` 分支里修改、验证、提交,多个任务可以真正并行;交付后清理目录但保留分支。默认对 Git 仓库开启,启动页「运行设置 → 工作树隔离」可选自动 / 始终开启 / 关闭,命令行 `--worktree` / `--no-worktree` 可强制开关
|
|
240
|
+
- **验证红线**:`npm run build`、`vite build`、`tsc`、`vue-tsc`、`type-check` 等编译/类型检查命令一律拦截,不会执行也不会被当成验证通过
|
|
241
|
+
|
|
242
|
+
> 安全边界不变:只在本工作区内改代码;不部署、不发布、不关闭缺陷;合并冲突即停并保留现场。
|
|
243
|
+
|
|
244
|
+
常用子命令(服务运行时):
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
adev autofix status # 看状态、任务统计与待你决定的问题
|
|
248
|
+
adev autofix profiles # 列出工作区配置档
|
|
249
|
+
adev autofix pause / resume # 暂停 / 恢复轮询与派工
|
|
250
|
+
adev autofix say "先修订单导出的 P1" # 给主 Agent 下指令
|
|
251
|
+
adev autofix answer ask_01 "方案 A" # 回答控制台里的待决问题
|
|
252
|
+
adev autofix retry BUG-20260922-011 # 人工确认后重新排队
|
|
253
|
+
adev autofix config --interval 120 # 改全局默认(轮询间隔、模型、Agent)
|
|
254
|
+
adev autofix stop # 停止(任务记录保留)
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
数据都在 `~/.agiledev-autofix/`(任务、事件、会话、截图),全局默认在 `~/.agiledev-autofix.json`。完整设计与安全边界见 [docs/autofix-design.md](docs/autofix-design.md)。
|
|
258
|
+
|
|
259
|
+
## ❓ 常见问题
|
|
260
|
+
|
|
261
|
+
| 现象 | 处理 |
|
|
262
|
+
|---|---|
|
|
263
|
+
| 提示"登录已过期" | 重新 `adev login`(账号已记住,回车后只输密码) |
|
|
264
|
+
| 提示"登录失败:用户名或密码错误" | 账号即网页登录账号,确认后重试;忘记密码找管理员重置 |
|
|
265
|
+
| 提示 code=40300 无权限 | 你的账号/凭证没有该模块权限,找系统管理员分配 |
|
|
266
|
+
| 网络请求失败 | 本工具直连公司内网,请确认在办公网络或已连 VPN |
|
|
267
|
+
| 表格文字被截断 | 加 `--json` 查看完整数据,或用 `show` 看单条 |
|
|
268
|
+
| 忘记命令 | `adev --help` 查看全部用法 |
|
|
269
|
+
| autofix 提示"未找到可用的 Agent CLI" | 装 Claude Code(`claude`)、OpenCode(`opencode`)、Antigravity(`agy`)、Codex(`codex`)或 Pi(`pi`)并确认在 PATH 里 |
|
|
270
|
+
| autofix 页面项目列表为空 | 检查登录与网络后点「重新检测」;也可用 `adev autofix --project <id>` 预选 |
|
|
271
|
+
| autofix 一直"观察模式" | 说明还没绑定项目:在顶部提示条点「绑定项目」,或停止后重新配置 |
|
|
272
|
+
| autofix 提示"AgileDev 登录已失效" | 先在终端 `adev login`,再在页面点「重新检测」 |
|
|
273
|
+
|
|
274
|
+
## ⚙️ 进阶:脚本与集成
|
|
275
|
+
|
|
276
|
+
- 所有查询命令支持 `--json` 输出原始 JSON;所有写操作支持 `--data '<json>'` / `--json-file <path>` 透传完整请求体
|
|
277
|
+
- 环境变量 `ADEV_BASE_URL` / `ADEV_TOKEN` 可覆盖配置,适合 CI 场景
|
|
278
|
+
- 配置读取顺序:环境变量 > `~/.agiledev-cli.json` > `./adev.config.json`
|
|
279
|
+
|
|
280
|
+
## 🛠️ 开发与扩展(面向维护者)
|
|
281
|
+
|
|
282
|
+
```bash
|
|
283
|
+
git clone <本仓库> && cd agiledev-cli
|
|
284
|
+
npm install -g . # 本地安装调试
|
|
285
|
+
npm test # 回归测试(node --test)
|
|
286
|
+
```
|
|
287
|
+
|
|
288
|
+
- 单文件 `adev.js`,按资源模块化:接入新接口时在浏览器 F12 → Network 找到 `/api/v1/...` 请求,仿照现有资源增加 handler 与分发,并更新 `SKILL.md`
|
|
289
|
+
- `autofix/` 是自动修复子系统(调度器、协调器、Agent 适配、MCP 桥、控制台),测试在 `test/autofix.test.mjs`
|
|
290
|
+
- 🐞 Bug 状态:`Pending 待处理 / InProgress 处理中 / ToVerify 待验证 / Reopened 重新打开 / Rejected 已拒绝 / Closed 已关闭`(故障另有 `Released 已发布`);解决方案:`fixed / wontfix / duplicate / cannot_reproduce / by_design / later`
|
|
291
|
+
- 📝 需求状态(中文值):`待处理 / 已准入 / 开发中 / 已发布 / 已拒绝 / 暂缓`;任务状态(中文值):`待开始 / 开发中 / 已暂停 / 已完成 / 不处理`
|
|
292
|
+
- 📦 发布:包托管在 GitHub Packages(`@anyaoqi/agiledev-cli`),发布用 `npm publish`(需 `write:packages` 权限的 GitHub 令牌)
|
|
293
|
+
|
|
294
|
+
---
|
|
295
|
+
|
|
296
|
+
<div align="center">
|
|
297
|
+
|
|
298
|
+
用得顺手的话,给项目点个 ⭐ 吧 🎉
|
|
299
|
+
|
|
300
|
+
</div>
|