ai-engineering-init 1.12.0 → 1.12.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.
|
@@ -23,7 +23,20 @@ tools: Read, Bash, Grep, Glob, Agent
|
|
|
23
23
|
|
|
24
24
|
根据用户提供的输入类型，调用对应的 Haiku 层 Agent：
|
|
25
25
|
|
|
26
|
-
**有 Axure
|
|
26
|
+
**有 Axure 链接时（重要）** → 先用 Playwright 截图，再调 `image-reader`：
|
|
27
|
+
|
|
28
|
+
> Axure 是 SPA 应用，WebFetch 必定失败（TLS/JS 渲染问题）。**禁止用 WebFetch 访问 Axure 链接。**
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
# 1. 用 Playwright 截图（每个页面单独截）
|
|
32
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
33
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
34
|
+
|
|
35
|
+
# 2. 截图完成后，传给 image-reader 分析
|
|
36
|
+
Agent(subagent_type="image-reader", prompt="分析 Axure 原型截图：/tmp/axure-1.png")
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
**有 Axure 原型截图文件时** → 直接调用 `image-reader` Agent：
|
|
27
40
|
```
|
|
28
41
|
Agent(subagent_type="image-reader", prompt="分析以下 Axure 原型截图，提取页面结构、搜索条件、表格列、表单字段、操作按钮、交互流程：[图片路径]")
|
|
29
42
|
```
|
|
@@ -29,7 +29,7 @@ description: |
|
|
|
29
29
|
│ - 用户已给出完整字段列表
|
|
30
30
|
│
|
|
31
31
|
└─ 复杂需求？ ──→ Agent 路径（启动 requirements-analyzer）
|
|
32
|
-
- 提供了 Axure
|
|
32
|
+
- 提供了 Axure 原型链接或截图
|
|
33
33
|
- 提供了云效任务编号
|
|
34
34
|
- 多页面/多模块联动
|
|
35
35
|
- 业务流程复杂，需要状态流转设计
|
|
@@ -45,12 +45,34 @@ description: |
|
|
|
45
45
|
|
|
46
46
|
## Agent 路径（复杂需求）
|
|
47
47
|
|
|
48
|
+
### Axure 链接处理（重要）
|
|
49
|
+
|
|
50
|
+
> **Axure 是 SPA 应用，WebFetch 必定失败（TLS/JS 渲染问题）。禁止用 WebFetch 访问 Axure 链接。**
|
|
51
|
+
|
|
52
|
+
当用户提供 Axure 链接时，必须用 Playwright 截图：
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
# 1. 先用 Playwright 截图（每个页面单独截）
|
|
56
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
57
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
58
|
+
|
|
59
|
+
# 2. 截图完成后，将文件路径传给 image-reader Agent 分析
|
|
60
|
+
# 3. 如果原型有多个页面，URL 通常带 #page 参数，逐页截图
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**判断规则**：
|
|
64
|
+
- URL 包含 `axure.cloud` 或 `.axshare.com` → Playwright 截图
|
|
65
|
+
- 用户说"Axure 链接" → Playwright 截图
|
|
66
|
+
- 本地截图文件（.png/.jpg） → 直接 image-reader 分析
|
|
67
|
+
|
|
68
|
+
### 完整流程
|
|
69
|
+
|
|
48
70
|
```
|
|
49
71
|
步骤 1：收集信息（从用户消息中提取）
|
|
50
|
-
- Axure
|
|
51
|
-
-
|
|
72
|
+
- Axure 原型链接 → Playwright 截图 → image-reader 分析
|
|
73
|
+
- Axure 原型截图文件 → 直接 image-reader 分析
|
|
74
|
+
- 云效任务编号 → task-fetcher 获取详情
|
|
52
75
|
- 需求描述文字
|
|
53
|
-
- 关联模块信息
|
|
54
76
|
|
|
55
77
|
步骤 2：启动 requirements-analyzer Agent
|
|
56
78
|
└── requirements-analyzer(Opus) 内部自动编排：
|
|
@@ -69,13 +91,23 @@ description: |
|
|
|
69
91
|
|---------------|---------|
|
|
70
92
|
| 只有文字描述 | 快速路径（不启动 Agent） |
|
|
71
93
|
| 文字 + 原型截图 | requirements-analyzer → 内部调 image-reader |
|
|
94
|
+
| 文字 + Axure 链接 | Playwright 截图 → requirements-analyzer → image-reader |
|
|
72
95
|
| 文字 + 云效任务号 | requirements-analyzer → 内部调 task-fetcher |
|
|
73
96
|
| 原型截图 + 云效任务号 | requirements-analyzer → 内部并行调 image-reader + task-fetcher |
|
|
74
97
|
|
|
75
98
|
### 启动示例
|
|
76
99
|
|
|
77
100
|
```
|
|
78
|
-
#
|
|
101
|
+
# 有 Axure 链接（先截图再分析）
|
|
102
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
103
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
104
|
+
|
|
105
|
+
Agent(subagent_type="requirements-analyzer",
|
|
106
|
+
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
107
|
+
截图路径：/tmp/axure-1.png, /tmp/axure-2.png
|
|
108
|
+
需求描述：xxx")
|
|
109
|
+
|
|
110
|
+
# 有原型截图文件
|
|
79
111
|
Agent(subagent_type="requirements-analyzer",
|
|
80
112
|
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
81
113
|
截图路径：/path/to/image1.png, /path/to/image2.png
|
|
@@ -110,3 +142,4 @@ Agent(subagent_type="requirements-analyzer",
|
|
|
110
142
|
- 与 `bug-detective` / `fix-bug` 的区别：本技能面向**新功能开发前的需求分析**，不涉及 Bug 排查
|
|
111
143
|
- 数据库设计必须遵循项目规范（雪花 ID、审计字段、del_flag=2 正常）
|
|
112
144
|
- 如果需求信息不完整，主动列出需要确认的点，而不是猜测
|
|
145
|
+
- **Axure 链接必须用 Playwright 截图，禁止 WebFetch**
|
|
@@ -29,7 +29,7 @@ description: |
|
|
|
29
29
|
│ - 用户已给出完整字段列表
|
|
30
30
|
│
|
|
31
31
|
└─ 复杂需求？ ──→ Agent 路径（启动 requirements-analyzer）
|
|
32
|
-
- 提供了 Axure
|
|
32
|
+
- 提供了 Axure 原型链接或截图
|
|
33
33
|
- 提供了云效任务编号
|
|
34
34
|
- 多页面/多模块联动
|
|
35
35
|
- 业务流程复杂，需要状态流转设计
|
|
@@ -45,12 +45,34 @@ description: |
|
|
|
45
45
|
|
|
46
46
|
## Agent 路径（复杂需求）
|
|
47
47
|
|
|
48
|
+
### Axure 链接处理（重要）
|
|
49
|
+
|
|
50
|
+
> **Axure 是 SPA 应用，WebFetch 必定失败（TLS/JS 渲染问题）。禁止用 WebFetch 访问 Axure 链接。**
|
|
51
|
+
|
|
52
|
+
当用户提供 Axure 链接时，必须用 Playwright 截图：
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
# 1. 先用 Playwright 截图（每个页面单独截）
|
|
56
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
57
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
58
|
+
|
|
59
|
+
# 2. 截图完成后，将文件路径传给 image-reader Agent 分析
|
|
60
|
+
# 3. 如果原型有多个页面，URL 通常带 #page 参数，逐页截图
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**判断规则**：
|
|
64
|
+
- URL 包含 `axure.cloud` 或 `.axshare.com` → Playwright 截图
|
|
65
|
+
- 用户说"Axure 链接" → Playwright 截图
|
|
66
|
+
- 本地截图文件（.png/.jpg） → 直接 image-reader 分析
|
|
67
|
+
|
|
68
|
+
### 完整流程
|
|
69
|
+
|
|
48
70
|
```
|
|
49
71
|
步骤 1：收集信息（从用户消息中提取）
|
|
50
|
-
- Axure
|
|
51
|
-
-
|
|
72
|
+
- Axure 原型链接 → Playwright 截图 → image-reader 分析
|
|
73
|
+
- Axure 原型截图文件 → 直接 image-reader 分析
|
|
74
|
+
- 云效任务编号 → task-fetcher 获取详情
|
|
52
75
|
- 需求描述文字
|
|
53
|
-
- 关联模块信息
|
|
54
76
|
|
|
55
77
|
步骤 2：启动 requirements-analyzer Agent
|
|
56
78
|
└── requirements-analyzer(Opus) 内部自动编排：
|
|
@@ -69,13 +91,23 @@ description: |
|
|
|
69
91
|
|---------------|---------|
|
|
70
92
|
| 只有文字描述 | 快速路径（不启动 Agent） |
|
|
71
93
|
| 文字 + 原型截图 | requirements-analyzer → 内部调 image-reader |
|
|
94
|
+
| 文字 + Axure 链接 | Playwright 截图 → requirements-analyzer → image-reader |
|
|
72
95
|
| 文字 + 云效任务号 | requirements-analyzer → 内部调 task-fetcher |
|
|
73
96
|
| 原型截图 + 云效任务号 | requirements-analyzer → 内部并行调 image-reader + task-fetcher |
|
|
74
97
|
|
|
75
98
|
### 启动示例
|
|
76
99
|
|
|
77
100
|
```
|
|
78
|
-
#
|
|
101
|
+
# 有 Axure 链接（先截图再分析）
|
|
102
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
103
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
104
|
+
|
|
105
|
+
Agent(subagent_type="requirements-analyzer",
|
|
106
|
+
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
107
|
+
截图路径：/tmp/axure-1.png, /tmp/axure-2.png
|
|
108
|
+
需求描述：xxx")
|
|
109
|
+
|
|
110
|
+
# 有原型截图文件
|
|
79
111
|
Agent(subagent_type="requirements-analyzer",
|
|
80
112
|
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
81
113
|
截图路径：/path/to/image1.png, /path/to/image2.png
|
|
@@ -110,3 +142,4 @@ Agent(subagent_type="requirements-analyzer",
|
|
|
110
142
|
- 与 `bug-detective` / `fix-bug` 的区别：本技能面向**新功能开发前的需求分析**，不涉及 Bug 排查
|
|
111
143
|
- 数据库设计必须遵循项目规范（雪花 ID、审计字段、del_flag=2 正常）
|
|
112
144
|
- 如果需求信息不完整，主动列出需要确认的点，而不是猜测
|
|
145
|
+
- **Axure 链接必须用 Playwright 截图，禁止 WebFetch**
|
|
@@ -29,7 +29,7 @@ description: |
|
|
|
29
29
|
│ - 用户已给出完整字段列表
|
|
30
30
|
│
|
|
31
31
|
└─ 复杂需求？ ──→ Agent 路径（启动 requirements-analyzer）
|
|
32
|
-
- 提供了 Axure
|
|
32
|
+
- 提供了 Axure 原型链接或截图
|
|
33
33
|
- 提供了云效任务编号
|
|
34
34
|
- 多页面/多模块联动
|
|
35
35
|
- 业务流程复杂，需要状态流转设计
|
|
@@ -45,12 +45,34 @@ description: |
|
|
|
45
45
|
|
|
46
46
|
## Agent 路径（复杂需求）
|
|
47
47
|
|
|
48
|
+
### Axure 链接处理（重要）
|
|
49
|
+
|
|
50
|
+
> **Axure 是 SPA 应用，WebFetch 必定失败（TLS/JS 渲染问题）。禁止用 WebFetch 访问 Axure 链接。**
|
|
51
|
+
|
|
52
|
+
当用户提供 Axure 链接时，必须用 Playwright 截图：
|
|
53
|
+
|
|
54
|
+
```bash
|
|
55
|
+
# 1. 先用 Playwright 截图（每个页面单独截）
|
|
56
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
57
|
+
npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
58
|
+
|
|
59
|
+
# 2. 截图完成后，将文件路径传给 image-reader Agent 分析
|
|
60
|
+
# 3. 如果原型有多个页面，URL 通常带 #page 参数，逐页截图
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
**判断规则**：
|
|
64
|
+
- URL 包含 `axure.cloud` 或 `.axshare.com` → Playwright 截图
|
|
65
|
+
- 用户说"Axure 链接" → Playwright 截图
|
|
66
|
+
- 本地截图文件（.png/.jpg） → 直接 image-reader 分析
|
|
67
|
+
|
|
68
|
+
### 完整流程
|
|
69
|
+
|
|
48
70
|
```
|
|
49
71
|
步骤 1：收集信息（从用户消息中提取）
|
|
50
|
-
- Axure
|
|
51
|
-
-
|
|
72
|
+
- Axure 原型链接 → Playwright 截图 → image-reader 分析
|
|
73
|
+
- Axure 原型截图文件 → 直接 image-reader 分析
|
|
74
|
+
- 云效任务编号 → task-fetcher 获取详情
|
|
52
75
|
- 需求描述文字
|
|
53
|
-
- 关联模块信息
|
|
54
76
|
|
|
55
77
|
步骤 2：启动 requirements-analyzer Agent
|
|
56
78
|
└── requirements-analyzer(Opus) 内部自动编排：
|
|
@@ -69,13 +91,23 @@ description: |
|
|
|
69
91
|
|---------------|---------|
|
|
70
92
|
| 只有文字描述 | 快速路径（不启动 Agent） |
|
|
71
93
|
| 文字 + 原型截图 | requirements-analyzer → 内部调 image-reader |
|
|
94
|
+
| 文字 + Axure 链接 | Playwright 截图 → requirements-analyzer → image-reader |
|
|
72
95
|
| 文字 + 云效任务号 | requirements-analyzer → 内部调 task-fetcher |
|
|
73
96
|
| 原型截图 + 云效任务号 | requirements-analyzer → 内部并行调 image-reader + task-fetcher |
|
|
74
97
|
|
|
75
98
|
### 启动示例
|
|
76
99
|
|
|
77
100
|
```
|
|
78
|
-
#
|
|
101
|
+
# 有 Axure 链接（先截图再分析）
|
|
102
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page1" /tmp/axure-1.png
|
|
103
|
+
Bash: npx playwright screenshot --wait-for-timeout 3000 "https://xxx.axure.cloud/page2" /tmp/axure-2.png
|
|
104
|
+
|
|
105
|
+
Agent(subagent_type="requirements-analyzer",
|
|
106
|
+
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
107
|
+
截图路径：/tmp/axure-1.png, /tmp/axure-2.png
|
|
108
|
+
需求描述：xxx")
|
|
109
|
+
|
|
110
|
+
# 有原型截图文件
|
|
79
111
|
Agent(subagent_type="requirements-analyzer",
|
|
80
112
|
prompt="分析以下 Axure 原型截图，输出需求分析报告和开发任务清单：
|
|
81
113
|
截图路径：/path/to/image1.png, /path/to/image2.png
|
|
@@ -110,3 +142,4 @@ Agent(subagent_type="requirements-analyzer",
|
|
|
110
142
|
- 与 `bug-detective` / `fix-bug` 的区别：本技能面向**新功能开发前的需求分析**，不涉及 Bug 排查
|
|
111
143
|
- 数据库设计必须遵循项目规范（雪花 ID、审计字段、del_flag=2 正常）
|
|
112
144
|
- 如果需求信息不完整，主动列出需要确认的点，而不是猜测
|
|
145
|
+
- **Axure 链接必须用 Playwright 截图，禁止 WebFetch**
|