ai-project-manage-cli 6.0.41 → 6.0.43

package/dist/index.js

@@ -127,6 +127,13 @@ function resolveWorkdirPath(cwd = process.cwd()) {
     return normalizeWorkdirPath(absolute);
   }
 }
+function requireRemoteWorkdir(workdir) {
+  const trimmed = typeof workdir === "string" ? workdir.trim() : "";
+  if (!trimmed) {
+    throw new Error("[apm] \u8FDC\u7A0B\u6D88\u606F\u7F3A\u5C11\u5DE5\u4F5C\u76EE\u5F55 workdir");
+  }
+  return resolveWorkdirPath(trimmed);
+}
 
 // src/command-utils.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
@@ -611,7 +618,7 @@ async function runBranch(sessionId, options = {}) {
 
 // src/commands/pull.ts
 import { writeFileSync as writeFileSync6 } from "fs";
-import { dirname as dirname2, join as join7 } from "path";
+import { join as join7 } from "path";
 import { stringify as yamlStringify } from "yaml";
 
 // src/session-messages-xml.ts
@@ -908,13 +915,7 @@ async function syncPlatformRules(cfg, sessionId, workdirPath, apmRoot) {
 }
 
 // src/commands/pull.ts
-function resolvePullWorkdir(apmRoot) {
-  if (apmRoot) {
-    return resolveWorkdirPath(dirname2(apmRoot));
-  }
-  return resolveWorkdirPath();
-}
-async function runPull(sessionId, apmRoot) {
+async function runPull(sessionId, remoteWorkdir) {
   const trimmedId = sessionId.trim();
   if (!trimmedId) {
     console.error("[apm] sessionId \u4E0D\u80FD\u4E3A\u7A7A");
@@ -922,6 +923,8 @@ async function runPull(sessionId, apmRoot) {
   }
   const cfg = await ensureLoggedConfig();
   const api = createApmApiClient(cfg);
+  const workdir = remoteWorkdir === void 0 ? resolveWorkdirPath() : requireRemoteWorkdir(remoteWorkdir);
+  const apmRoot = workspaceApmDir(workdir);
   const [detail, members, documents, attachments, messages] = await Promise.all(
     [
       api.cli.sessionDetail({ sessionId: trimmedId }),
@@ -976,8 +979,7 @@ async function runPull(sessionId, apmRoot) {
     "utf8"
   );
   await syncSessionAttachments(cfg, trimmedId, attachments, apmRoot);
-  const workdirPath = resolvePullWorkdir(apmRoot);
-  await syncPlatformRules(cfg, trimmedId, workdirPath, apmRoot);
+  await syncPlatformRules(cfg, trimmedId, workdir, apmRoot);
   console.log(`[apm] \u5DF2\u540C\u6B65\u4F1A\u8BDD\u5DE5\u4F5C\u533A: ${dir}`);
   return dir;
 }
@@ -987,12 +989,12 @@ import { spawnSync } from "child_process";
 
 // src/version.ts
 import { readFileSync as readFileSync5 } from "fs";
-import { dirname as dirname3, join as join8 } from "path";
+import { dirname as dirname2, join as join8 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 var CLI_PACKAGE_NAME = "ai-project-manage-cli";
 function readCliVersion() {
   try {
-    const dir = dirname3(fileURLToPath2(import.meta.url));
+    const dir = dirname2(fileURLToPath2(import.meta.url));
     const pkgPath = join8(dir, "..", "package.json");
     const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
@@ -1211,6 +1213,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 +1236,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,9 +1427,11 @@ ${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";
 
 // src/session-utils.ts
 var EventSession = class {
@@ -1579,7 +1593,7 @@ ${JSON.stringify(event, null, 2)}
 
 // src/commands/connect/agent-session-registry.ts
 import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync7, writeFileSync as writeFileSync7 } from "node:fs";
-import { dirname as dirname4, resolve as resolve3 } from "node:path";
+import { dirname as dirname3, resolve as resolve3 } from "node:path";
 function registryPath(workdir, sessionId) {
   return resolve3(workdir, ".apm", "sessions", sessionId, "cursor-agents.json");
 }
@@ -1605,7 +1619,7 @@ function readRegistry(path10) {
   return {};
 }
 function writeRegistry(path10, registry) {
-  mkdirSync5(dirname4(path10), { recursive: true });
+  mkdirSync5(dirname3(path10), { recursive: true });
   writeFileSync7(path10, `${JSON.stringify(registry, null, 2)}
 `, "utf8");
 }
@@ -1703,6 +1717,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 +1782,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;
@@ -1765,16 +1817,16 @@ async function runCursorAgent(cfg, ctx, options) {
   if (!apiKey) {
     throw new Error("\u7F3A\u5C11 apiKey\uFF0C\u65E0\u6CD5\u8C03\u7528 Cursor SDK");
   }
-  const cwd = resolve4(ctx.workdir);
+  const workdir = resolveWorkdirPath(ctx.workdir);
   const prompt = ctx.prompt;
   console.log(
-    `[apm] Cursor Agent \u5F00\u59CB messageId=${ctx.messageId} sessionId=${ctx.sessionId} cwd=${cwd}`
+    `[apm] Cursor Agent \u5F00\u59CB messageId=${ctx.messageId} sessionId=${ctx.sessionId} cwd=${workdir}`
   );
   const { agent, resumed } = await obtainAgent({
     apiKey,
     model: ctx.model,
-    cwd,
-    workdir: ctx.workdir,
+    cwd: workdir,
+    workdir,
     sessionId: ctx.sessionId,
     user: ctx.user
   });
@@ -1798,7 +1850,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}`);
@@ -1829,7 +1885,7 @@ async function runCursorAgent(cfg, ctx, options) {
       });
       console.error(`[apm] ${failureMessage}`);
       if (resumed) {
-        clearSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user);
+        clearSessionAgentId(workdir, ctx.sessionId, ctx.user);
       }
       throw new Error(failureMessage);
     }
@@ -1840,7 +1896,7 @@ async function runCursorAgent(cfg, ctx, options) {
   } catch (err) {
     if (err instanceof CursorAgentError) {
       if (resumed) {
-        clearSessionAgentId(ctx.workdir, ctx.sessionId, ctx.user);
+        clearSessionAgentId(workdir, ctx.sessionId, ctx.user);
       }
       throw new Error(
         `Cursor \u542F\u52A8\u5931\u8D25: ${err.message}${err.isRetryable ? "\uFF08\u53EF\u91CD\u8BD5\uFF09" : ""}`
@@ -1857,23 +1913,27 @@ async function runCursorAgent(cfg, ctx, options) {
 
 // src/commands/connect/pre-step-cache.ts
 var PULL_TTL_MS = 3e4;
-var lastBranchSessionId = null;
-var lastPullAtBySession = /* @__PURE__ */ new Map();
-function shouldRunBranch(sessionId) {
-  return lastBranchSessionId !== sessionId;
+function sessionWorkdirKey(sessionId, workdir) {
+  return `${sessionId}\0${workdir}`;
 }
-function markBranchDone(sessionId) {
-  lastBranchSessionId = sessionId;
+var lastBranchKey = null;
+var lastPullAtByKey = /* @__PURE__ */ new Map();
+function shouldRunBranch(sessionId, workdir) {
+  return lastBranchKey !== sessionWorkdirKey(sessionId, workdir);
 }
-function shouldRunPull(sessionId) {
-  const last = lastPullAtBySession.get(sessionId);
+function markBranchDone(sessionId, workdir) {
+  lastBranchKey = sessionWorkdirKey(sessionId, workdir);
+}
+function shouldRunPull(sessionId, workdir) {
+  const key = sessionWorkdirKey(sessionId, workdir);
+  const last = lastPullAtByKey.get(key);
   if (last == null) {
     return true;
   }
   return Date.now() - last >= PULL_TTL_MS;
 }
-function markPullDone(sessionId) {
-  lastPullAtBySession.set(sessionId, Date.now());
+function markPullDone(sessionId, workdir) {
+  lastPullAtByKey.set(sessionWorkdirKey(sessionId, workdir), Date.now());
 }
 
 // src/commands/connect/run-slot-pool.ts
@@ -1886,10 +1946,10 @@ function createRunSlotPool(maxConcurrent = DEFAULT_MAX_CONCURRENT) {
       active += 1;
       return Promise.resolve();
     }
-    return new Promise((resolve6) => {
+    return new Promise((resolve5) => {
       waiters.push(() => {
         active += 1;
-        resolve6();
+        resolve5();
       });
     });
   };
@@ -1923,6 +1983,8 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
   if (isUserCancelled(ctx)) return;
   if (signal.aborted) return;
   const messageId = msg.messageId;
+  const workdir = requireRemoteWorkdir(msg.workdir);
+  const apmRoot = workspaceApmDir(workdir);
   const runStep = async (step, fn) => {
     const startedAt = Date.now();
     try {
@@ -1940,24 +2002,18 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       "status-typing",
       () => updateMessageStatus(cfg, messageId, "TYPING")
     );
-    if (shouldRunBranch(msg.sessionId)) {
+    if (shouldRunBranch(msg.sessionId, workdir)) {
       if (signal.aborted) return;
-      await runStep(
-        "branch",
-        () => runBranch(msg.sessionId, { cwd: msg.workdir })
-      );
-      markBranchDone(msg.sessionId);
+      await runStep("branch", () => runBranch(msg.sessionId, { cwd: workdir }));
+      markBranchDone(msg.sessionId, workdir);
     } else {
       console.log(`[apm] step=branch skipped sessionId=${msg.sessionId}`);
     }
     let pullRan = false;
-    if (shouldRunPull(msg.sessionId)) {
+    if (shouldRunPull(msg.sessionId, workdir)) {
       if (signal.aborted) return;
-      await runStep(
-        "pull",
-        () => runPull(msg.sessionId, workspaceApmDir(msg.workdir))
-      );
-      markPullDone(msg.sessionId);
+      await runStep("pull", () => runPull(msg.sessionId, workdir));
+      markPullDone(msg.sessionId, workdir);
       pullRan = true;
     } else {
       console.log(`[apm] step=pull skipped sessionId=${msg.sessionId}`);
@@ -1966,7 +2022,7 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
       if (signal.aborted) return;
       await runStep(
         "commit-pull",
-        () => commitWorkingTreeIfDirty(msg.workdir, "fix: apm pull")
+        () => commitWorkingTreeIfDirty(workdir, "fix: apm pull")
       );
     } else {
       console.log(`[apm] step=commit-pull skipped sessionId=${msg.sessionId}`);
@@ -1982,7 +2038,7 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
           prompt: msg.content,
           model: msg.model,
           apiKey: msg.apiKey,
-          workdir: msg.workdir,
+          workdir,
           user: msg.user
         },
         { signal }
@@ -1990,14 +2046,11 @@ async function handleInboundMessage(cfg, msg, signal, ctx) {
     );
     await runStep(
       "sync-documents",
-      () => syncSessionDocuments(cfg, msg.sessionId, workspaceApmDir(msg.workdir))
+      () => syncSessionDocuments(cfg, msg.sessionId, apmRoot)
     );
     await runStep(
-      "commit-documents",
-      () => commitWorkingTreeIfDirty(
-        msg.workdir,
-        "chore(apm): sync session documents"
-      )
+      "commit-files",
+      () => commitWorkingTreeIfDirty(workdir, "chore(apm): commit working tree")
     );
     await runStep(
       "status-success",
@@ -2057,7 +2110,7 @@ async function runConnect(options) {
   }
   const url = buildAgentWsUrl(cfg.baseUrl, resolveApiKey(cfg));
   console.log(`[apm] \u8FDE\u63A5 ${cfg.baseUrl} \u2026`);
-  await new Promise((resolve6, reject) => {
+  await new Promise((resolve5, reject) => {
     const ws = new WebSocket(url);
     let stopHeartbeat;
     let shuttingDown = false;
@@ -2086,7 +2139,7 @@ async function runConnect(options) {
         ]);
       } catch {
       }
-      resolve6();
+      resolve5();
       process.exit(code);
     };
     ws.on("open", () => {
@@ -2174,11 +2227,11 @@ import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
 import { existsSync as existsSync9, readFileSync as readFileSync8 } from "node:fs";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve4 } from "node:path";
 function loadApmConfig(options) {
-  const p = resolve5(
+  const p = resolve4(
     process.cwd(),
-    options?.configPath ?? resolve5(workspaceApmDir(), "apm.config.json")
+    options?.configPath ?? resolve4(workspaceApmDir(), "apm.config.json")
   );
   if (!existsSync9(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
@@ -2445,17 +2498,17 @@ var DockerodeClient = class {
     await this.client.getImage(image).remove({ force: true });
   }
   async pullImage(image, auth) {
-    const stream = await new Promise((resolve6, reject) => {
+    const stream = await new Promise((resolve5, reject) => {
       const pullOptions = auth ? { authconfig: auth } : void 0;
       this.client.pull(image, pullOptions, (err, output) => {
         if (err || !output) {
           reject(err ?? new Error("docker pull \u8FD4\u56DE\u7A7A\u8F93\u51FA"));
           return;
         }
-        resolve6(output);
+        resolve5(output);
       });
     });
-    await new Promise((resolve6, reject) => {
+    await new Promise((resolve5, reject) => {
       this.client.modem.followProgress(
         stream,
         (err) => {
@@ -2463,7 +2516,7 @@ var DockerodeClient = class {
             reject(err);
             return;
           }
-          resolve6();
+          resolve5();
         },
         () => void 0
       );
@@ -2954,14 +3007,14 @@ var MinioClient = class {
   async deleteObjectsByPrefix(bucket, prefix) {
     const objectsStream = this.inner.listObjectsV2(bucket, prefix, true);
     const keys = [];
-    await new Promise((resolve6, reject) => {
+    await new Promise((resolve5, reject) => {
       objectsStream.on("data", (obj) => {
         if (obj.name) {
           keys.push(obj.name);
         }
       });
       objectsStream.on("error", reject);
-      objectsStream.on("end", resolve6);
+      objectsStream.on("end", resolve5);
     });
     const chunkSize = 500;
     for (let i = 0; i < keys.length; i += chunkSize) {
@@ -3199,7 +3252,7 @@ async function ensureRemoteDir(sftp, dir) {
   }
 }
 function execCommand(client, command) {
-  return new Promise((resolve6, reject) => {
+  return new Promise((resolve5, reject) => {
     client.exec(command, (err, stream) => {
       if (err) return reject(err);
       let stdout = "";
@@ -3209,7 +3262,7 @@ function execCommand(client, command) {
           reject(new Error(`\u8FDC\u7A0B\u547D\u4EE4\u5931\u8D25 (${code}): ${stderr || stdout}`));
           return;
         }
-        resolve6(stdout);
+        resolve5(stdout);
       }).on("data", (data) => {
         stdout += data.toString();
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "6.0.41",
+  "version": "6.0.43",
   "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`