@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 CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@hupan56/wlkj",
3
- "version": "3.1.15",
3
+ "version": "3.1.17",
4
4
  "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
5
5
  "bin": {
6
6
  "wlkj": "bin/cli.js"
@@ -1,20 +1,20 @@
1
- # Design Agent
2
-
3
- ## Required: Load Context First (Pull-Based)
4
- Load task context yourself. Run: python .qoder/scripts/task.py 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
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/context_pack.py <关键词> --platform <web|app>`
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/context_pack.py <关键词> --platform <web|app>
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/team_sync.py push`
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/task.py current --source
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/search_index.py <keyword> --platform <web|app>
24
- python .qoder/scripts/search_index.py --style <type> --platform <web|app>
25
- python .qoder/scripts/search_index.py --prd <keyword>
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. `.qoder/rules/code-style.md` — 代码规范
21
- 4. `.qoder/context/architecture.md` — 架构说明
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
- - 代码符合 code-style.md
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. `.qoder/rules/testing.md` 测试规范(必需)
21
- 4. `.qoder/rules/code-style.md` — 代码规范
20
+ 3. 测试规范: 参考 `data/docs/constitution/eva-metrics.md` (验收标准) + Spec 的异常场景定义
22
21
 
23
22
  ### Step 3: 生成测试
24
- 按 testing.md 规范生成:
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-full` `/wl-search` `/wl-req` 等 → 启动工作流
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-full` 不再派 Agent 做 web 搜索/脑暴。
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-full → AI 出初稿 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-full <需求> | 需求落地(完整档) | 支持 `参考:<报告>` 衔接 insight |
219
- | /wl-prd-quick <需求> | 需求落地(小改动) | (无) |
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-full 之前**)。
228
+ /wl-insight(探索站:discover/research/plan,**位于 /wl-prd 之前**)。
229
229
 
230
230
  > 模块契约(输入/输出/校验):见 `.qoder/contracts/`。
231
231
  > `/wl-test` 默认浏览器自动化测试(据任务 PRD 生成用例 → QoderWork 浏览器执行,