ai-project-manage-cli 3.0.16 → 3.0.18

package/dist/index.js

@@ -158,8 +158,8 @@ import { fileURLToPath } from "url";
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var CLI_TEMPLATE_DIR = resolve(__dirname, "../template");
 var WORKSPACE_APM_DIR = resolve(process.cwd(), ".apm");
-function requirementWorkitemsDir(requirementId) {
-  return join2(WORKSPACE_APM_DIR, "workitems", requirementId);
+function requirementWorkitemsDir(requirementId, workspaceDir = WORKSPACE_APM_DIR) {
+  return join2(workspaceDir, "workitems", requirementId);
 }
 async function ensureLoggedConfig() {
   const cfg = await ensureApmConfig();
@@ -227,7 +227,6 @@ async function runComment(requirementId, file, model) {
 }
 
 // src/commands/connect.ts
-import { execSync } from "child_process";
 import { randomUUID } from "crypto";
 import WebSocket from "ws";
 import { Agent } from "@cursor/sdk";
@@ -329,6 +328,228 @@ var EventSession = class {
   }
 };
 
+// src/commands/upload-artifact.ts
+import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { join as join3, relative, sep } from "path";
+var EXCLUDED_RELATIVE_PATHS = /* @__PURE__ */ new Set([
+  "defect.xml",
+  "prd.md",
+  "requirement-status.yaml",
+  "reviews.xml",
+  "testcase.xml"
+]);
+function toPosixRelative(root, absoluteFile) {
+  return relative(root, absoluteFile).split(sep).join("/");
+}
+function artifactTagFromRelPath(relPosix) {
+  const parts = relPosix.split("/");
+  const fileName = parts[parts.length - 1] ?? relPosix;
+  if (parts.length > 1) {
+    return parts[0] ?? fileName;
+  }
+  const dot = fileName.lastIndexOf(".");
+  return dot > 0 ? fileName.slice(0, dot) : fileName;
+}
+function* walkMarkdownFiles(dir) {
+  const names = readdirSync2(dir);
+  for (const name of names) {
+    if (name.startsWith(".")) continue;
+    const full = join3(dir, name);
+    const st = statSync2(full);
+    if (st.isDirectory()) {
+      yield* walkMarkdownFiles(full);
+      continue;
+    }
+    if (!st.isFile()) continue;
+    if (!name.toLowerCase().endsWith(".md")) continue;
+    yield full;
+  }
+}
+async function deleteAllArtifactsForRequirement(api, requirementId) {
+  const pageSize = 100;
+  let page = 1;
+  const rows = [];
+  while (true) {
+    const batch = await api.requirementArtifact.list({
+      requirementId,
+      page,
+      pageSize
+    });
+    rows.push(...batch.items);
+    if (batch.total === 0 || rows.length >= batch.total) break;
+    page += 1;
+  }
+  for (const row of rows) {
+    await api.requirementArtifact.delete({ artifactId: row.id });
+  }
+  return rows.length;
+}
+async function runUploadArtifact(requirementId, workspaceDir) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const root = requirementWorkitemsDir(requirementId, workspaceDir);
+  if (!existsSync2(root)) {
+    console.error(
+      `[apm] \u76EE\u5F55\u4E0D\u5B58\u5728: ${root}
+\u8BF7\u5148\u6267\u884C: apm pull ${requirementId}`
+    );
+    process.exit(1);
+  }
+  const deleted = await deleteAllArtifactsForRequirement(api, requirementId);
+  console.log(`[apm] \u5DF2\u6E05\u7A7A\u9700\u6C42\u4EA7\u7269\u6587\u6863 ${deleted} \u6761`);
+  const paths = [...walkMarkdownFiles(root)];
+  let created = 0;
+  let skipped = 0;
+  for (const abs of paths) {
+    const relPosix = toPosixRelative(root, abs);
+    if (EXCLUDED_RELATIVE_PATHS.has(relPosix)) {
+      skipped += 1;
+      console.log(`[apm] \u8DF3\u8FC7\uFF08\u6392\u9664\u5217\u8868\uFF09: ${relPosix}`);
+      continue;
+    }
+    const content = readFileSync3(abs, "utf8");
+    const tag = artifactTagFromRelPath(relPosix);
+    await api.requirementArtifact.create({
+      requirementId,
+      tag,
+      fileName: relPosix,
+      content
+    });
+    created += 1;
+    console.log(`[apm] \u5DF2\u4E0A\u4F20\u4EA7\u7269: ${relPosix} (tag=${tag})`);
+  }
+  console.log(
+    `[apm] \u5B8C\u6210\uFF1A\u5220\u9664 ${deleted}\uFF0C\u65B0\u5EFA ${created}\uFF0C\u8DF3\u8FC7\uFF08\u6392\u9664\uFF09 ${skipped}\uFF0C\u5171\u626B\u63CF ${paths.length} \u4E2A Markdown \u6587\u4EF6`
+  );
+}
+
+// src/commands/pull.ts
+import { writeFileSync as writeFileSync2 } from "fs";
+import { join as join4 } from "path";
+import { stringify as yamlStringify } from "yaml";
+function valueToXmlContent(value) {
+  if (value === null || value === void 0) return "";
+  if (typeof value === "string") return xmlEscape(value);
+  if (typeof value === "number" || typeof value === "boolean") {
+    return xmlEscape(String(value));
+  }
+  return `<![CDATA[${JSON.stringify(value)}]]>`;
+}
+function recordToXmlLines(record, indent) {
+  const lines = [];
+  for (const [rawKey, val] of Object.entries(record)) {
+    const key = /^[a-zA-Z_][\w.-]*$/.test(rawKey) ? rawKey : "field";
+    lines.push(`${indent}<${key}>${valueToXmlContent(val)}</${key}>`);
+  }
+  return lines;
+}
+function unknownArrayToXml(rootName, itemName, items) {
+  const lines = [`<${rootName}>`];
+  items.forEach((item, index) => {
+    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
+      lines.push(`  <${itemName} index="${index}">`);
+      lines.push(...recordToXmlLines(item, "    "));
+      lines.push(`  </${itemName}>`);
+    } else {
+      lines.push(
+        `  <${itemName} index="${index}">${valueToXmlContent(
+          item
+        )}</${itemName}>`
+      );
+    }
+  });
+  lines.push(`</${rootName}>`, "");
+  return lines.join("\n");
+}
+function tasksForStatusYaml(tasks) {
+  return tasks.map((t) => ({
+    id: t.id,
+    title: t.title,
+    status: t.status,
+    executor: t.executorType
+  }));
+}
+function escapeForCdata(text) {
+  return text.replace(/\]\]>/g, "]]]]><![CDATA[>");
+}
+function defectsToXml(defects) {
+  const sorted = [...defects].sort(
+    (a, b) => new Date(a.createdAt ?? 0).getTime() - new Date(b.createdAt ?? 0).getTime()
+  );
+  const lines = ["<defects>"];
+  for (const d of sorted) {
+    lines.push(`  <defect id="${xmlEscape(d.id)}">`);
+    lines.push(`    <status>${xmlEscape(d.status)}</status>`);
+    lines.push(
+      `    <current><![CDATA[${escapeForCdata(
+        d.currentState ?? ""
+      )}]]></current>`
+    );
+    lines.push(
+      `    <expected><![CDATA[${escapeForCdata(
+        d.expectedEffect ?? ""
+      )}]]></expected>`
+    );
+    lines.push(`  </defect>`);
+  }
+  lines.push("</defects>", "");
+  return lines.join("\n");
+}
+async function runPull(requirementId, workspaceDir) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.pull({ requirementId });
+  const WORKITEMS_DIR = requirementWorkitemsDir(requirementId, workspaceDir);
+  await ensureDirExists(WORKITEMS_DIR);
+  const req2 = data.requirement;
+  const statusYaml = yamlStringify(
+    {
+      id: req2.id,
+      status: req2.status,
+      title: req2.title,
+      env: req2.envName || "",
+      tasks: tasksForStatusYaml(data.tasks ?? [])
+    },
+    { lineWidth: 0 }
+  );
+  writeFileSync2(
+    join4(WORKITEMS_DIR, "requirement-status.yaml"),
+    statusYaml.endsWith("\n") ? statusYaml : `${statusYaml}
+`,
+    "utf8"
+  );
+  writeFileSync2(join4(WORKITEMS_DIR, "prd.md"), req2.content || "", "utf8");
+  const reviews = data.reviews ?? [];
+  const reviewsXml = [
+    "<reviews>",
+    ...reviews.map((r) => {
+      return [
+        `  <review id="${xmlEscape(r.id)}">`,
+        `    <model>${xmlEscape(r.model ?? "")}</model>`,
+        `    <content>`,
+        `${xmlEscape(r.content ?? "")}`,
+        `    </content>`,
+        `    <reply>`,
+        `${xmlEscape(r.reply ?? "")}`,
+        `    </reply>`,
+        "  </review>"
+      ].join("\n");
+    }),
+    "</reviews>",
+    ""
+  ].join("\n");
+  writeFileSync2(join4(WORKITEMS_DIR, "reviews.xml"), reviewsXml, "utf8");
+  const defectsXml = defectsToXml(data.defects ?? []);
+  writeFileSync2(join4(WORKITEMS_DIR, "defect.xml"), defectsXml, "utf8");
+  const testCasesXml = unknownArrayToXml(
+    "testcases",
+    "case",
+    data.testCases ?? []
+  );
+  writeFileSync2(join4(WORKITEMS_DIR, "testcase.xml"), testCasesXml, "utf8");
+  return WORKITEMS_DIR;
+}
+
 // src/commands/connect.ts
 function runConnect(opts) {
   void (async () => {
@@ -373,10 +594,7 @@ function runConnect(opts) {
         }
         const payload = msg.payload;
         try {
-          execSync(`apm pull ${payload.requirementId}`, {
-            cwd: payload.cwd,
-            encoding: "utf8"
-          });
+          await runPull(payload.requirementId, payload.cwd);
         } catch (pullErr) {
           console.error("[apm] apm pull \u5931\u8D25:", pullErr);
           throw pullErr;
@@ -454,6 +672,12 @@ function runConnect(opts) {
         });
         console.log("[Done]");
         session.writeToFile(payload.cwd, payload.requirementId, run.agentId);
+        try {
+          await runUploadArtifact(payload.requirementId, payload.cwd);
+        } catch (pullErr) {
+          console.error("[apm] apm upload-artifact \u5931\u8D25:", pullErr);
+          throw pullErr;
+        }
       } catch {
         console.error("[apm] \u65E0\u6CD5\u89E3\u6790 WebSocket \u6D88\u606F:", text);
       }
@@ -469,17 +693,17 @@ function runConnect(opts) {
 }
 
 // src/commands/init.ts
-import { join as join3 } from "path";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { join as join5 } from "path";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "fs";
 async function runInit(name) {
   await ensureWorkspaceApmDirForInit();
   await copyTemplateFiles(WORKSPACE_APM_DIR);
   if (name) {
-    const apmConfigPath = join3(WORKSPACE_APM_DIR, "apm.config.json");
-    const config = readFileSync3(apmConfigPath, "utf8");
+    const apmConfigPath = join5(WORKSPACE_APM_DIR, "apm.config.json");
+    const config = readFileSync4(apmConfigPath, "utf8");
     const configJson = JSON.parse(config);
     configJson.name = name;
-    writeFileSync2(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
+    writeFileSync3(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
   }
 }
 
@@ -666,134 +890,13 @@ async function runBranch(requirementId, options = {}) {
   return branch;
 }
 
-// src/commands/pull.ts
-import { writeFileSync as writeFileSync3 } from "fs";
-import { join as join4 } from "path";
-import { stringify as yamlStringify } from "yaml";
-function valueToXmlContent(value) {
-  if (value === null || value === void 0) return "";
-  if (typeof value === "string") return xmlEscape(value);
-  if (typeof value === "number" || typeof value === "boolean") {
-    return xmlEscape(String(value));
-  }
-  return `<![CDATA[${JSON.stringify(value)}]]>`;
-}
-function recordToXmlLines(record, indent) {
-  const lines = [];
-  for (const [rawKey, val] of Object.entries(record)) {
-    const key = /^[a-zA-Z_][\w.-]*$/.test(rawKey) ? rawKey : "field";
-    lines.push(`${indent}<${key}>${valueToXmlContent(val)}</${key}>`);
-  }
-  return lines;
-}
-function unknownArrayToXml(rootName, itemName, items) {
-  const lines = [`<${rootName}>`];
-  items.forEach((item, index) => {
-    if (item !== null && typeof item === "object" && !Array.isArray(item)) {
-      lines.push(`  <${itemName} index="${index}">`);
-      lines.push(...recordToXmlLines(item, "    "));
-      lines.push(`  </${itemName}>`);
-    } else {
-      lines.push(
-        `  <${itemName} index="${index}">${valueToXmlContent(
-          item
-        )}</${itemName}>`
-      );
-    }
-  });
-  lines.push(`</${rootName}>`, "");
-  return lines.join("\n");
-}
-function tasksForStatusYaml(tasks) {
-  return tasks.map((t) => ({
-    id: t.id,
-    title: t.title,
-    status: t.status,
-    executor: t.executorType
-  }));
-}
-function escapeForCdata(text) {
-  return text.replace(/\]\]>/g, "]]]]><![CDATA[>");
-}
-function defectsToXml(defects) {
-  const sorted = [...defects].sort(
-    (a, b) => new Date(a.createdAt ?? 0).getTime() - new Date(b.createdAt ?? 0).getTime()
-  );
-  const lines = ["<defects>"];
-  for (const d of sorted) {
-    lines.push(`  <defect id="${xmlEscape(d.id)}">`);
-    lines.push(`    <status>${xmlEscape(d.status)}</status>`);
-    lines.push(`    <current><![CDATA[${escapeForCdata(d.currentState ?? "")}]]></current>`);
-    lines.push(
-      `    <expected><![CDATA[${escapeForCdata(d.expectedEffect ?? "")}]]></expected>`
-    );
-    lines.push(`  </defect>`);
-  }
-  lines.push("</defects>", "");
-  return lines.join("\n");
-}
-async function runPull(requirementId) {
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  const data = await api.cliRequirements.pull({ requirementId });
-  const WORKITEMS_DIR = requirementWorkitemsDir(requirementId);
-  await ensureDirExists(WORKITEMS_DIR);
-  const req2 = data.requirement;
-  const statusYaml = yamlStringify(
-    {
-      id: req2.id,
-      status: req2.status,
-      title: req2.title,
-      env: req2.envName || "",
-      tasks: tasksForStatusYaml(data.tasks ?? [])
-    },
-    { lineWidth: 0 }
-  );
-  writeFileSync3(
-    join4(WORKITEMS_DIR, "requirement-status.yaml"),
-    statusYaml.endsWith("\n") ? statusYaml : `${statusYaml}
-`,
-    "utf8"
-  );
-  writeFileSync3(join4(WORKITEMS_DIR, "prd.md"), req2.content || "", "utf8");
-  const reviews = data.reviews ?? [];
-  const reviewsXml = [
-    "<reviews>",
-    ...reviews.map((r) => {
-      return [
-        `  <review id="${xmlEscape(r.id)}">`,
-        `    <model>${xmlEscape(r.model ?? "")}</model>`,
-        `    <content>`,
-        `${xmlEscape(r.content ?? "")}`,
-        `    </content>`,
-        `    <reply>`,
-        `${xmlEscape(r.reply ?? "")}`,
-        `    </reply>`,
-        "  </review>"
-      ].join("\n");
-    }),
-    "</reviews>",
-    ""
-  ].join("\n");
-  writeFileSync3(join4(WORKITEMS_DIR, "reviews.xml"), reviewsXml, "utf8");
-  const defectsXml = defectsToXml(data.defects ?? []);
-  writeFileSync3(join4(WORKITEMS_DIR, "defect.xml"), defectsXml, "utf8");
-  const testCasesXml = unknownArrayToXml(
-    "testcases",
-    "case",
-    data.testCases ?? []
-  );
-  writeFileSync3(join4(WORKITEMS_DIR, "testcase.xml"), testCasesXml, "utf8");
-  return WORKITEMS_DIR;
-}
-
 // src/commands/refine.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { readFileSync as readFileSync5 } from "fs";
+import { join as join6 } from "path";
 async function runRefine(requirementId) {
   const cfg = await ensureLoggedConfig();
-  const filePath = join5(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
-  const content = readFileSync4(filePath, "utf8");
+  const filePath = join6(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
+  const content = readFileSync5(filePath, "utf8");
   const api = createApmApiClient(cfg);
   const data = await api.cliRequirements.refine({ requirementId, content });
   console.log(JSON.stringify(data, null, 2));
@@ -821,101 +924,6 @@ async function runUpdateStatus(requirementId, status) {
   console.log(JSON.stringify(data, null, 2));
 }
 
-// src/commands/upload-artifact.ts
-import { existsSync as existsSync2, readFileSync as readFileSync5, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join6, relative, sep } from "path";
-var EXCLUDED_RELATIVE_PATHS = /* @__PURE__ */ new Set([
-  "defect.xml",
-  "prd.md",
-  "requirement-status.yaml",
-  "reviews.xml",
-  "testcase.xml"
-]);
-function toPosixRelative(root, absoluteFile) {
-  return relative(root, absoluteFile).split(sep).join("/");
-}
-function artifactTagFromRelPath(relPosix) {
-  const parts = relPosix.split("/");
-  const fileName = parts[parts.length - 1] ?? relPosix;
-  if (parts.length > 1) {
-    return parts[0] ?? fileName;
-  }
-  const dot = fileName.lastIndexOf(".");
-  return dot > 0 ? fileName.slice(0, dot) : fileName;
-}
-function* walkMarkdownFiles(dir) {
-  const names = readdirSync2(dir);
-  for (const name of names) {
-    if (name.startsWith(".")) continue;
-    const full = join6(dir, name);
-    const st = statSync2(full);
-    if (st.isDirectory()) {
-      yield* walkMarkdownFiles(full);
-      continue;
-    }
-    if (!st.isFile()) continue;
-    if (!name.toLowerCase().endsWith(".md")) continue;
-    yield full;
-  }
-}
-async function deleteAllArtifactsForRequirement(api, requirementId) {
-  const pageSize = 100;
-  let page = 1;
-  const rows = [];
-  while (true) {
-    const batch = await api.requirementArtifact.list({
-      requirementId,
-      page,
-      pageSize
-    });
-    rows.push(...batch.items);
-    if (batch.total === 0 || rows.length >= batch.total) break;
-    page += 1;
-  }
-  for (const row of rows) {
-    await api.requirementArtifact.delete({ artifactId: row.id });
-  }
-  return rows.length;
-}
-async function runUploadArtifact(requirementId) {
-  const cfg = await ensureLoggedConfig();
-  const api = createApmApiClient(cfg);
-  const root = requirementWorkitemsDir(requirementId);
-  if (!existsSync2(root)) {
-    console.error(
-      `[apm] \u76EE\u5F55\u4E0D\u5B58\u5728: ${root}
-\u8BF7\u5148\u6267\u884C: apm pull ${requirementId}`
-    );
-    process.exit(1);
-  }
-  const deleted = await deleteAllArtifactsForRequirement(api, requirementId);
-  console.log(`[apm] \u5DF2\u6E05\u7A7A\u9700\u6C42\u4EA7\u7269\u6587\u6863 ${deleted} \u6761`);
-  const paths = [...walkMarkdownFiles(root)];
-  let created = 0;
-  let skipped = 0;
-  for (const abs of paths) {
-    const relPosix = toPosixRelative(root, abs);
-    if (EXCLUDED_RELATIVE_PATHS.has(relPosix)) {
-      skipped += 1;
-      console.log(`[apm] \u8DF3\u8FC7\uFF08\u6392\u9664\u5217\u8868\uFF09: ${relPosix}`);
-      continue;
-    }
-    const content = readFileSync5(abs, "utf8");
-    const tag = artifactTagFromRelPath(relPosix);
-    await api.requirementArtifact.create({
-      requirementId,
-      tag,
-      fileName: relPosix,
-      content
-    });
-    created += 1;
-    console.log(`[apm] \u5DF2\u4E0A\u4F20\u4EA7\u7269: ${relPosix} (tag=${tag})`);
-  }
-  console.log(
-    `[apm] \u5B8C\u6210\uFF1A\u5220\u9664 ${deleted}\uFF0C\u65B0\u5EFA ${created}\uFF0C\u8DF3\u8FC7\uFF08\u6392\u9664\uFF09 ${skipped}\uFF0C\u5171\u626B\u63CF ${paths.length} \u4E2A Markdown \u6587\u4EF6`
-  );
-}
-
 // src/commands/deploy/backend.ts
 import path5 from "node:path";
 
@@ -1332,7 +1340,7 @@ function assertDeployImageTag(tag) {
 import { platform } from "node:os";
 
 // src/commands/deploy/lib/backend-deploy/command-runner.ts
-import { execSync as execSync2 } from "child_process";
+import { execSync } from "child_process";
 
 // src/commands/deploy/lib/backend-deploy/logger.ts
 var Logger = class {
@@ -1358,7 +1366,7 @@ var CommandRunner = class {
   static exec(command, cwd) {
     try {
       Logger.info(`\u6267\u884C\u547D\u4EE4: ${command}`);
-      const result = execSync2(command, {
+      const result = execSync(command, {
         cwd,
         encoding: "utf8",
         stdio: "pipe"
@@ -1376,7 +1384,7 @@ var CommandRunner = class {
   static execWithOutput(command, cwd) {
     try {
       Logger.info(`\u6267\u884C\u547D\u4EE4: ${command}`);
-      execSync2(command, {
+      execSync(command, {
         cwd,
         stdio: "inherit"
       });

package/package.json

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

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

@@ -59,8 +59,7 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 ## 步骤 2：读取缺陷清单（defect.xml）
 
 1. 父 Agent 使用 **Read** 工具读取：`.apm/workitems/<requirementId>/defect.xml`（缺陷列表，格式以平台同步为准）。
-2. 若首次 **Read** 失败（无此文件等）：在仓库根目录执行 **`apm pull <requirementId>`**，再 **Read** 一次。
-3. **分流（非失败）**：
+2. **分流（非失败）**：
    - **无文件、仍读不到、或文件无有效内容**（空文件、仅空白、无实质缺陷条目等；具体结构以同步格式为准）：**不视为步骤失败**。表格步骤 2 填 **跳过（无 defect 内容 → 新功能）**，**直接进入步骤 3**。
    - **文件存在且有有效内容**：视为本轮为 **修复 Bug 流程**（与步骤 4 同属 Quick 形态，对照 **defect.xml + 必要时 prd.md**，目标是消除所列缺陷）：
      - 父 Agent 已通过 **Read** 掌握 `defect.xml`；若启动子 Agent，在委派提示中写明 **`requirementId`**、工作项路径、`defect.xml` 路径，以及「逐项对照缺陷列表修复，改动范围最小化」。
@@ -78,7 +77,7 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 **条件**：仅当步骤 2 **未**以「`defect.xml` **有内容**且 Quick 修 Bug **成功** → 短路至步骤 6」结束时执行（含：`defect.xml` 缺失、拉取后仍无、或**无有效内容**而走新功能流程）。
 
 1. **Read** 全文：`.apm/workitems/<requirementId>/prd.md`。
-2. 若无法读取：在仓库根目录执行 **`apm pull <requirementId>`**（同步工作项），再 **Read** 一次；仍失败则**停止后续实现**，仅在表格中标记失败原因。
+2. 若失败则**停止后续实现**，仅在表格中标记失败原因。
 3. **不**为评估向用户发起追问；信息不足时倾向 **Spec**（保守）。
 
 ### Quick（较小）与 Spec（较大）判定参考
@@ -137,23 +136,7 @@ instruction 子文件随该目录类推（如 `.apm/skills/apm-propose/propose-i
 
 将命令结果、最终分支名、是否已 push、工作区是否干净写入表格。
 
----
-
-## 步骤 7：同步产物
-
-在**仓库/工作区根目录**（与步骤 1、6 一致）执行：
-
-```bash
-apm upload-artifact <requirementId>
-```
-
-1. 该命令会**先清空**平台上该需求的产物文档，再将 `.apm/workitems/<requirementId>/` 下符合条件的 Markdown 重新上传（排除 `prd.md`、状态 YAML、reviews/defect/testcase 等 pull 系统文件；详见 CLI 行为）。
-2. 若本地未放置需同步的 `.md` 产物，仍会清空平台侧产物；若有文档仅在仓库其它路径，须先复制或生成到工作项目录再执行。
-3. 将命令是否成功、上传条数或错误摘要写入表格。
-
----
-
-## 步骤 8：对用户回复（表格）
+## 步骤 7：对用户回复（表格）
 
 对用户回复 **必须包含一张 Markdown 表格**，汇总 **步骤 1～7**（步骤 8 为呈现表格本身，可不单独成行）。表头建议：
 
@@ -165,7 +148,6 @@ apm upload-artifact <requirementId>
 | 4 | Quick 开发（子 Agent） | 成功 / 失败 / **跳过** |
 | 5 | Spec：apm-propose → apm-apply-change（子 Agent） | 成功 / 失败 / **跳过**；可注明子步骤 |
 | 6 | commit & push；工作区干净 | 成功 / 失败（原因） |
-| 7 | `apm upload-artifact <requirementId>` | 成功 / 失败（原因） |
 
 **可选**：在表格外增加**简短**一句话摘要（例如当前分支名、阻塞点）；若用户此前约定「仅表格」，则可仅输出表格。
 
@@ -173,7 +155,7 @@ apm upload-artifact <requirementId>
 
 ## Guardrails
 
-- **失败即终止**：在用户提供的 **`requirementId`** 等参数合法、命令与路径按本技能书写的前提下，任一步骤（含 `apm branch`、`apm pull`、`apm upload-artifact`、读文件、子 Agent、`git`）**一旦失败**：**停止后续所有步骤**，仅在表格中记录失败步骤与原因；**不要**为登录、依赖、网络、命令结果等做**多次**或「轮番」重试。
+- **失败即终止**：在用户提供的 **`requirementId`** 等参数合法、命令与路径按本技能书写的前提下，任一步骤（含 `apm branch`、读文件、子 Agent、`git`）**一旦失败**：**停止后续所有步骤**，仅在表格中记录失败步骤与原因；**不要**为登录、依赖、网络、命令结果等做**多次**或「轮番」重试。
 - **例外（Agent 自身失误）**：若失败明显由执行 Agent **用错工作目录、读错/漏写路径** 等导致，**允许**纠正 `cwd` 或路径后**仅对该失败步骤再执行一次**；纠正后仍失败则**立即终止**，不再扩展尝试。
-- **不要**在无 `prd.md`（且 `apm pull` 后仍无）的情况下编造需求实现。
+- **不要**在无 `prd.md`的情况下编造需求实现。
 - **子 Agent** 提示中须带 **`requirementId`** 与仓库根路径意识，避免改错工作树。