ai-project-manage-cli 6.0.41 → 6.0.42

package/dist/index.js

@@ -1211,6 +1211,17 @@ async function runSyncDocument(sessionId, options) {
 }
 
 // src/commands/append-message.ts
+async function appendMessageContent(cfg, messageId, content) {
+  const trimmedId = messageId.trim();
+  if (!trimmedId) {
+    throw new Error("messageId \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  if (!content) {
+    throw new Error("content \u4E0D\u80FD\u4E3A\u7A7A");
+  }
+  const api = createApmApiClient(cfg);
+  await api.cli.appendMessageContent({ id: trimmedId, content });
+}
 async function runAppendMessage(options) {
   const messageId = options.id?.trim();
   if (!messageId) {
@@ -1223,8 +1234,7 @@ async function runAppendMessage(options) {
     process.exit(1);
   }
   const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  await api.cli.appendMessageContent({ id: messageId, content });
+  await appendMessageContent(cfg, messageId, content);
   console.log(`[apm] \u5DF2\u8FFD\u52A0\u6D88\u606F\u5185\u5BB9: ${messageId}`);
 }
 
@@ -1415,7 +1425,10 @@ ${stack}`
 }
 
 // src/commands/connect/cursor-agent.ts
-import { Agent, CursorAgentError } from "@cursor/sdk";
+import {
+  Agent,
+  CursorAgentError
+} from "@cursor/sdk";
 import { setMaxListeners as setMaxListeners2 } from "node:events";
 import { resolve as resolve4 } from "path";
 
@@ -1703,6 +1716,45 @@ async function syncCursorMessageLog(cfg, ctx, events) {
   });
 }
 
+// src/commands/connect/append-message-tool.ts
+function createAppendMessageCustomTools(cfg, messageId) {
+  return {
+    append_message: {
+      description: "\u5411\u5F53\u524D\u4F1A\u8BDD\u6D88\u606F\u8FFD\u52A0\u56DE\u590D\u5185\u5BB9\u3002\u53EF\u591A\u6B21\u8C03\u7528\u8865\u5145\u8FDB\u5C55\uFF1B\u88AB @ \u65F6\u6536\u5230\u540E\u5E94\u5148\u7B80\u77ED\u786E\u8BA4\u518D\u6267\u884C\u4EFB\u52A1\u3002",
+      inputSchema: {
+        type: "object",
+        properties: {
+          content: {
+            type: "string",
+            description: "\u8981\u53D1\u9001\u5230\u7FA4\u91CC\u7684\u56DE\u590D\u5185\u5BB9"
+          }
+        },
+        required: ["content"]
+      },
+      execute: async (args) => {
+        const content = typeof args.content === "string" ? args.content.trim() : "";
+        if (!content) {
+          return {
+            content: [{ type: "text", text: "content \u4E0D\u80FD\u4E3A\u7A7A" }],
+            isError: true
+          };
+        }
+        try {
+          await appendMessageContent(cfg, messageId, content);
+          console.log(`[apm] append_message \u5DF2\u8FFD\u52A0: messageId=${messageId}`);
+          return "\u5DF2\u8FFD\u52A0\u6D88\u606F\u5185\u5BB9";
+        } catch (err) {
+          const detail = err instanceof Error ? err.message : String(err);
+          return {
+            content: [{ type: "text", text: `\u8FFD\u52A0\u6D88\u606F\u5931\u8D25: ${detail}` }],
+            isError: true
+          };
+        }
+      }
+    }
+  };
+}
+
 // src/commands/connect/cursor-agent.ts
 setMaxListeners2(50);
 installAbortSignalDebug();
@@ -1729,8 +1781,7 @@ async function obtainAgent(ctx) {
     apiKey: ctx.apiKey,
     model: { id: ctx.model || "default" },
     local: {
-      cwd: ctx.cwd,
-      settingSources: []
+      cwd: ctx.cwd
     }
   };
   const savedAgentId = ctx.user ? loadSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user) : void 0;
@@ -1798,7 +1849,11 @@ async function runCursorAgent(cfg, ctx, options) {
   signal?.addEventListener("abort", abortRun, { once: true });
   logAbortSignalStats(signal, "runCursorAgent:after-addListener");
   try {
-    const run = await agent.send(prompt);
+    const run = await agent.send(prompt, {
+      local: {
+        customTools: createAppendMessageCustomTools(cfg, ctx.messageId)
+      }
+    });
     activeRun = run;
     logAbortSignalStats(signal, "runCursorAgent:after-send");
     console.log(`[apm] Cursor run id=${run.id} agentId=${agent.agentId}`);
@@ -1993,11 +2048,8 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       () => syncSessionDocuments(cfg, msg.sessionId, workspaceApmDir(msg.workdir))
     );
     await runStep(
-      "commit-documents",
-      () => commitWorkingTreeIfDirty(
-        msg.workdir,
-        "chore(apm): sync session documents"
-      )
+      "commit-files",
+      () => commitWorkingTreeIfDirty(msg.workdir, "chore(apm): commit working tree")
     );
     await runStep(
       "status-success",

package/package.json

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

package/template/AGENTS.md

@@ -8,8 +8,8 @@
 
 1. 读取 `.apm/sessions/<会话ID>/session.yaml`
 2. 读取 `.apm/rules/reply.md`
-3. **立即**用 `apm append-message` 回复（可先简短确认，再补充）
-4. 按需阅读 `docs/` 下的文档，有进展继续 append-message
+3. **立即**用 `append_message` 工具回复（可先简短确认，再补充）
+4. 按需阅读 `docs/` 下的文档，有进展继续调用 `append_message`
 
 #### 重任务（开发、写方案、评审、部署）
 
@@ -19,7 +19,7 @@
 4. 任务有阶段性进展或者任务完成后必须回复消息（具体见规则 `reply.md`）
 5. 写工作日志（具体见规则 `write_doc.md`）
 
-**禁止**在未回复前先读完所有 docs。有进展就先 append-message。
+**禁止**在未回复前先读完所有 docs。有进展就先调用 `append_message`。
 
 ### 目录指引
 

package/template/rules/reply.md

@@ -7,9 +7,9 @@
 
 ## 执行回复的方法
 
-命令: `apm append-message --id=<消息ID> --content=<你要回复的消息内容>`
+调用 `append_message` 工具，`content` 传入你要回复的消息内容。可多次调用补充进展。
 
-示例: apm append-message --id=xxxxx --content="收到，正在分析后端改动范围。"
+示例: `append_message(content="收到，正在分析后端改动范围。")`
 
 ## 写文档的方法
 

package/template/rules/write_doc.md

@@ -16,13 +16,9 @@
 保存位置: .apm/sessions/<会话 ID>/docs/<文件名>
 文档内容格式: 根据你的主题来，不限制，禁止记流水账。
 
-## 在保存完成之后需要同步到远程
+## 文档同步
 
-通过 `apm connect` 连接平台时，每轮 Agent 结束后会自动推送 `docs/` 下变更的 Markdown，一般无需手动同步。
-
-手动同步命令: `apm sync-document <会话 ID> --file=<文档名称>`
-
-示例: `apm sync-document <会话ID> --file=张三-工作日志.md`
+保存到 `docs/` 后，`apm connect` 会在每轮 Agent 结束时自动推送到平台，无需额外操作。
 
 ## 注意事项
 

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

@@ -30,7 +30,7 @@
 - 使用 **Task** 工具，`subagent_type: generalPurpose`，**readonly: false**，委派子 Agent：
   - 按需 **Read** 本端计划文档。
   - 按计划直接改代码；遵守本仓库构建与依赖约定（AGENTS.md）。
-  - **白名单约束**：只改计划白名单内的文件。开发中确需新增文件或改动白名单外文件，先更新计划文档的白名单（写明原因）并同步，再动手；**禁止悄悄越界**。
+  - **白名单约束**：只改计划白名单内的文件。开发中确需新增文件或改动白名单外文件，先更新计划文档的白名单（写明原因），再动手；**禁止悄悄越界**。
   - **Git**：实现与自洽验收通过后，若有代码改动，**立即 `git add` + `git commit` 一次**（Quick 通常为单次交付，**一次实现 = 一个 commit**；勿拆成无意义碎 commit）。提交信息建议包含 `sessionId`（可从 `session.yaml` 获取）与需求摘要。
   - 完成后在返回中说明：改了哪些路径、与白名单的对账结果（逐文件列出）、是否通过本地可执行的检查（若子 Agent 跑了构建/测试则写明结果）；若有 commit，写明 **short-sha** 与 **subject**，无代码改动则注明跳过 commit。
 
@@ -56,4 +56,4 @@
 
 **注意：不做联调。** 前后端各自按 API 契约交付，接口对不上属于契约或实现问题，由 diff 评审与人工验收暴露后打回修复；禁止自行发起「联调」「接口实测」类的开放式动作。
 
-完成后 `apm append-message` 回复：改动概述 + 白名单对账 + 构建结果 + 测试环境地址，并 `@` 评审角色进行 diff 评审。
+完成后用 `append_message` 回复：改动概述 + 白名单对账 + 构建结果 + 测试环境地址，并 `@` 评审角色进行 diff 评审。

package/template/skills/apm-diff-review/SKILL.md

@@ -18,11 +18,11 @@
 
 ### 步骤 2：三项检查
 
-| 检查项 | 判定 |
-|--------|------|
-| **白名单对账** | diff 中出现白名单之外的文件，且计划未更新说明 → **不通过** |
+| 检查项         | 判定                                                                 |
+| -------------- | -------------------------------------------------------------------- |
+| **白名单对账** | diff 中出现白名单之外的文件，且计划未更新说明 → **不通过**           |
 | **需求相关性** | 存在与本需求无关的改动（顺手重构、改格式、动了无关逻辑）→ **不通过** |
-| **计划落实** | 计划「实现步骤」中的关键点在 diff 中找不到对应实现 → **不通过** |
+| **计划落实**   | 计划「实现步骤」中的关键点在 diff 中找不到对应实现 → **不通过**      |
 
 注意事项：
 
@@ -31,13 +31,13 @@
 
 ### 步骤 3：输出结论
 
-**通过**：`apm append-message` 回复评审结论，并 `@项目经理` 交人验收，回复中必须包含：
+**通过**：用 `append_message` 回复评审结论，并 `@项目经理` 交人验收，回复中必须包含：
 
 1. 「diff 评审通过」+ 一句话改动概述；
 2. 测试环境地址（从开发的回复或工作日志中获取）；
 3. 提示按 `CHECKLIST.md` 逐条验收。
 
-**不通过**：`apm append-message` 输出问题清单（每条注明文件 + 问题 + 依据哪条计划/需求），`@` 对应工程师打回修改。**禁止自己动手改。**
+**不通过**：用 `append_message` 输出问题清单（每条注明文件 + 问题 + 依据哪条计划/需求），`@` 对应工程师打回修改。**禁止自己动手改。**
 
 ---
 

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

@@ -2,10 +2,10 @@
 
 后端工程师在需求评审通过后，编写两份文档：
 
-| 文档 | 路径 | 定位 |
-|------|------|------|
+| 文档         | 路径              | 定位                                     |
+| ------------ | ----------------- | ---------------------------------------- |
 | `BACKEND.md` | `docs/BACKEND.md` | **Plan**：后端怎么改、分几步、动哪些文件 |
-| `API.md` | `docs/API.md` | **联调契约**：给前端看的 URL、参数、示例 |
+| `API.md`     | `docs/API.md`     | **联调契约**：给前端看的 URL、参数、示例 |
 
 两份文档禁止合并；`API.md` 不写 Service/SQL 等实现细节。
 
@@ -17,7 +17,7 @@
 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`。
+5. @ 前端阅读 `API.md` 并编写 `FRONTEND.md`。
 
 （模板路径：`.apm/skills/apm-write-backend-api/`）
 
@@ -25,7 +25,7 @@
 
 ## 写作要求
 
-**BACKEND.md**（对齐 Cursor Plan，通常 **30～80 行**）
+**BACKEND.md**（对齐 Cursor Plan，通常 **30 ～ 80 行**）
 
 - 背景 → 实现步骤 → 涉及文件 → 数据与规则 → 验收
 - 可写表名、关键字段；不要大段 SQL、不要完整参数表（那些放 `API.md`）

package/template/skills/apm-write-checklist/SKILL.md

@@ -19,7 +19,7 @@
 
 逐条对照需求原文与计划：
 
-- **计划与需求矛盾、或需求关键点在计划中没有覆盖**：不要写清单，先 `apm append-message` 指出问题并 `@` 对应工程师打回，等计划修订后再写。
+- **计划与需求矛盾、或需求关键点在计划中没有覆盖**：不要写清单，先用 `append_message` 指出问题并 `@` 对应工程师打回，等计划修订后再写。
 - **计划中的「假设」尚未被项目经理确认**：在回复中提醒，但可以先写清单（清单按需求原文出）。
 - 计划覆盖完整：进入步骤 3。
 
@@ -29,13 +29,13 @@
 
 要求：
 
-- **5～15 条**，关键点级别，不写入参出参细节、不写接口路径。
+- **5 ～ 15 条**，关键点级别，不写入参出参细节、不写接口路径。
 - 每条 = 在哪个页面、做什么操作、预期看到什么。
 - 必须覆盖：需求的每个功能点至少 1 条、关键互斥/边界规则至少 1 条、对既有功能的回归至少 1 条（确认没改坏原有逻辑）。
 
-### 步骤 4：同步并回复
+### 步骤 4：回复
 
-执行 `apm sync-document <会话ID> --file=CHECKLIST.md`，回复消息说明清单已就绪，可进入开发。
+回复消息说明清单已就绪，可进入开发。
 
 ## 何时使用
 

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

@@ -11,7 +11,7 @@
 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`，回复消息通知可进入开发。
+4. 回复消息通知可进入开发。
 
 ---
 

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

@@ -6,10 +6,10 @@
 
 本技能合并了原 `apm-write-prd`、`apm-review`、`apm-write-frontend-plan`、`apm-write-backend-api` 四个技能的职能：评审（判断是否参与、发现口径缺口）和方案（怎么改、改哪些文件）一步完成。
 
-| 角色 | 产出文档 | 路径 |
-|------|----------|------|
-| 后端 | `BACKEND-PLAN.md`（含「API 契约」章节） | `docs/BACKEND-PLAN.md` |
-| 前端 | `FRONTEND-PLAN.md` | `docs/FRONTEND-PLAN.md` |
+| 角色 | 产出文档                                | 路径                    |
+| ---- | --------------------------------------- | ----------------------- |
+| 后端 | `BACKEND-PLAN.md`（含「API 契约」章节） | `docs/BACKEND-PLAN.md`  |
+| 前端 | `FRONTEND-PLAN.md`                      | `docs/FRONTEND-PLAN.md` |
 
 ---
 
@@ -19,7 +19,7 @@
 
 **Read** `.apm/sessions/<会话ID>/TASK.md`（必要时结合群消息中项目经理的补充说明）。
 
-- **不涉及本端改动**：立即 `apm append-message` 回复「本需求与前端/后端无关，理由：xxx」（一句话说明理由），**流程到此结束，禁止写任何文档、禁止改任何代码**。
+- **不涉及本端改动**：立即用 `append_message` 回复「本需求与前端/后端无关，理由：xxx」（一句话说明理由），**流程到此结束，禁止写任何文档、禁止改任何代码**。
 - **涉及本端改动**：进入步骤 2。
 
 ### 步骤 2：有限调研（必须遵守预算）
@@ -36,19 +36,19 @@
 2. **改动文件白名单**：本次允许改动的文件完整列表。后续开发与 diff 评审都以此为准，**开发时改了白名单之外的文件会被打回**。
 3. **后端专属——API 契约**：给前端看的接口定义（Path、参数、响应示例、错误码）。前端开发以契约为准，不等后端部署完成。
 
-### 步骤 4：同步文档并回复
+### 步骤 4：回复
 
-1. 执行 `apm sync-document <会话ID> --file=<文档名>`。
-2. 回复消息（遵守 `reply.md`）：
-   - **「假设」章节非空**：把假设逐条列进回复内容，`@项目经理` 请其确认；明确说「以上假设确认前不开始开发」。
-   - **无假设**：回复计划已就绪，可进入测试要点编写。
-   - 前端计划依赖的接口后端契约还没出：在计划「期望接口」小节写出前端期望的接口形态，回复时 `@后端` 对齐，不要空等。
+回复消息（遵守 `reply.md`）：
+
+- **「假设」章节非空**：把假设逐条列进回复内容，`@项目经理` 请其确认；明确说「以上假设确认前不开始开发」。
+- **无假设**：回复计划已就绪，可进入测试要点编写。
+- 前端计划依赖的接口后端契约还没出：在计划「期望接口」小节写出前端期望的接口形态，回复时 `@后端` 对齐，不要空等。
 
 ---
 
 ## 写作要求
 
-- 篇幅 **40～100 行**，宁可少写；不要伪代码、不要大段 SQL。
+- 篇幅 **40 ～ 100 行**，宁可少写；不要伪代码、不要大段 SQL。
 - 用产品语言描述行为，文件路径只出现在「改动文件白名单」。
 - 前后端可同轮并行编写计划，不互相阻塞。
 

package/template/skills/apm-write-prd/SKILL.md

@@ -12,7 +12,3 @@
 **不管是第几版需求，都要当成第一版来看，禁止有历史版本或者修订版本或者第几版更新的字样**
 
 **可读性**：信息完整保留，但避免整段只靠长句堆砌。对流程分支、状态条件、按钮对照、范围边界等多步骤/多条件内容，按模板中的「图示原则」**适当补充 Mermaid 图或简表**（每个需求点 0 ～ 1 张）；图示用于快速扫读，**可验收细节仍以 bullet 为准**，不得因配图而删减文字要求。
-
-### 步骤 3: 同步 PRD 到远程
-
-执行命令：`apm sync-document <会话 ID> --file=PRD.md`