ai-project-manage-cli 6.0.29 → 6.0.30

package/dist/index.js

@@ -1102,9 +1102,72 @@ function validateAgentWsMessage(value, kind) {
   };
 }
 
+// src/commands/connect/abort-signal-debug.ts
+import {
+  getEventListeners,
+  getMaxListeners,
+  setMaxListeners
+} from "node:events";
+function isAbortSignalDebugEnabled() {
+  const v = process.env.APM_DEBUG_ABORT_SIGNAL?.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes";
+}
+function formatAbortSignalStats(signal, label) {
+  if (!signal) {
+    return `[apm:abort-debug] ${label}: (no signal)`;
+  }
+  const listeners = getEventListeners(signal, "abort");
+  const max = getMaxListeners(signal);
+  return `[apm:abort-debug] ${label}: abortListeners=${listeners.length} maxListeners=${max} aborted=${signal.aborted}`;
+}
+function logAbortSignalStats(signal, label) {
+  if (!isAbortSignalDebugEnabled()) return;
+  console.log(formatAbortSignalStats(signal, label));
+}
+var installed = false;
+function installAbortSignalDebug() {
+  if (!isAbortSignalDebugEnabled() || installed) return;
+  installed = true;
+  const maxFromEnv = Number.parseInt(
+    process.env.APM_ABORT_SIGNAL_MAX_LISTENERS ?? "",
+    10
+  );
+  if (Number.isFinite(maxFromEnv) && maxFromEnv > 0) {
+    setMaxListeners(maxFromEnv);
+    console.log(
+      `[apm:abort-debug] setMaxListeners(${maxFromEnv}) via APM_ABORT_SIGNAL_MAX_LISTENERS`
+    );
+  }
+  process.on("warning", (warning) => {
+    if (warning.name !== "MaxListenersExceededWarning") return;
+    console.warn(`[apm:abort-debug] ${warning.name}: ${warning.message}`);
+    if (warning.stack) {
+      console.warn(warning.stack);
+    }
+  });
+  const proto = AbortSignal.prototype;
+  const original = proto.addEventListener;
+  proto.addEventListener = function(type, listener, options) {
+    if (type === "abort") {
+      const sig = this;
+      const before = getEventListeners(sig, "abort").length;
+      const max = getMaxListeners(sig);
+      const stack = new Error("[apm:abort-debug] addEventListener stack").stack?.split("\n").slice(2, 8).join("\n") ?? "";
+      console.log(
+        `[apm:abort-debug] addEventListener("abort") before=${before} max=${max}
+${stack}`
+      );
+    }
+    return original.call(this, type, listener, options);
+  };
+  console.log(
+    "[apm:abort-debug] \u5DF2\u542F\u7528 AbortSignal \u8C03\u8BD5\uFF08APM_DEBUG_ABORT_SIGNAL\uFF09"
+  );
+}
+
 // src/commands/connect/cursor-agent.ts
 import { Agent, CursorAgentError } from "@cursor/sdk";
-import { setMaxListeners } from "node:events";
+import { setMaxListeners as setMaxListeners2 } from "node:events";
 import { resolve as resolve3 } from "path";
 
 // src/session-utils.ts
@@ -1340,7 +1403,8 @@ async function syncCursorMessageLog(cfg, ctx, events) {
 }
 
 // src/commands/connect/cursor-agent.ts
-setMaxListeners(50);
+setMaxListeners2(50);
+installAbortSignalDebug();
 var logCtx = (ctx, agentId) => ({
   sessionId: ctx.sessionId,
   messageId: ctx.messageId,
@@ -1348,6 +1412,7 @@ var logCtx = (ctx, agentId) => ({
 });
 async function runCursorAgent(cfg, ctx, options) {
   const signal = options?.signal;
+  logAbortSignalStats(signal, "runCursorAgent:start");
   if (signal?.aborted) {
     throw new Error("\u8FDE\u63A5\u5DF2\u5173\u95ED\uFF0C\u4EFB\u52A1\u4E2D\u65AD");
   }
@@ -1386,9 +1451,11 @@ async function runCursorAgent(cfg, ctx, options) {
     void activeRun.cancel().catch(() => void 0);
   };
   signal?.addEventListener("abort", abortRun, { once: true });
+  logAbortSignalStats(signal, "runCursorAgent:after-addListener");
   try {
     const run = await agent.send(prompt);
     activeRun = run;
+    logAbortSignalStats(signal, "runCursorAgent:after-send");
     console.log(`[apm] Cursor run id=${run.id} agentId=${agent.agentId}`);
     for await (const event of run.stream()) {
       if (signal?.aborted) {
@@ -1415,7 +1482,9 @@ async function runCursorAgent(cfg, ctx, options) {
     }
     throw err;
   } finally {
+    logAbortSignalStats(signal, "runCursorAgent:finally-before-cleanup");
     signal?.removeEventListener("abort", abortRun);
+    logAbortSignalStats(signal, "runCursorAgent:finally-after-cleanup");
     await agent[Symbol.asyncDispose]();
   }
 }
@@ -1541,7 +1610,12 @@ async function runConnect(options) {
     const shutdown = async (code = 0) => {
       if (shuttingDown) return;
       shuttingDown = true;
+      logAbortSignalStats(
+        shutdownAbort.signal,
+        "connect:shutdown-before-abort"
+      );
       shutdownAbort.abort();
+      logAbortSignalStats(shutdownAbort.signal, "connect:shutdown-after-abort");
       stopHeartbeat?.();
       if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
         ws.terminate();

package/package.json

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

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

@@ -3,7 +3,7 @@
 ### 步骤 1: 获取当前版本 PRD 的内容以及协作内容
 
 1. 用 **Read** 工具阅读 `.apm/sessions/<会话ID>/docs/PRD.md`，如果不存在则开发失败，退出流程。
-2. 按需阅读 `.apm/sessions/<会话ID>/docs`下的其他文档，比如前后端联调的文档
+2. 按需阅读 `.apm/sessions/<会话ID>/docs` 下其他文档：前端对照 `FRONTEND.md` + `API.md`，后端对照 `BACKEND.md` + `API.md`
 
 ### 步骤 2: 明确开发模式
 

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

@@ -0,0 +1,77 @@
+## 工作流程
+
+### 步骤 1：确认身份
+
+1. 用 **Read** 工具阅读 `.apm/sessions/<会话ID>/session.yaml`
+2. 从 `members` 中找到与**当前角色**对应的 `name` 和 `expert`（以 session.yaml 为准，不要猜）
+3. 若无法确定自己的 `name`，停止流程并在回复中说明
+
+### 步骤 2：提取本人发言
+
+1. 用 **Read** 工具阅读 `.apm/sessions/<会话ID>/messages.xml`
+2. 只保留 `name="<本人 name>"` 的 `<message>` 条目
+3. 跳过 `content` 为空或仅有空白的内容
+4. 按 `round` 属性升序排列（无 `round` 的放在最后）
+5. 若有效消息少于 1 条，停止流程并在回复中说明「消息不足，无法复盘」及缺什么
+
+**messages.xml 过大时**：优先保留带 `round` 的消息；单条 `content` 超过 3000 字时，保留开头结论段与结尾总结段，中间用「…（已省略）…」代替，不要丢弃关键口径。
+
+### 步骤 3：补充任务背景（按需）
+
+1. 用 **Read** 工具阅读 `.apm/sessions/<会话ID>/TASK.md`
+2. 若存在 `docs/PRD.md`，Read 它，用于锚定「这次在解决什么业务问题」
+3. 按需 Read `docs/` 下与本人产出相关的文档（如技术方案、评审意见），**不要**把全文复制进复盘
+
+### 步骤 4：生成经验 Skill 草稿
+
+1. 用 **Read** 工具阅读 `.apm/skills/apm-recap/recap-template.md`
+2. 严格按模板结构撰写，Write 到 `.apm/sessions/<会话ID>/docs/<name>-复盘技能.md`
+3. 文件名中的 `<name>` 与 session.yaml 中的 `name` 完全一致（含中文）
+
+**内容原则**：
+
+- 只基于步骤 2 ～ 3 的实际材料归纳，**禁止编造**未出现过的决策或产出
+- 写**可复用的经验**（口径、做法、踩坑），**禁止**按轮次记流水账（不要写「第 N 轮我…」）
+- **产品语言优先**；必要时后端可写表名 / 主表字段名，但避免大段代码、文件路径、组件名
+- 只复盘**本人**贡献；他人工作仅可在「协作依赖」中简要提及，不得代写
+
+### 步骤 5：拟定平台 Skill 元数据
+
+在草稿文件**最顶部**写入元数据块（格式见 recap-template.md），包含：
+
+- `skill_name`：建议 `recap-<expert-key>-<topic-slug>`（英文小写、连字符；topic 取自任务主题，非 sessionId）
+- `skill_description`：第三人称，说明适用场景与触发词，便于下次任务时被发现
+- `merge_strategy`：同业务域已有 Skill 时填 `upsert`，全新领域填 `create`
+
+**expert-key 参考**（按 session.yaml 的 expert 映射）：
+
+| expert     | expert-key |
+| ---------- | ---------- |
+| 产品经理   | pm         |
+| 前端工程师 | frontend   |
+| 后端工程师 | backend    |
+| 全栈工程师 | fullstack  |
+| 项目经理   | pm-lead    |
+
+### 步骤 6：回复消息
+
+回复中须包含：
+
+1. 草稿路径：`.apm/sessions/<会话ID>/docs/<name>-复盘技能.md`
+2. 建议的 `skill_name` 与 `skill_description`（与元数据块一致）
+3. 本次复盘摘要（3 ～ 5 条 bullet，概括解决了哪些口径/问题）
+4. 发布提醒：草稿需由管理员发布到平台 **Skills** 后，执行 `apm update-skills`，其他会话中的同角色成员方可 Read 该经验技能
+
+---
+
+## 约束
+
+- 本技能只生成**草稿**；Agent 无法直接写入平台 Skill 库或 `.apm/skills/`
+- 不得修改他人已写的 `docs/*-复盘技能.md`
+- 若 TASK/PRD 与 messages 矛盾，以**本人实际发言**为准，并在「已知踩坑」中注明口径尚未统一
+
+## 何时使用本技能
+
+- 用户或项目经理要求复盘、总结、沉淀经验
+- 会话即将归档，需要将本次贡献转化为可复用技能
+- 任务阶段性完成，角色主动沉淀领域知识

package/template/skills/apm-recap/recap-template.md

@@ -0,0 +1,121 @@
+## 复盘技能模板
+
+生成 `.apm/sessions/<会话ID>/docs/<name>-复盘技能.md` 时，**完整文件**须包含下方「元数据块 + 正文」两部分。
+
+---
+
+### 元数据块（写在文件最顶部）
+
+```markdown
+---
+skill_name: recap-<expert-key>-<topic-slug>
+skill_description: <第三人称描述：谁在什么业务域的经验；什么需求场景下应阅读本技能。含 2～4 个触发关键词。>
+expert: <session.yaml 中的 expert，如「后端工程师」>
+member: <session.yaml 中的 name，如「医务小朱」>
+source_session: <会话 ID>
+merge_strategy: upsert
+generated_at: <YYYY-MM-DD>
+---
+```
+
+**skill_name 示例**：
+
+- `recap-backend-death-patient-list`
+- `recap-frontend-death-patient-list`
+- `recap-pm-medical-record-check`
+
+**skill_description 示例**：
+
+> 医务小朱在死亡患者列表选择界面项目中的后端经验。处理死亡患者筛选、病历检查、HIS 列表接口相关需求时使用。
+
+---
+
+### 正文骨架（元数据块之后）
+
+```markdown
+## 适用场景
+
+- <什么业务、什么页面、什么类型的需求应读本技能>
+- <2 ～ 3 条，每条一句，可验收>
+
+## 任务背景
+
+<1 ～ 3 句：本次任务要解决什么；不写轮次过程>
+
+## 已解决的口径与决策
+
+<!-- 产品/技术结论，可直接当下次任务的规范 -->
+
+### <决策点 1 简短名称>
+
+- **结论**：…
+- **依据**：…（可引用 PRD 行号或本人发言中的要点，不要贴大段原文）
+
+### <决策点 2>
+
+- **结论**：…
+- **依据**：…
+
+## 可复用做法
+
+<!-- 步骤、检查清单、评审要点——下次同类任务可直接照做 -->
+
+1. …
+2. …
+
+## 已知踩坑与协作依赖
+
+### 踩坑
+
+- …
+
+### 协作依赖
+
+- **<其他角色名>**：…（仅写与本人工作相关的交接点）
+
+## 关联产出
+
+<!-- 只列文件名，不贴全文 -->
+
+- `PRD.md` / `TASK.md` / `<角色>-技术方案.md` / …
+
+## 来源
+
+- 会话：<source_session>
+- 角色：<member>（<expert>）
+- 生成：<generated_at>
+```
+
+---
+
+### 编写规范
+
+| 类型       | 写法要点                                                    |
+| ---------- | ----------------------------------------------------------- |
+| 口径/决策  | 写清「是什么 + 为什么」，避免「讨论过」「沟通过」等空泛表述 |
+| 可复用做法 | 用动词开头（确认、校验、先…再…），可当作 checklist          |
+| 踩坑       | 写「不要…」「注意…」，说明后果或触发条件                    |
+| 协作依赖   | 只写阻塞或交接点，不写他人完整方案                          |
+| 禁止       | 轮次叙事、聊天记录摘要、大段代码、组件/文件路径堆砌         |
+
+### 质量自检（写入前逐项确认）
+
+- [ ] 元数据块完整，`skill_name` 为英文 slug
+- [ ] 「适用场景」陌生人能判断要不要读
+- [ ] 「已解决的口径与决策」至少 1 条，且来自本人 messages 或 docs
+- [ ] 全文无「第 N 轮」字样
+- [ ] 无编造：材料中没有的内容未写入
+
+### 合并已有 Skill 时（merge_strategy: upsert）
+
+若平台已存在同名 `skill_name` 的 Skill，生成草稿时在正文最末追加：
+
+```markdown
+## 合并说明
+
+- 本次新增：<bullet 列表>
+- 本次修正：<bullet 列表，旧口径 → 新口径>
+- 建议保留不变：<bullet 列表>
+```
+
+管理员发布时对照合并说明更新平台 Skill 正文。

package/template/skills/apm-write-backend-api/SKILL.md

@@ -0,0 +1,40 @@
+## 适用范围
+
+后端工程师在需求评审通过后，编写两份文档：
+
+| 文档 | 路径 | 定位 |
+|------|------|------|
+| `BACKEND.md` | `docs/BACKEND.md` | **Plan**：后端怎么改、分几步、动哪些文件 |
+| `API.md` | `docs/API.md` | **联调契约**：给前端看的 URL、参数、示例 |
+
+两份文档禁止合并；`API.md` 不写 Service/SQL 等实现细节。
+
+---
+
+## 工作流程
+
+1. **Read** `docs/PRD.md`；不存在则退出。
+2. 按需调研代码库，确认现网接口与表结构。
+3. **Read** `backend-template.md`，按模板 **Write** `docs/BACKEND.md`。
+4. **Read** `api-template.md`，按模板 **Write** `docs/API.md`。
+5. 执行 `apm sync-document` 同步两份文档，@ 前端阅读 `API.md` 并编写 `FRONTEND.md`。
+
+（模板路径：`.apm/skills/apm-write-backend-api/`）
+
+---
+
+## 写作要求
+
+**BACKEND.md**（对齐 Cursor Plan，通常 **30～80 行**）
+
+- 背景 → 实现步骤 → 涉及文件 → 数据与规则 → 验收
+- 可写表名、关键字段；不要大段 SQL、不要完整参数表（那些放 `API.md`）
+
+**API.md**
+
+- 写清前端联调所需：Path、参数、示例、联调注意点
+- 不复制 `BACKEND.md` 的实现步骤
+
+## 何时使用
+
+协作流程阶段 3；或用户要求写 `BACKEND.md` / `API.md`。

package/template/skills/apm-write-backend-api/api-template.md

@@ -0,0 +1,35 @@
+# API.md 模板
+
+给前端联调用。实现步骤见 `BACKEND.md`；本文只写契约，篇幅尽量克制。
+
+```markdown
+# <功能名称> — 接口
+
+## 背景
+
+<1～2 句：本次新增/变更/复用哪些接口>
+
+## <接口名称>（新增）
+
+- **GET** `/实际/path`
+- **用途**：…
+- **参数**：`pageNo`、`pageSize`（可选，默认 …）；`xxx`（何时传、何时不传）
+- **成功**：`result` 结构简述 + 简短 JSON 示例
+- **失败**：格式非法 → `message` 示例；无数据 → 空列表算成功
+
+## <接口名称>（现网，不变）
+
+- **GET** `/实际/path/{id}`
+- **用途**：…
+- **前端关注字段**：`fieldA` → 模板 xxx
+
+## 联调说明
+
+1. 首屏：只传 …
+2. 筛选：…
+3. 选中后：必须先调详情，禁止 …
+```
+
+## 不要写
+
+SQL、Java 类路径、Service 实现、后端验收清单。

package/template/skills/apm-write-backend-api/backend-template.md

@@ -0,0 +1,41 @@
+# Plan 模板（BACKEND.md）
+
+对齐 Cursor Plan：背景 → 实现步骤 → 涉及文件 → 数据与规则 → 验收。全文尽量一页以内。
+
+```markdown
+# <功能名称>
+
+## 背景
+
+<2 ～ 3 句：交付什么能力、改哪些模块、现网什么保持不变>
+
+## 实现步骤
+
+1. <例如：新增 VO，字段来自哪张表>
+2. <例如：Service 组装查询条件、分页>
+3. <例如：Mapper/SQL，关联哪张表>
+4. <例如：Controller 新增端点；路由顺序等约束>
+5. <例如：复用现网某方法，保持详情接口不变>
+
+## 涉及文件
+
+- `<路径>` — <新增/修改，一句话>
+- `<路径>` — <…>
+
+## 数据与规则
+
+（几条 bullet，不写长表）
+
+- 数据源：`<表名>`，关键字段 …
+- 筛选：默认范围 …；与 `deathMonth`、住院号 AND …
+- 注意：<易错点，如固定路径须写在 `{id}` 路由之前>
+
+## 验收
+
+- [ ] <接口行为可对照 PRD 检查>
+- [ ] <…>
+```
+
+## 不要写
+
+完整接口参数表、JSON 示例、大段 SQL、mermaid、风险大表——参数示例放 `API.md`，实现细节开发时再展开。

package/template/skills/apm-write-frontend-plan/SKILL.md

@@ -0,0 +1,27 @@
+## 适用范围
+
+前端工程师在 `API.md` 就绪后，编写 `.apm/sessions/<会话ID>/docs/FRONTEND.md`。
+
+这是一份 **Plan**（实现计划），不是技术方案：说清楚改什么、分几步做、动哪些文件；接口细节读 `API.md`，代码细节留给 `apm-dev`。
+
+---
+
+## 工作流程
+
+1. **Read** `docs/PRD.md`、`docs/API.md`；`API.md` 不存在则退出并 @ 后端。
+2. 按需调研代码库，确认改动入口。
+3. **Read** `.apm/skills/apm-write-frontend-plan/plan-template.md`，按模板 **Write** `docs/FRONTEND.md`。
+4. 执行 `apm sync-document <会话ID> --file=FRONTEND.md`，回复消息通知可进入开发。
+
+---
+
+## 写作要求
+
+- 篇幅宜短（通常 **30 ～ 80 行**），宁可少写，不要铺表、不要伪代码。
+- 接口只写「何时调、关键点」，不复制 `API.md`。
+- 产品语言描述交互；文件路径只出现在「涉及文件」。
+- 禁止流水账。
+
+## 何时使用
+
+协作流程阶段 3；或用户要求写 `FRONTEND.md`。

package/template/skills/apm-write-frontend-plan/plan-template.md

@@ -0,0 +1,40 @@
+# Plan 模板
+
+对齐 Cursor Plan：背景 → 实现步骤 → 涉及文件 → 接口要点 → 验收。全文尽量一页以内。
+
+```markdown
+# <功能名称>
+
+## 背景
+
+<2 ～ 3 句：要做什么、限定在哪个页面/场景、现网什么保持不变>
+
+## 实现步骤
+
+1. <第一步：例如新增某弹窗组件，负责什么交互>
+2. <第二步：例如改某页面条件分支，触发条件是什么>
+3. <第三步：对接 API.md 中的某某接口，调用时机>
+4. <第四步：回填/校验/联调>
+
+## 涉及文件
+
+- `<路径>` — <改什么>
+- `<路径>` — <改什么>
+
+## 接口
+
+（不复制 API.md；几条 bullet 即可）
+
+- 列表：<何时请求、首屏传什么>
+- 详情：<选中后怎么走>
+- 注意：<禁止用列表数据代替详情等，引用 API.md 章节>
+
+## 验收
+
+- [ ] <对照 PRD 的可检查项>
+- [ ] <…>
+```
+
+## 不要写
+
+伪代码、参数表、JSON 示例、mermaid（除非步骤说不清）、风险大表、模块拆分专章。