@hupan56/wlkj 3.1.15 → 3.1.17
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 +1 -1
- package/templates/qoder/agents/design-agent.md +20 -20
- package/templates/qoder/agents/insight-planning.md +1 -1
- package/templates/qoder/agents/prd-quick.md +2 -2
- package/templates/qoder/agents/prd-reference.md +4 -4
- package/templates/qoder/agents/qoder-coder.toml +3 -4
- package/templates/qoder/agents/qoder-test-gen.toml +3 -4
- package/templates/qoder/rules/wl-pipeline.md +6 -6
package/package.json
CHANGED
|
@@ -1,20 +1,20 @@
|
|
|
1
|
-
# Design Agent
|
|
2
|
-
|
|
3
|
-
## Required: Load Context First (Pull-Based)
|
|
4
|
-
Load task context yourself. Run: python .qoder/scripts/
|
|
5
|
-
Then read the PRD from the task directory.
|
|
6
|
-
|
|
7
|
-
## Recursion Guard
|
|
8
|
-
You are the design-agent. Do NOT spawn another design-agent.
|
|
9
|
-
|
|
10
|
-
## Your Role
|
|
11
|
-
Transform PRD into design artifacts.
|
|
12
|
-
|
|
13
|
-
## Workflow
|
|
14
|
-
1. Read PRD from task directory
|
|
15
|
-
2. Analyze UI requirements
|
|
16
|
-
3. Generate design artifacts to workspace/tasks/{id}/design/:
|
|
17
|
-
- components.json: component tree and specs
|
|
18
|
-
- interaction-flow.md: user flow and state transitions
|
|
19
|
-
4. Review against PRD acceptance criteria
|
|
20
|
-
5. Submit via /handoff to dev
|
|
1
|
+
# Design Agent
|
|
2
|
+
|
|
3
|
+
## Required: Load Context First (Pull-Based)
|
|
4
|
+
Load task context yourself. Run: python .qoder/scripts/orchestration/wlkj.py task current --source
|
|
5
|
+
Then read the PRD from the task directory.
|
|
6
|
+
|
|
7
|
+
## Recursion Guard
|
|
8
|
+
You are the design-agent. Do NOT spawn another design-agent.
|
|
9
|
+
|
|
10
|
+
## Your Role
|
|
11
|
+
Transform PRD into design artifacts.
|
|
12
|
+
|
|
13
|
+
## Workflow
|
|
14
|
+
1. Read PRD from task directory
|
|
15
|
+
2. Analyze UI requirements
|
|
16
|
+
3. Generate design artifacts to workspace/tasks/{id}/design/:
|
|
17
|
+
- components.json: component tree and specs
|
|
18
|
+
- interaction-flow.md: user flow and state transitions
|
|
19
|
+
4. Review against PRD acceptance criteria
|
|
20
|
+
5. Submit via /handoff to dev
|
|
@@ -9,7 +9,7 @@ Read the dispatch prompt — it MUST contain: topic, current developer name,
|
|
|
9
9
|
and either (a) a reference to a recent insight research report, or
|
|
10
10
|
(b) a user-described ideal state. If neither, STOP and report back:
|
|
11
11
|
"planning needs an ideal state — either a research report or user description".
|
|
12
|
-
For current state, run: `python .qoder/scripts/
|
|
12
|
+
For current state, run: `python .qoder/scripts/orchestration/wlkj.py context <关键词> --platform <web|app>`
|
|
13
13
|
|
|
14
14
|
## Recursion Guard
|
|
15
15
|
You are the insight-planning sub-agent. Do NOT spawn another insight-planning agent.
|
|
@@ -15,7 +15,7 @@ You are the prd-quick sub-agent. Do NOT spawn another.
|
|
|
15
15
|
|
|
16
16
|
### Step 1: 一次取全上下文(1 次调用)
|
|
17
17
|
```bash
|
|
18
|
-
python .qoder/scripts/
|
|
18
|
+
python .qoder/scripts/orchestration/wlkj.py context <关键词> --platform <web|app>
|
|
19
19
|
```
|
|
20
20
|
> context_pack 一次返回代码+页面+字段+API+样式。**不要**再单独跑 search_index。
|
|
21
21
|
> 只读返回结果里最相关的 **1-2 个文件**(用 Read 工具)。**不要读超过 3 个文件**。
|
|
@@ -32,7 +32,7 @@ python .qoder/scripts/context_pack.py <关键词> --platform <web|app>
|
|
|
32
32
|
|
|
33
33
|
### Step 3: 一句话确认
|
|
34
34
|
把 PRD 和原型路径告诉用户,问"可以吗?可以就推送给团队"。
|
|
35
|
-
用户确认 → `python .qoder/scripts/
|
|
35
|
+
用户确认 → `python .qoder/scripts/orchestration/wlkj.py sync push`
|
|
36
36
|
|
|
37
37
|
## Mini-PRD 极简格式
|
|
38
38
|
```markdown
|
|
@@ -6,7 +6,7 @@ This platform does NOT auto-inject task context. Before anything else:
|
|
|
6
6
|
user requirement, current developer name
|
|
7
7
|
2. If platform is missing from the dispatch prompt, STOP and report back:
|
|
8
8
|
"platform not specified - caller must ask user first (see /wl-prd-full Step 0)"
|
|
9
|
-
3. If task context needed: python .qoder/scripts/
|
|
9
|
+
3. If task context needed: python .qoder/scripts/orchestration/wlkj.py task current --source
|
|
10
10
|
|
|
11
11
|
## Recursion Guard
|
|
12
12
|
You are the prd-reference sub-agent.
|
|
@@ -20,9 +20,9 @@ Generate PRD + prototype by referencing existing project data.
|
|
|
20
20
|
|
|
21
21
|
## Workflow
|
|
22
22
|
1. Search the index (platform-aware):
|
|
23
|
-
python .qoder/scripts/
|
|
24
|
-
python .qoder/scripts/
|
|
25
|
-
python .qoder/scripts/
|
|
23
|
+
python .qoder/scripts/orchestration/wlkj.py search <keyword> --platform <web|app>
|
|
24
|
+
python .qoder/scripts/orchestration/wlkj.py search --style <type> --platform <web|app>
|
|
25
|
+
python .qoder/scripts/orchestration/wlkj.py search --prd <keyword>
|
|
26
26
|
(首选 context_pack.py 一次取全,search_index 仅作单项下钻兜底)
|
|
27
27
|
2. Read related historical PRDs from data/docs/prd/
|
|
28
28
|
3. Read data/docs/drafts/ for business drafts
|
|
@@ -17,9 +17,8 @@ developer_instructions = """
|
|
|
17
17
|
### Step 2: 读取上下文
|
|
18
18
|
1. Spec 文件 — 开发规格(必需)
|
|
19
19
|
2. PRD 文件 — 原始需求(推荐)
|
|
20
|
-
3.
|
|
21
|
-
4.
|
|
22
|
-
5. `.qoder/context/data-dictionary.md` — 数据字典
|
|
20
|
+
3. `data/docs/architecture/` — 架构说明(读 kg-layers.md 等)
|
|
21
|
+
4. 团队代码风格: 读目标模块周围的现有代码, 与其风格一致 (无独立 code-style.md)
|
|
23
22
|
|
|
24
23
|
### Step 3: 按 Spec 实现
|
|
25
24
|
严格按照 Spec 规格编码:
|
|
@@ -31,7 +30,7 @@ developer_instructions = """
|
|
|
31
30
|
### Step 4: 自检
|
|
32
31
|
- 所有 Spec 定义的接口都已实现
|
|
33
32
|
- 数据库字段与 Spec 一致
|
|
34
|
-
-
|
|
33
|
+
- 代码风格与周围现有代码一致
|
|
35
34
|
|
|
36
35
|
## 编码原则
|
|
37
36
|
1. 先读后写
|
|
@@ -17,11 +17,10 @@ developer_instructions = """
|
|
|
17
17
|
### Step 2: 读取上下文
|
|
18
18
|
1. 实现代码 — 被测代码(必需)
|
|
19
19
|
2. Spec 文件 — 测试要点映射(推荐)
|
|
20
|
-
3.
|
|
21
|
-
4. `.qoder/rules/code-style.md` — 代码规范
|
|
20
|
+
3. 测试规范: 参考 `data/docs/constitution/eva-metrics.md` (验收标准) + Spec 的异常场景定义
|
|
22
21
|
|
|
23
22
|
### Step 3: 生成测试
|
|
24
|
-
|
|
23
|
+
按团队规范生成:
|
|
25
24
|
- Service 层: Mock 所有依赖,Given-When-Then 模式
|
|
26
25
|
- Controller 层: MockMvc 测试
|
|
27
26
|
- 每个测试有 @DisplayName
|
|
@@ -45,4 +44,4 @@ developer_instructions = """
|
|
|
45
44
|
multi_agent = false
|
|
46
45
|
|
|
47
46
|
[features.multi_agent_v2]
|
|
48
|
-
enabled = false
|
|
47
|
+
enabled = false
|
|
@@ -39,7 +39,7 @@ test -f .qoder/.developer && echo "已初始化" || echo "未初始化"
|
|
|
39
39
|
工作流**只在显式调用时启动**,不主动干预用户的普通对话。
|
|
40
40
|
|
|
41
41
|
**两种触发方式(且仅此两种):**
|
|
42
|
-
1. **斜杠命令**:输入 `/wl-prd
|
|
42
|
+
1. **斜杠命令**:输入 `/wl-prd` `/wl-search` `/wl-req` 等 → 启动工作流
|
|
43
43
|
2. **npx**:`npx @hupan56/wlkj init/update` → 启动安装/同步
|
|
44
44
|
|
|
45
45
|
**自然语言不触发工作流。** 用户说"写个需求""查下代码"等,AI 正常回答,不自动拉入工作流。
|
|
@@ -111,7 +111,7 @@ kg.py context(= context_pack)一条命令返回:相关代码文件 + 同
|
|
|
111
111
|
- 兜底搜索**唯一合法方式** = `kg.py grep-text`(已内置单进程、范围限定、命中上限)
|
|
112
112
|
- Grep/Glob 工具**只准搜 context/grep-text 已定位到的具体文件或单一小目录**,不准全库扫
|
|
113
113
|
|
|
114
|
-
**为什么这条是红线**:QoderWork 自带 Agent 默认会用 Grep/Glob 直搜文件系统,它不懂"业务源码在 data/code/ 镜像里",会搜整个 qoderAll 仓然后报"无匹配",被迫凭空编字段/API。更糟的是 AI 兜底去跑 `findstr /s` 全盘扫描 → Windows 对 8973 文件递归 = 卡死 + 疯狂弹子进程窗口,用户只能强杀。**Agent 只准用来**:①读 context 列出的具体文件(Read)②**在 /wl-insight 里**做 web 调研(对标/竞品)和多视角探索脑暴。**绝不用 Agent 去"发现/搜索"代码——那是 kg.py 的活。** 注意:探索类 Agent 调研已集中到 `/wl-insight`,`/wl-prd
|
|
114
|
+
**为什么这条是红线**:QoderWork 自带 Agent 默认会用 Grep/Glob 直搜文件系统,它不懂"业务源码在 data/code/ 镜像里",会搜整个 qoderAll 仓然后报"无匹配",被迫凭空编字段/API。更糟的是 AI 兜底去跑 `findstr /s` 全盘扫描 → Windows 对 8973 文件递归 = 卡死 + 疯狂弹子进程窗口,用户只能强杀。**Agent 只准用来**:①读 context 列出的具体文件(Read)②**在 /wl-insight 里**做 web 调研(对标/竞品)和多视角探索脑暴。**绝不用 Agent 去"发现/搜索"代码——那是 kg.py 的活。** 注意:探索类 Agent 调研已集中到 `/wl-insight`,`/wl-prd` 不再派 Agent 做 web 搜索/脑暴。
|
|
115
115
|
|
|
116
116
|
## 规则 2.5:工具调用能并发就并发(性能命门,串行 = 慢)
|
|
117
117
|
|
|
@@ -163,7 +163,7 @@ kg.py context(= context_pack)一条命令返回:相关代码文件 + 同
|
|
|
163
163
|
|
|
164
164
|
**典型协作流程:**
|
|
165
165
|
```
|
|
166
|
-
PM /wl-prd
|
|
166
|
+
PM /wl-prd → AI 出初稿 PRD + 原型
|
|
167
167
|
→ 设计师 QoderWork 说"录入设计稿" (design-import): Figma 稿→spec.json
|
|
168
168
|
→ PM 说"按设计师规范修订原型" → AI 用 spec 重生成原型
|
|
169
169
|
→ 设计师说"评审原型" (design-review) → 通过
|
|
@@ -215,8 +215,8 @@ PM /wl-prd-full → AI 出初稿 PRD + 原型
|
|
|
215
215
|
| 命令 | 工序站 | 模式参数 |
|
|
216
216
|
|------|--------|---------|
|
|
217
217
|
| /wl-init [名字] [角色] | 身份 | (无) |
|
|
218
|
-
| /wl-prd
|
|
219
|
-
| /wl-prd
|
|
218
|
+
| /wl-prd <需求> | 需求落地(完整档) | 支持 `参考:<报告>` 衔接 insight |
|
|
219
|
+
| /wl-prd(快速档) <需求> | 需求落地(小改动) | (无) |
|
|
220
220
|
| /wl-design <模式> | 设计 | import/generate/review 或默认(import) |
|
|
221
221
|
| /wl-task <子命令> | 任务 | create/list/start/finish |
|
|
222
222
|
| /wl-code | 编码 | (按 spec 实现,需确认) |
|
|
@@ -225,7 +225,7 @@ PM /wl-prd-full → AI 出初稿 PRD + 原型
|
|
|
225
225
|
|
|
226
226
|
**可选命令**(按需启用):/wl-search(代码搜索,全员工具)、/wl-spec(技术规格)、
|
|
227
227
|
/wl-status(项目健康度)、/wl-report(日报周报)、
|
|
228
|
-
/wl-insight(探索站:discover/research/plan,**位于 /wl-prd
|
|
228
|
+
/wl-insight(探索站:discover/research/plan,**位于 /wl-prd 之前**)。
|
|
229
229
|
|
|
230
230
|
> 模块契约(输入/输出/校验):见 `.qoder/contracts/`。
|
|
231
231
|
> `/wl-test` 默认浏览器自动化测试(据任务 PRD 生成用例 → QoderWork 浏览器执行,
|