ai-project-manage-cli 3.0.13 → 3.0.15

package/dist/index.js

@@ -231,8 +231,105 @@ import { execSync } from "child_process";
 import { randomUUID } from "crypto";
 import WebSocket from "ws";
 import { Agent } from "@cursor/sdk";
+
+// src/session-utils.ts
 import { appendFileSync } from "fs";
 import { resolve as resolve2 } from "path";
+var EventSession = class {
+  events = [];
+  addEvent(event) {
+    const latestEvent = this.events[this.events.length - 1];
+    const formatedEvent = this.formatEvent(event);
+    if (!formatedEvent) {
+      return;
+    }
+    if (formatedEvent.type === "tool_call") {
+      const existingToolCall = this.events.find(
+        (e) => e.type === "tool_call" && e.call_id === formatedEvent.call_id
+      );
+      if (existingToolCall) {
+        existingToolCall.args = formatedEvent.args;
+        existingToolCall.result = formatedEvent.result;
+        existingToolCall.status = formatedEvent.status;
+        return;
+      }
+      this.events.push(formatedEvent);
+      return;
+    }
+    if (formatedEvent.type === "status") {
+      return;
+    }
+    if (formatedEvent.type === "request") {
+      this.events.push(formatedEvent);
+      return;
+    }
+    if (latestEvent?.type === formatedEvent.type) {
+      switch (formatedEvent.type) {
+        case "assistant":
+          latestEvent.content += formatedEvent.content;
+          break;
+        case "thinking":
+          latestEvent.content += formatedEvent.content;
+          break;
+        case "task":
+          latestEvent.status = formatedEvent.status;
+          latestEvent.text = formatedEvent.text;
+          break;
+      }
+      return;
+    }
+    this.events.push(event);
+  }
+  formatEvent(event) {
+    switch (event.type) {
+      case "assistant":
+        return {
+          type: "assistant",
+          content: event.message.content[0].text || ""
+        };
+      case "thinking":
+        return { type: "thinking", content: event.text || "" };
+      case "tool_call":
+        return {
+          type: "tool_call",
+          args: event.args,
+          result: event.result,
+          status: event.status,
+          call_id: event.call_id,
+          name: event.name
+        };
+      case "task":
+        return {
+          type: "task",
+          status: event.status,
+          text: event.text
+        };
+      case "request":
+        return {
+          ...event,
+          type: "request"
+        };
+      case "status":
+        return { type: "status", status: event.status, message: event.message };
+    }
+  }
+  writeToFile(cwd, requirementId, agentId) {
+    const sessionsDir = resolve2(
+      cwd,
+      `.apm/workitems/${requirementId}/sessions`
+    );
+    ensureDirExists(sessionsDir);
+    const sessionFile = resolve2(sessionsDir, `${agentId}.md`);
+    this.events.forEach((event) => {
+      appendFileSync(
+        sessionFile,
+        JSON.stringify(event, null, 2) + "\n=====================================================\n"
+      );
+    });
+  }
+};
+
+// src/commands/connect.ts
 function runConnect(opts) {
   void (async () => {
     const cfg = await ensureApmConfig();
@@ -294,8 +391,7 @@ function runConnect(opts) {
           status: "WORKING"
         });
         let IN_PROGRESS = false;
-        const events = [];
-        let data2 = {};
+        const session = new EventSession();
         const run = await agent.send(payload.prompt);
         for await (const event of run.stream()) {
           if (!IN_PROGRESS) {
@@ -306,50 +402,30 @@ function runConnect(opts) {
             });
             IN_PROGRESS = true;
           }
+          if (event.type === "status") {
+            console.log(`[Status]`, event.message || event.status);
+            continue;
+          }
           if (event.type === "assistant") {
             const output = event.message.content[0].text;
             console.log(`[Output]`, output);
-            if (data2.type && data2.type !== "assistant") {
-              events.push(data2);
-              data2 = {};
-            }
-            data2.type = "output";
-            if (!data2.content) {
-              data2.content = "";
-            }
-            data2.content += output;
+            session.addEvent(event);
             continue;
           }
           if (event.type === "thinking") {
             const thinking = event.text;
             console.log(`[Thinking]`, thinking);
-            if (data2.type && data2.type !== "thinking") {
-              events.push(data2);
-              data2 = {};
-            }
-            data2.type = "thinking";
-            if (!data2.content) {
-              data2.content = "";
-            }
-            data2.content += thinking;
+            session.addEvent(event);
             continue;
           }
-          if (event.type === "tool_call" && (event.status === "completed" || event.status === "error")) {
-            console.log(`[ToolCall(${event.call_id}) Result]`);
-            console.log(JSON.stringify(event.args));
-            console.log(JSON.stringify(event.result, null, 2));
-            console.log("---------------\u8C03\u7528\u5B8C\u6210-----------------");
-            if (data2.type && data2.type !== "tool_call") {
-              events.push(data2);
-              data2 = {};
+          if (event.type === "tool_call") {
+            if (event.status === "completed" || event.status === "error") {
+              console.log(`[ToolCall(${event.call_id}) Result]`);
+              console.log(JSON.stringify(event.args));
+              console.log(JSON.stringify(event.result, null, 2));
+              console.log("---------------\u8C03\u7528\u5B8C\u6210-----------------");
             }
-            data2.type = "tool_call";
-            data2.call_id = event.call_id;
-            data2.args = event.args;
-            data2.result = event.result;
-            data2.status = event.status;
-            events.push(data2);
-            data2 = {};
+            session.addEvent(event);
             continue;
           }
           if (event.type === "task") {
@@ -357,32 +433,15 @@ function runConnect(opts) {
             console.log("--------------------------------");
             console.log(event.text || "\u65E0");
             console.log("--------------------------------");
-            if (data2.type && data2.type !== "task") {
-              events.push(data2);
-              data2 = {};
-            }
-            data2.type = "task";
-            data2.status = event.status;
-            data2.text = event.text;
-            events.push(data2);
-            data2 = {};
+            session.addEvent(event);
             continue;
           }
           if (event.type === "request") {
             console.log(JSON.stringify(event, null, 2));
-            if (data2.type && data2.type !== "request") {
-              events.push(data2);
-              data2 = {};
-            }
-            data2 = event;
+            session.addEvent(event);
             continue;
           }
           console.log("\u672A\u77E5\u4E8B\u4EF6:", JSON.stringify(event, null, 2));
-          continue;
-        }
-        if (data2.type) {
-          events.push(data2);
-          data2 = {};
         }
         await api.cliRequirements.updateTaskStatus({
           taskId: payload.taskId,
@@ -394,18 +453,7 @@ function runConnect(opts) {
           status: "IDLE"
         });
         console.log("[Done]");
-        const sessionsDir = resolve2(
-          payload.cwd,
-          `.apm/workitems/${payload.requirementId}/sessions`
-        );
-        ensureDirExists(sessionsDir);
-        const sessionFile = resolve2(sessionsDir, `${run.agentId}.md`);
-        for (const event of events) {
-          appendFileSync(
-            sessionFile,
-            JSON.stringify(event, null, 2) + "\n=====================================================\n"
-          );
-        }
+        session.writeToFile(payload.cwd, payload.requirementId, run.agentId);
       } catch {
         console.error("[apm] \u65E0\u6CD5\u89E3\u6790 WebSocket \u6D88\u606F:", text);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "3.0.13",
+  "version": "3.0.15",
   "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
   "type": "module",
   "private": false,

package/template/skills/apm-dev/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: apm-dev
-description: 按需求 ID 全自动开发：切分支、读 PRD、按改动规模选择 Quick 或 Spec 路径实现代码、提交并推送、同步产物；子 Agent 承担编码与规划落地；当用户 @ 本技能、提及全自动开发或「apm-dev」时使用。
+description: 按需求 ID 全自动开发：切分支、Read defect.xml（无/空内容→新功能；有内容→修 Bug 可短路至提交）、读 PRD、按改动规模选择 Quick 或 Spec、提交并推送、同步产物；子 Agent 承担编码与规划落地；当用户 @ 本技能、提及全自动开发或「apm-dev」时使用。
 ---
 
 # APM 全自动开发（按需求 ID）
@@ -25,7 +25,7 @@ Spec 路径依赖的技能**仅**来自 **`.apm/skills/`**。执行前父 Agent
 | **apm-propose** | `.apm/skills/apm-propose/SKILL.md` |
 | **apm-apply-change** | `.apm/skills/apm-apply-change/SKILL.md` |
 
-instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-instruction.md`）。若上述 `SKILL.md` **不存在或不可读**：**不得**进入 Spec 子流程；在表格中标记失败原因（例如需先 `apm init` 或同步 `.apm/skills`），并停止步骤 4。
+instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-instruction.md`）。若上述 `SKILL.md` **不存在或不可读**：**不得**进入 Spec 子流程；在表格中标记失败原因（例如需先 `apm init` 或同步 `.apm/skills`），并停止步骤 5。
 
 ---
 
@@ -34,12 +34,13 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 | 序号 | 步骤 | 说明 |
 | --- | --- | --- |
 | 1 | **切分支** | 在仓库根目录执行 `apm branch <requirementId>` |
-| 2 | **读 PRD + 成本评估** | **Read** `.apm/workitems/<requirementId>/prd.md`，判定 Quick / Spec |
-| 3 | **Quick 开发** | 仅当判定为「改动成本较小」时执行；由 **子 Agent** 写代码 |
-| 4 | **Spec 开发** | 仅当判定为「改动成本较大」时执行；先 **apm-propose** 再 **apm-apply-change**，均由 **子 Agent** 按对应技能执行 |
-| 5 | **提交与推送** | `git` 提交并 `push`，工作区干净 |
-| 6 | **同步产物** | `apm upload-artifact <requirementId>`，将工作项目录内 Markdown 产物同步到平台 |
-| 7 | **对用户回复** | **一张 Markdown 表格**汇总各步执行结果（见文末模板） |
+| 2 | **缺陷清单（分流）** | **Read** `defect.xml`：**无文件或无有效内容** → 跳过，进入步骤 3（**新功能**）；**有内容** → **修复 Bug**：Quick 修 Bug（子 Agent）成功后**跳过步骤 3～5**，直达步骤 **6** |
+| 3 | **读 PRD + 成本评估** | **Read** `.apm/workitems/<requirementId>/prd.md`，判定 Quick / Spec（步骤 2 未走修 Bug 短路时执行，即新功能流程） |
+| 4 | **Quick 开发** | 仅当判定为「改动成本较小」时执行；由 **子 Agent** 写代码 |
+| 5 | **Spec 开发** | 仅当判定为「改动成本较大」时执行；先 **apm-propose** 再 **apm-apply-change**，均由 **子 Agent** 按对应技能执行 |
+| 6 | **提交与推送** | `git` 提交并 `push`，工作区干净 |
+| 7 | **同步产物** | `apm upload-artifact <requirementId>`，将工作项目录内 Markdown 产物同步到平台 |
+| 8 | **对用户回复** | **一张 Markdown 表格**汇总各步执行结果（见文末模板） |
 
 ---
 
@@ -55,7 +56,26 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 
 ---
 
-## 步骤 2：读取 PRD 并评估改动成本
+## 步骤 2：读取缺陷清单（defect.xml）
+
+1. 父 Agent 使用 **Read** 工具读取：`.apm/workitems/<requirementId>/defect.xml`（缺陷列表，格式以平台同步为准）。
+2. 若首次 **Read** 失败（无此文件等）：在仓库根目录执行 **`apm pull <requirementId>`**，再 **Read** 一次。
+3. **分流（非失败）**：
+   - **无文件、仍读不到、或文件无有效内容**（空文件、仅空白、无实质缺陷条目等；具体结构以同步格式为准）：**不视为步骤失败**。表格步骤 2 填 **跳过（无 defect 内容 → 新功能）**，**直接进入步骤 3**。
+   - **文件存在且有有效内容**：视为本轮为 **修复 Bug 流程**（与步骤 4 同属 Quick 形态，对照 **defect.xml + 必要时 prd.md**，目标是消除所列缺陷）：
+     - 父 Agent 已通过 **Read** 掌握 `defect.xml`；若启动子 Agent，在委派提示中写明 **`requirementId`**、工作项路径、`defect.xml` 路径，以及「逐项对照缺陷列表修复，改动范围最小化」。
+     - 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
+       - 自行 **Read** `.apm/workitems/<requirementId>/defect.xml`（及需要时的 `prd.md`）。
+       - 按缺陷列表直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
+       - 完成后在返回中说明：修了哪些缺陷项、改了哪些路径、本地检查结果（若有）。
+     - 父 Agent 根据子 Agent 返回填写表格步骤 2 **状态**（成功 / 失败）；**失败则按 Guardrails 终止**。
+4. **短路规则**：步骤 2 走 **修复 Bug** 且子 Agent **成功**后：**不再执行步骤 3～5**（表格中步骤 3、4、5 均填 **跳过（缺陷短路）**），直接进入 **步骤 6**（提交与推送）。
+
+---
+
+## 步骤 3：读取 PRD 并评估改动成本
+
+**条件**：仅当步骤 2 **未**以「`defect.xml` **有内容**且 Quick 修 Bug **成功** → 短路至步骤 6」结束时执行（含：`defect.xml` 缺失、拉取后仍无、或**无有效内容**而走新功能流程）。
 
 1. **Read** 全文：`.apm/workitems/<requirementId>/prd.md`。
 2. 若无法读取：在仓库根目录执行 **`apm pull <requirementId>`**（同步工作项），再 **Read** 一次；仍失败则**停止后续实现**，仅在表格中标记失败原因。
@@ -77,36 +97,36 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 - PRD 范围大、条款多，或存在明显「待确认/多方案」需先规划。
 - 评估认为不先产出 **proposal / design / specs / tasks** 则难以保证实现与验收对齐。
 
-在表格「步骤 2」中写明结论：**Quick** 或 **Spec**，以及**一行内**理由（关键词即可）。
+在表格「步骤 3」中写明结论：**Quick** 或 **Spec**，以及**一行内**理由（关键词即可）。
 
 ---
 
-## 步骤 3：Quick 开发模式（子 Agent）
+## 步骤 4：Quick 开发模式（子 Agent）
 
-**条件**：步骤 2 判定为 **Quick**。
+**条件**：步骤 3 判定为 **Quick**（且未走步骤 2 缺陷短路）。
 
 1. 父 Agent 已通过 **Read** 掌握 `prd.md`；若启动新子 Agent，在委派提示中写明 **`requirementId`**、工作项路径、以及「实现须严格对照 PRD，改动范围最小化」。
 2. 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
    - 自行 **Read** `.apm/workitems/<requirementId>/prd.md`（若会话未带全文）。
    - 按 PRD 直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
    - 完成后在返回中说明：改了哪些路径、如何对照验收、是否通过本地可执行的检查（若子 Agent 跑了 `rushx build` / 测试等则写明结果）。
-3. 父 Agent 根据子 Agent 返回在表格中填写步骤 3 **状态**；本模式下步骤 4 填 **跳过**。
+3. 父 Agent 根据子 Agent 返回在表格中填写步骤 4 **状态**；本模式下步骤 5 填 **跳过**。
 
 ---
 
-## 步骤 4：Spec 开发模式（子 Agent）
+## 步骤 5：Spec 开发模式（子 Agent）
 
-**条件**：步骤 2 判定为 **Spec**。
+**条件**：步骤 3 判定为 **Spec**（且未走步骤 2 缺陷短路）。
 
 1. 父 Agent **Read** **apm-propose**、**apm-apply-change** 的 `SKILL.md`（**仅** `.apm/skills/` 下路径，见上节）。
 2. **子 Agent A（规划）**：Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-propose/SKILL.md` 并完整遵循：在 `.apm/workitems/<requirementId>/` 生成 **proposal、design、specs、tasks** 等工件（顺序与依赖以 SKILL 为准）。
 3. **子 Agent B（实现）**：待 A 成功落盘后，再 Task `generalPurpose`，提示其自行 **Read** `.apm/skills/apm-apply-change/SKILL.md` 并完整遵循：按 **`tasks.md`** 驱动实现与勾选；遵守该技能中的停止条件与 commit 约定。
 4. 若 **apm-propose** 未产出可用 **`tasks.md`**，不得强行进入 **apm-apply-change**；表格中标记阻塞原因。
-5. 表格中步骤 3 填 **跳过**；步骤 4 分两行或合并一行写清 propose / apply 状态（见表格模板）。
+5. 表格中步骤 4 填 **跳过**；步骤 5 分两行或合并一行写清 propose / apply 状态（见表格模板）。
 
 ---
 
-## 步骤 5：提交并推送
+## 步骤 6：提交并推送
 
 在仓库根目录执行（可用一条复合命令或分步；以实际仓库远程为准）：
 
@@ -119,9 +139,9 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 
 ---
 
-## 步骤 6：同步产物
+## 步骤 7：同步产物
 
-在**仓库/工作区根目录**（与步骤 1、5 一致）执行：
+在**仓库/工作区根目录**（与步骤 1、6 一致）执行：
 
 ```bash
 apm upload-artifact <requirementId>
@@ -133,18 +153,19 @@ apm upload-artifact <requirementId>
 
 ---
 
-## 步骤 7：对用户回复（表格）
+## 步骤 8：对用户回复（表格）
 
-对用户回复 **必须包含一张 Markdown 表格**，汇总 **步骤 1～6**（步骤 7 为呈现表格本身，可不单独成行）。表头建议：
+对用户回复 **必须包含一张 Markdown 表格**，汇总 **步骤 1～7**（步骤 8 为呈现表格本身，可不单独成行）。表头建议：
 
 | 步骤 | 内容 | 结果 |
 | --- | --- | --- |
 | 1 | `apm branch <requirementId>` | 成功 / 失败（原因） |
-| 2 | 读 PRD + 成本评估 | Quick 或 Spec；一行理由 |
-| 3 | Quick 开发（子 Agent） | 成功 / 失败 / **跳过** |
-| 4 | Spec：apm-propose → apm-apply-change（子 Agent） | 成功 / 失败 / **跳过**；可注明子步骤 |
-| 5 | commit & push；工作区干净 | 成功 / 失败（原因） |
-| 6 | `apm upload-artifact <requirementId>` | 成功 / 失败（原因） |
+| 2 | Read `defect.xml`：无/空→新功能；有内容→Quick 修 Bug（子 Agent） | 跳过（无内容·新功能）/ 成功 / 失败；短路时注明 |
+| 3 | 读 PRD + 成本评估 | Quick 或 Spec；一行理由 / **跳过（缺陷短路）** |
+| 4 | Quick 开发（子 Agent） | 成功 / 失败 / **跳过** |
+| 5 | Spec：apm-propose → apm-apply-change（子 Agent） | 成功 / 失败 / **跳过**；可注明子步骤 |
+| 6 | commit & push；工作区干净 | 成功 / 失败（原因） |
+| 7 | `apm upload-artifact <requirementId>` | 成功 / 失败（原因） |
 
 **可选**：在表格外增加**简短**一句话摘要（例如当前分支名、阻塞点）；若用户此前约定「仅表格」，则可仅输出表格。