ai-project-manage-cli 2.0.26 → 3.0.2

package/dist/index.js

@@ -1,22 +1,502 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
+#!/usr/bin/env node
+
+// src/index.ts
+import { readFileSync as readFileSync5 } from "fs";
+import { dirname as dirname2, join as join6 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { Command } from "commander";
+
+// src/config.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var APM_CONFIG_DIR = join(homedir(), ".config", "apm");
+var APM_CONFIG_PATH = join(APM_CONFIG_DIR, "config.json");
+var DEFAULT_BASE_URL = "http://127.0.0.1:3000";
+async function readApmConfig() {
+  try {
+    const raw = readFileSync(APM_CONFIG_PATH, "utf8");
+    const v = JSON.parse(raw);
+    if (typeof v !== "object" || v === null) {
+      return null;
     }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+    const rawCfg = v;
+    if (typeof rawCfg.baseUrl !== "string" || typeof rawCfg.userId !== "string" || typeof rawCfg.token !== "string") {
+      return null;
+    }
+    const cfg = v;
+    return {
+      baseUrl: cfg.baseUrl.trim().replace(/\/+$/, ""),
+      userId: cfg.userId,
+      token: cfg.token,
+      ...typeof cfg.email === "string" ? { email: cfg.email } : {}
+    };
+  } catch {
+    return null;
+  }
+}
+function defaultApmConfig() {
+  return {
+    baseUrl: DEFAULT_BASE_URL,
+    userId: "",
+    token: "",
+    email: ""
+  };
+}
+function httpBaseToWsOrigin(httpBase) {
+  const u = httpBase.trim().replace(/\/+$/, "");
+  if (u.startsWith("https://")) return "wss://" + u.slice("https://".length);
+  if (u.startsWith("http://")) return "ws://" + u.slice("http://".length);
+  throw new Error("baseUrl \u5FC5\u987B\u4EE5 http:// \u6216 https:// \u5F00\u5934");
+}
+async function ensureApmConfig() {
+  const existing = await readApmConfig();
+  if (existing) return existing;
+  const defaults = defaultApmConfig();
+  await writeApmConfig(defaults);
+  return defaults;
+}
+async function writeApmConfig(cfg) {
+  const normalized = {
+    baseUrl: cfg.baseUrl.trim().replace(/\/+$/, ""),
+    userId: cfg.userId,
+    token: cfg.token,
+    ...typeof cfg.email === "string" ? { email: cfg.email } : {}
+  };
+  mkdirSync(APM_CONFIG_DIR, { recursive: true });
+  writeFileSync(APM_CONFIG_PATH, JSON.stringify(normalized, null, 2) + "\n", {
+    mode: 384
+  });
+}
+function buildAgentWsUrl(httpBase, token) {
+  const origin = httpBaseToWsOrigin(httpBase);
+  const q = new URLSearchParams({ token });
+  return `${origin}/ws/agent?${q.toString()}`;
+}
+
+// src/commands/comment.ts
+import { readFileSync as readFileSync2 } from "fs";
+
+// src/api/client.ts
+import { createApiClient } from "listpage-http";
+
+// src/api/request-config.ts
+import { defineEndpoint } from "listpage-http";
+var requestConfig = {
+  auth: {
+    login: defineEndpoint({
+      method: "POST",
+      path: "/auth/login",
+      authRequired: false
+    })
+  },
+  cliRequirements: {
+    pull: defineEndpoint({
+      method: "GET",
+      path: "/cli/requirements/pull"
+    }),
+    comment: defineEndpoint({
+      method: "POST",
+      path: "/cli/requirements/comment"
+    }),
+    refine: defineEndpoint({
+      method: "POST",
+      path: "/cli/requirements/refine"
+    }),
+    updateStatus: defineEndpoint({
+      method: "POST",
+      path: "/cli/requirements/update-status"
+    }),
+    updateDevStatus: defineEndpoint({
+      method: "POST",
+      path: "/cli/requirements/update-dev-status"
+    })
+  }
 };
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * ai-project-manage 后端 SDK（目录结构对齐 apps/fe/src/api）。
- */
-__exportStar(require("./api/index"), exports);
-__exportStar(require("./employee-ws-client"), exports);
-//# sourceMappingURL=index.js.map
+
+// src/api/client.ts
+function createApmApiClient(cfg) {
+  const baseURL = `${cfg.baseUrl.trim().replace(/\/+$/, "")}/api`;
+  return createApiClient(requestConfig, {
+    baseURL,
+    getToken: () => cfg.token || void 0,
+    successCodes: [200, 201],
+    unauthorizedCodes: [401]
+  });
+}
+
+// src/command-utils.ts
+import { cpSync, existsSync, mkdirSync as mkdirSync2, readdirSync, statSync } from "fs";
+import { dirname, join as join2, resolve } from "path";
+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");
+async function ensureLoggedConfig() {
+  const cfg = await ensureApmConfig();
+  if (!cfg.token) {
+    console.error(
+      "[apm] \u672A\u68C0\u6D4B\u5230 token\uFF0C\u8BF7\u5148\u6267\u884C: apm login --email ... --password ..."
+    );
+    process.exit(1);
+  }
+  return cfg;
+}
+async function ensureDirExists(dir) {
+  mkdirSync2(dir, { recursive: true });
+}
+async function ensureWorkspaceApmDirForInit() {
+  const dir = WORKSPACE_APM_DIR;
+  if (!existsSync(dir)) {
+    mkdirSync2(dir, { recursive: true });
+    return;
+  }
+  const st = statSync(dir);
+  if (!st.isDirectory()) {
+    throw new Error(`[apm] \u8DEF\u5F84\u5DF2\u5B58\u5728\u4F46\u4E0D\u662F\u76EE\u5F55: ${dir}`);
+  }
+  if (readdirSync(dir).length > 0) {
+    throw new Error(
+      "[apm] .apm \u76EE\u5F55\u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\uFF0C\u8BF7\u5148\u5907\u4EFD\u3001\u6E05\u7A7A\u6216\u5220\u9664\u540E\u518D\u6267\u884C init"
+    );
+  }
+}
+async function copyTemplateFiles(targetDir) {
+  try {
+    const dirStat = statSync(CLI_TEMPLATE_DIR);
+    if (!dirStat.isDirectory()) return;
+  } catch {
+    return;
+  }
+  const entries = readdirSync(CLI_TEMPLATE_DIR);
+  await Promise.all(
+    entries.map(async (name) => {
+      const src = join2(CLI_TEMPLATE_DIR, name);
+      const dest = join2(targetDir, name);
+      cpSync(src, dest, { recursive: true, force: false });
+    })
+  );
+}
+function xmlEscape(v) {
+  return v.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+}
+function resolveCwdPath(file) {
+  return resolve(process.cwd(), file);
+}
+
+// src/commands/comment.ts
+async function runComment(requirementId, file, model) {
+  const cfg = await ensureLoggedConfig();
+  const content = readFileSync2(resolveCwdPath(file), "utf8");
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.comment({
+    requirementId,
+    content,
+    model
+  });
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// src/commands/connect.ts
+import { randomUUID } from "crypto";
+import WebSocket from "ws";
+function runConnect(opts) {
+  void (async () => {
+    const cfg = await ensureApmConfig();
+    const server = opts.server?.trim();
+    if (server) {
+      cfg.baseUrl = server.replace(/\/+$/, "");
+      await writeApmConfig(cfg);
+    }
+    if (!cfg.token) {
+      console.error(
+        "[apm] \u672A\u68C0\u6D4B\u5230 token\uFF0C\u8BF7\u5148\u6267\u884C: apm login --email ... --password ..."
+      );
+      console.error(`[apm] \u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84: ${APM_CONFIG_PATH}`);
+      process.exit(1);
+    }
+    const url = buildAgentWsUrl(cfg.baseUrl, cfg.token);
+    console.error(`[apm] \u8FDE\u63A5 ${url.replace(cfg.token, "<token>")} \u2026`);
+    const ws = new WebSocket(url);
+    ws.on("open", () => {
+      console.error("[apm] \u5DF2\u8FDE\u63A5");
+      const sendHeartbeat = () => {
+        const frame = {
+          type: "HEARTBEAT",
+          msg_id: randomUUID(),
+          ts: (/* @__PURE__ */ new Date()).toISOString(),
+          payload: {}
+        };
+        ws.send(JSON.stringify(frame));
+      };
+      sendHeartbeat();
+      const interval = setInterval(sendHeartbeat, 15e3);
+      ws.on("close", () => clearInterval(interval));
+    });
+    ws.on("message", (data) => {
+      const text = typeof data === "string" ? data : data.toString();
+      console.log(text);
+    });
+    ws.on("error", (err) => {
+      console.error("[apm] WebSocket \u9519\u8BEF:", err.message);
+    });
+    ws.on("close", (code, reason) => {
+      console.error(`[apm] \u8FDE\u63A5\u5173\u95ED code=${code} reason=${reason.toString()}`);
+      process.exit(code === 1e3 ? 0 : 1);
+    });
+  })();
+}
+
+// src/commands/init.ts
+import { join as join3 } from "path";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync2 } 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 configJson = JSON.parse(config);
+    configJson.name = name;
+    writeFileSync2(apmConfigPath, JSON.stringify(configJson, null, 2), "utf8");
+  }
+}
+
+// src/commands/login.ts
+import { ApiError } from "listpage-http";
+async function runLogin(opts) {
+  const baseUrl = (opts.server?.trim() || process.env.AI_PM_SERVER?.trim() || DEFAULT_BASE_URL).replace(/\/+$/, "");
+  const api = createApmApiClient({
+    baseUrl,
+    userId: "",
+    token: ""
+  });
+  let data;
+  try {
+    data = await api.auth.login({
+      email: opts.email,
+      password: opts.password
+    });
+  } catch (raw) {
+    if (raw instanceof ApiError) {
+      const err = raw;
+      console.error(
+        `[apm] \u767B\u5F55\u5931\u8D25 (${err.httpStatus ?? err.code}):`,
+        err.message
+      );
+      process.exit(1);
+    }
+    console.error(
+      "[apm] \u8BF7\u6C42\u5931\u8D25:",
+      raw instanceof Error ? raw.message : raw
+    );
+    process.exit(1);
+  }
+  if (!data?.id || !data?.token) {
+    console.error("[apm] \u54CD\u5E94\u7F3A\u5C11 id / token\uFF08\u8BF7\u786E\u8BA4\u670D\u52A1\u7AEF\u4E3A /api/auth/login\uFF09");
+    process.exit(1);
+  }
+  const cfg = {
+    baseUrl,
+    userId: data.id,
+    token: data.token,
+    email: opts.email
+  };
+  await writeApmConfig(cfg);
+  console.error(`[apm] \u5DF2\u4FDD\u5B58\u767B\u5F55\u4FE1\u606F: ${APM_CONFIG_PATH}`);
+  console.log(JSON.stringify({ userId: cfg.userId, baseUrl: cfg.baseUrl }, null, 2));
+}
+
+// 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
+  }));
+}
+async function runPull(requirementId) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.pull({ requirementId });
+  const WORKITEMS_DIR = join4(WORKSPACE_APM_DIR, "workitems", requirementId);
+  await ensureDirExists(WORKITEMS_DIR);
+  const req = data.requirement;
+  const statusYaml = yamlStringify(
+    {
+      id: req.id,
+      status: req.status,
+      ...req.urgency != null && req.urgency !== "" ? { urgency: req.urgency } : {},
+      title: req.title,
+      ...req.pauseReason != null && req.pauseReason.trim() !== "" ? { pauseReason: req.pauseReason } : {},
+      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"), req.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 = unknownArrayToXml("defects", "defect", 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";
+async function runRefine(requirementId) {
+  const cfg = await ensureLoggedConfig();
+  const filePath = join5(WORKSPACE_APM_DIR, "workitems", requirementId, "prd.md");
+  const content = readFileSync4(filePath, "utf8");
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.refine({ requirementId, content });
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// src/commands/update-dev-status.ts
+async function runUpdateDevStatus(requirementId, status) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.updateDevStatus({
+    requirementId,
+    status
+  });
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// src/commands/update-status.ts
+async function runUpdateStatus(requirementId, status) {
+  const cfg = await ensureLoggedConfig();
+  const api = createApmApiClient(cfg);
+  const data = await api.cliRequirements.updateStatus({
+    requirementId,
+    status
+  });
+  console.log(JSON.stringify(data, null, 2));
+}
+
+// src/index.ts
+function readCliVersion() {
+  try {
+    const dir = dirname2(fileURLToPath2(import.meta.url));
+    const pkgPath = join6(dir, "..", "package.json");
+    const pkg = JSON.parse(readFileSync5(pkgPath, "utf8"));
+    return pkg.version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+function buildProgram() {
+  const program = new Command();
+  program.name("apm").description(
+    `\u5E73\u53F0\u547D\u4EE4\u884C\uFF08Agent \u901A\u9053\u4E0E\u9700\u6C42 CLI\uFF09\u3002
+\u672A\u4F20 --server \u65F6\u4F18\u5148\u4F7F\u7528\u73AF\u5883\u53D8\u91CF AI_PM_SERVER\uFF0C\u5426\u5219\u9ED8\u8BA4 ${DEFAULT_BASE_URL}\u3002`
+  ).version(readCliVersion(), "-V, --version", "\u663E\u793A\u7248\u672C\u53F7").helpOption("-h, --help", "\u663E\u793A\u5E2E\u52A9").showHelpAfterError(true);
+  program.command("login").description(
+    "\u8C03\u7528 POST /api/auth/login\uFF0C\u5C06 token \u5199\u5165 ~/.config/apm/config.json"
+  ).requiredOption("--email <\u90AE\u7BB1>", "\u767B\u5F55\u90AE\u7BB1").requiredOption("--password <\u5BC6\u7801>", "\u767B\u5F55\u5BC6\u7801").option("--server <url>", "API \u6839\u5730\u5740\uFF0C\u4F8B\u5982 http://127.0.0.1:3000").action(async (opts) => {
+    await runLogin(opts);
+  });
+  program.command("connect").description("\u8FDE\u63A5 WebSocket /ws/agent\uFF0C\u5E76\u6309\u56FA\u5B9A\u95F4\u9694\u53D1\u9001 HEARTBEAT").option("--server <url>", "API \u6839\u5730\u5740\uFF08\u5199\u5165\u672C\u5730\u914D\u7F6E\uFF09").action((opts) => {
+    runConnect(opts);
+  });
+  program.command("init").description(
+    "\u5728\u5F53\u524D\u5DE5\u4F5C\u76EE\u5F55\u521D\u59CB\u5316 .apm \u6A21\u677F\uFF08\u82E5 .apm \u5DF2\u5B58\u5728\u4E14\u975E\u7A7A\u5219\u62A5\u9519\uFF09"
+  ).option("--name <name>", "\u5DE5\u4F5C\u76EE\u5F55\u540D\u79F0").action(async (opts) => {
+    await runInit(opts.name);
+  });
+  program.command("pull").description("GET /api/cli/requirements/pull\uFF0C\u540C\u6B65\u6570\u636E\u5230 .apm \u76EE\u5F55").argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
+    await runPull(requirementId);
+  });
+  program.command("comment").description("POST /api/cli/requirements/comment\uFF08\u6B63\u6587\u6765\u81EA\u6587\u4EF6\uFF09").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--file <path>", "\u8BC4\u8BBA\u6B63\u6587\u6587\u4EF6\u8DEF\u5F84").option("--model <model>", "\u8BC4\u8BBA\u6A21\u578B").action(
+    async (requirementId, options) => {
+      await runComment(requirementId, options.file, options.model);
+    }
+  );
+  program.command("refine").description("POST /api/cli/requirements/refine\uFF08\u6B63\u6587\u6765\u81EA\u6587\u4EF6\uFF09").argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {
+    await runRefine(requirementId);
+  });
+  program.command("update-status").description("POST /api/cli/requirements/update-status").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--status <RequirementStatus>", "\u9700\u6C42\u72B6\u6001\u679A\u4E3E\u503C").action(async (requirementId, options) => {
+    await runUpdateStatus(requirementId, options.status);
+  });
+  program.command("update-dev-status").description("POST /api/cli/requirements/update-dev-status").argument("<requirementId>", "\u9700\u6C42 ID").requiredOption("--status <status>", "\u6210\u5458\u5F00\u53D1\u72B6\u6001\uFF08\u81EA\u7531\u6587\u672C\uFF09").action(async (requirementId, options) => {
+    await runUpdateDevStatus(requirementId, options.status);
+  });
+  return program;
+}
+async function main() {
+  const program = buildProgram();
+  await program.parseAsync(process.argv);
+}
+main().catch((err) => {
+  console.error("[apm]", err instanceof Error ? err.message : err);
+  process.exit(1);
+});

package/package.json

@@ -1,38 +1,40 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "2.0.26",
+  "version": "3.0.2",
+  "description": "命令行工具：后续用于调用平台后端 API 完成运维与自动化操作",
+  "type": "module",
   "private": false,
-  "description": "AI 项目管理 CLI 工具，结合飞书项目实现AI项目开发工作流",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "license": "UNLICENSED",
   "bin": {
-    "apm": "dist/cli.js"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    }
+    "apm": "./dist/index.js"
   },
+  "main": "./dist/index.js",
   "files": [
     "dist",
-    "templates"
+    "template"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json"
-  },
-  "dependencies": {
-    "commander": "^13.1.0",
-    "listpage-http": "0.0.316",
-    "ws": "~8.20.0",
-    "minio": "~8.0.7",
-    "dockerode": "~4.0.10"
+    "build": "rm -rf dist && esbuild src/index.ts --bundle --platform=node --format=esm --packages=external --outfile=dist/index.js && tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:init": "vitest run tests/cli-init.test.ts",
+    "test:pull": "vitest run tests/cli-pull.test.ts"
   },
   "devDependencies": {
-    "@types/node": "^22.10.7",
-    "typescript": "~5.7.3",
+    "@types/node": "^22.0.0",
+    "typescript": "~5.6.0",
     "@types/ws": "~8.18.1",
-    "@types/dockerode": "~4.0.1"
+    "esbuild": "~0.28.0",
+    "vitest": "~4.1.5"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "ws": "~8.20.0",
+    "listpage-http": "~0.0.318",
+    "commander": "~14.0.3",
+    "yaml": "~2.8.4"
   }
-}
+}

package/template/apm.config.json

@@ -0,0 +1,5 @@
+{
+    "name": "project-name",
+    "frontendDeploy": {},
+    "backendDeploy": {}
+}

package/template/deploy/README.md

@@ -0,0 +1,3 @@
+## 部署文档
+
+<!--在这里写部署的命令-->

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

@@ -0,0 +1,38 @@
+---
+name: apm-review
+description: 根据需求 ID 读取工作项 prd.md，对照代码做需求评审；评审立场依可见代码而定（仅前台 / 仅后台 / 全栈）；提交到评论的正文用 Markdown 拉出层次与重点，业务白话、避免代码与工程术语；结合代码交付面过滤与现状无关的空头边界质疑，当用户在对话中 @ 本技能时使用。
+---
+
+# APM 需求评审（对照代码）
+
+用户仅提供 **需求 ID**（workitem id）。缺 ID 时索要，不猜测。
+
+**评审规范与评审模板**（受众与用语、立场与范围、书写约束、正文示例等）见同目录 **[apm-review-reference.md](./apm-review-reference.md)**；执行本技能时须按该文件撰写评审正文。
+
+## 强制执行顺序（三步）
+
+### 步骤 1：读取 `prd.md`
+
+1. 使用 **Read** 读取 `.apm/workitems/<需求ID>/prd.md`。
+2. 若 Read **失败**（文件不存在或无法读取）：本步骤记为失败，**终止**，不执行步骤 2、3。
+
+### 步骤 2：撰写评审、落盘、推送、清理
+
+1. 使用 **Read** 读取 [apm-review-reference.md](./apm-review-reference.md)（与 `SKILL.md` 同目录），并依其中规范对照代码撰写 **Markdown 评审正文**：**只写确实存在的问题**；用「需求背景 / 需求范围 / 交互与功能要求第 X 节 / 非目标」等文档自有结构**点名条款**，不先单独铺一节「对用户意图的理解」。撰写前须完成代码检索并锁定本轮**评审立场**（见 reference 中「评审立场」），正文内容与措辞须与该立场一致，**不得超越可见范围下断定**。
+2. 使用 **Write** 将正文写入**临时文件**，路径建议使用**绝对路径**，例如 `/tmp/apm-review-<需求ID>.md`（避免与相对 cwd 混淆）。
+3. 在项目根目录下执行：`apm comment <需求ID> --file=<临时文件绝对路径> --model=<评论使用的模型名称>`。
+4. 命令结束后 **删除临时文件**（**Delete** 工具或 `rm`），无论命令成功或失败都尽量清理（失败时保留文件仅供用户排错——技能默认仍删除，若需保留应在表格备注中说明）。
+
+### 步骤 3：回复用户
+
+对用户可见回复 **仅限一张 Markdown 表格**，汇总三步的**结果**（成功/失败、摘要信息）。**不得**在表格外输出任何其他内容（不在对话中粘贴完整评审正文；正文已通过 `apm comment` 提交）。
+
+建议表头：
+
+| 步骤 | 结果 | 说明 |
+|------|------|------|
+| 1. 读取 prd.md | 成功 / 失败 | 例如实际读取路径；失败时写错误原因 |
+| 2. 评审与 comment | 成功 / 失败 | 临时文件路径（已删可写「已清理」）；`apm comment` 退出情况或 API 返回摘要；**建议**注明本轮评审立场（仅前台 / 仅后台 / 全栈） |
+| 3. 清理临时文件 | 成功 / 失败 | — |
+
+内部编排：**通读 prd → 检索并对照与需求相关的代码 → 判定本轮可见范围（仅前台 / 仅后台 / 全栈）并选定评审立场 → 将技术发现改写为业务白话 → 只输出有问题之处**；唯**对用户输出**遵守上表约束。