ai-project-manage-cli 4.0.11 → 4.0.13

package/dist/index.js

@@ -247,11 +247,9 @@ var KIND_MAP = {
   clarify: "CLARIFY",
   difficulty: "DIFFICULTY",
   business: "BUSINESS",
-  coordination: "COORDINATION",
   CLARIFY: "CLARIFY",
   DIFFICULTY: "DIFFICULTY",
-  BUSINESS: "BUSINESS",
-  COORDINATION: "COORDINATION"
+  BUSINESS: "BUSINESS"
 };
 var STANCE_VALUES = /* @__PURE__ */ new Set(["frontend", "backend", "fullstack"]);
 function asRecord(value) {
@@ -273,8 +271,13 @@ function parseKind(raw, index) {
   const key = String(raw ?? "").trim();
   const kind = KIND_MAP[key] ?? KIND_MAP[key.toLowerCase()];
   if (!kind) {
+    if (key.toLowerCase() === "coordination" || key === "COORDINATION") {
+      throw new Error(
+        `items[${index}].kind \u4E0D\u518D\u652F\u6301 coordination\uFF08\u8054\u8C03\u4F9D\u8D56\uFF09\uFF1B\u8BF7\u52FF\u8F93\u51FA\u63A5\u53E3/\u8054\u8C03\u7C7B\u8BC4\u5BA1\u6761\u76EE`
+      );
+    }
     throw new Error(
-      `items[${index}].kind \u65E0\u6548\uFF0C\u5E94\u4E3A clarify | difficulty | business | coordination`
+      `items[${index}].kind \u65E0\u6548\uFF0C\u5E94\u4E3A clarify | difficulty | business`
     );
   }
   return kind;
@@ -307,9 +310,6 @@ function parseStructuredReviewYaml(raw, cliModel) {
     if (!body) {
       throw new Error(`items[${index}].body \u4E0D\u80FD\u4E3A\u7A7A`);
     }
-    if (kind === "COORDINATION" && item.reply != null && String(item.reply).trim()) {
-      throw new Error(`items[${index}] \u8054\u8C03\u4F9D\u8D56\uFF08coordination\uFF09\u4E0D\u5141\u8BB8 reply`);
-    }
     return {
       startLine: anchor.start,
       endLine: anchor.end,
@@ -1206,6 +1206,38 @@ async function runUpdate() {
   }
 }
 
+// src/commands/update-skills.ts
+import { cpSync as cpSync2, existsSync as existsSync4, rmSync, statSync as statSync3 } from "fs";
+import { join as join10 } from "path";
+var TEMPLATE_SKILLS_DIR = join10(CLI_TEMPLATE_DIR, "skills");
+async function runUpdateSkills() {
+  const apmDir = WORKSPACE_APM_DIR;
+  if (!existsSync4(apmDir)) {
+    console.error("[apm] \u672A\u627E\u5230 .apm \u76EE\u5F55\uFF0C\u8BF7\u5148\u6267\u884C apm init");
+    process.exit(1);
+  }
+  const apmStat = statSync3(apmDir);
+  if (!apmStat.isDirectory()) {
+    throw new Error(`[apm] \u8DEF\u5F84\u5DF2\u5B58\u5728\u4F46\u4E0D\u662F\u76EE\u5F55: ${apmDir}`);
+  }
+  let templateStat;
+  try {
+    templateStat = statSync3(TEMPLATE_SKILLS_DIR);
+  } catch {
+    throw new Error(`[apm] \u5185\u7F6E\u6280\u80FD\u6A21\u677F\u4E0D\u5B58\u5728: ${TEMPLATE_SKILLS_DIR}`);
+  }
+  if (!templateStat.isDirectory()) {
+    throw new Error(`[apm] \u5185\u7F6E\u6280\u80FD\u6A21\u677F\u4E0D\u662F\u76EE\u5F55: ${TEMPLATE_SKILLS_DIR}`);
+  }
+  const skillsDir = join10(apmDir, "skills");
+  if (existsSync4(skillsDir)) {
+    rmSync(skillsDir, { recursive: true, force: true });
+  }
+  await ensureDirExists(apmDir);
+  cpSync2(TEMPLATE_SKILLS_DIR, skillsDir, { recursive: true });
+  console.log("[apm] \u5DF2\u66F4\u65B0 .apm/skills");
+}
+
 // src/commands/update-dev-status.ts
 async function runUpdateDevStatus(requirementId, status) {
   const cfg = await ensureLoggedConfig();
@@ -1232,14 +1264,14 @@ async function runUpdateStatus(requirementId, status) {
 import path5 from "node:path";
 
 // src/commands/deploy/internal/apm-config.ts
-import { existsSync as existsSync4, readFileSync as readFileSync7 } from "node:fs";
+import { existsSync as existsSync5, readFileSync as readFileSync7 } from "node:fs";
 import { resolve as resolve4 } from "node:path";
 function loadApmConfig(options) {
   const p = resolve4(
     process.cwd(),
     options?.configPath ?? resolve4(WORKSPACE_APM_DIR, "apm.config.json")
   );
-  if (!existsSync4(p)) {
+  if (!existsSync5(p)) {
     console.error(`\u672A\u627E\u5230\u914D\u7F6E\u6587\u4EF6\uFF1A${p}`);
     process.exit(1);
   }
@@ -1343,7 +1375,7 @@ import path4 from "node:path";
 import Docker from "dockerode";
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/connection-options.ts
-import { existsSync as existsSync5, readFileSync as readFileSync8 } from "node:fs";
+import { existsSync as existsSync6, readFileSync as readFileSync8 } from "node:fs";
 import path from "node:path";
 function asOptionalTlsBuffer(value) {
   if (typeof value !== "string") {
@@ -1355,7 +1387,7 @@ function asOptionalTlsBuffer(value) {
   if (normalized === "") {
     return void 0;
   }
-  if (existsSync5(normalized)) {
+  if (existsSync6(normalized)) {
     return readFileSync8(normalized);
   }
   const looksLikePath = /[\\/]/.test(normalized) || normalized.endsWith(".pem");
@@ -1566,7 +1598,7 @@ var DockerodeClient = class {
 var createDockerodeClient = (config) => new DockerodeClient(config);
 
 // src/commands/deploy/internal/backend-deploy/dockerode-client/env.ts
-import { existsSync as existsSync6, readFileSync as readFileSync9, statSync as statSync3 } from "node:fs";
+import { existsSync as existsSync7, readFileSync as readFileSync9, statSync as statSync4 } from "node:fs";
 import path2 from "node:path";
 function stripSurroundingQuotes(value) {
   const t = value.trim();
@@ -1583,7 +1615,7 @@ function loadEnvFromFile(envFilePath) {
     return {};
   }
   const targetPath = path2.resolve(envFilePath);
-  if (!existsSync6(targetPath) || !statSync3(targetPath).isFile()) {
+  if (!existsSync7(targetPath) || !statSync4(targetPath).isFile()) {
     return {};
   }
   const raw = readFileSync9(targetPath, "utf-8");
@@ -1757,12 +1789,12 @@ function dockerPushImage(params, cwd) {
 }
 
 // src/commands/deploy/internal/backend-deploy/resolve-dockerfile.ts
-import { existsSync as existsSync7 } from "node:fs";
+import { existsSync as existsSync8 } from "node:fs";
 import path3 from "node:path";
 function resolveDockerBuildPaths(cwd) {
   const dockerfilePath = path3.join(cwd, "Dockerfile");
   Logger.info(`\u67E5\u627EDockerfile\u6587\u4EF6\uFF0C\u8DEF\u5F84: ${dockerfilePath}`);
-  if (!existsSync7(dockerfilePath)) {
+  if (!existsSync8(dockerfilePath)) {
     throw new Error(`Dockerfile \u4E0D\u5B58\u5728\uFF1A${dockerfilePath}`);
   }
   Logger.info("\u2713 Dockerfile \u5B58\u5728");
@@ -1891,11 +1923,11 @@ import { copyFile, readdir as readdir2, stat } from "node:fs/promises";
 import path7 from "node:path";
 
 // src/commands/deploy/internal/load-apm-dotenv.ts
-import { existsSync as existsSync8, readFileSync as readFileSync10 } from "node:fs";
-import { join as join10 } from "node:path";
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "node:fs";
+import { join as join11 } from "node:path";
 function loadApmDotEnvIfPresent() {
-  const p = join10(WORKSPACE_APM_DIR, ".env");
-  if (!existsSync8(p)) {
+  const p = join11(WORKSPACE_APM_DIR, ".env");
+  if (!existsSync9(p)) {
     return;
   }
   let text;
@@ -1925,14 +1957,14 @@ function loadApmDotEnvIfPresent() {
 }
 
 // src/commands/deploy/internal/minio.ts
-import { statSync as statSync4 } from "node:fs";
+import { statSync as statSync5 } from "node:fs";
 import { readdir } from "node:fs/promises";
 import path6 from "node:path";
 import * as Minio from "minio";
 var DEFAULT_MAX_FILE_SIZE_MB = 50;
 async function isDirectoryPath(dir) {
   try {
-    const st = statSync4(dir);
+    const st = statSync5(dir);
     return st.isDirectory();
   } catch {
     return false;
@@ -1962,7 +1994,7 @@ async function collectFiles(root) {
       if (e.isDirectory()) {
         await walk(abs, rel);
       } else if (e.isFile()) {
-        const st = statSync4(abs);
+        const st = statSync5(abs);
         out.push({
           absPath: abs,
           relativePath: rel.replace(/\\/g, "/"),
@@ -2280,6 +2312,11 @@ function buildProgram() {
   ).action(async () => {
     await runUpdate();
   });
+  program.command("update-skills").description(
+    "\u5220\u9664\u5DE5\u4F5C\u533A .apm/skills \u540E\uFF0C\u4ECE\u5F53\u524D CLI \u5185\u7F6E\u6A21\u677F\u91CD\u65B0\u590D\u5236\u6280\u80FD\u76EE\u5F55"
+  ).action(async () => {
+    await runUpdateSkills();
+  });
   program.command("pull").description(
     "GET /api/cli/requirements/pull\uFF0C\u540C\u6B65\u6570\u636E\u4E0E\u9644\u4EF6\u5230 .apm/workitems/<\u9700\u6C42ID>"
   ).argument("<requirementId>", "\u9700\u6C42 ID").action(async (requirementId) => {

package/package.json

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

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

@@ -39,7 +39,7 @@ description: 根据需求 ID 读取 prd.md 与 reviews.xml，润色为简短、
 | 属性 / 节点     | 含义                                                                                    |
 | --------------- | --------------------------------------------------------------------------------------- |
 | `start` / `end` | 锚定 `prd.md` 行号（1-based，闭区间），合并时优先据此定位段落                           |
-| `kind`          | `clarify` / `difficulty` / `business` / `coordination`；**仅处理含非空 `reply` 的条目** |
+| `kind`          | `clarify` / `difficulty` / `business`；**仅处理含非空 `reply` 的条目**（历史 `coordination` 无 reply，忽略） |
 | `body`          | 评审意见（辅助理解，不作为正文来源）                                                    |
 | `reply`         | 产品回复，**并入正文**的权威补充                                                        |
 
@@ -47,7 +47,7 @@ description: 根据需求 ID 读取 prd.md 与 reviews.xml，润色为简短、
 
 1. **正文 = 需求原文 + 已拍板补充**：将各 `<item>` 中非空 `reply` 并入 `prd.md` 对应行区间（或该行所在需求点）；未回复的评审本次不处理。
 2. **定位**：优先按 `start`–`end` 行号找到段落；行号区间与章节标题不一致时，以**业务语义**归入最近的需求点，**不要**机械插入到错误章节。
-3. **冲突**：`reply` 与原文冲突时以 `reply` 为准；`coordination` 类条目通常无 `reply`，润色时忽略。
+3. **冲突**：`reply` 与原文冲突时以 `reply` 为准；无 `reply` 的条目（含历史联调类）润色时忽略。
 4. **同一议题只写一处**；合并后篇幅短于或接近原文。
 5. **图片**：原文图片语法原样保留；理解图片后把规则写入对应需求点的文字描述。
 

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

@@ -31,7 +31,7 @@ description: 结合本仓库上下文对需求做结构化评审，只有当用
 
 **去重规则**（按立场选用）：
 
-- **前端立场**：只写界面与交互侧待澄清，不写落库/API 契约类问题（联调诉求用 `kind: coordination`）。
+- **前端立场**：只写界面与交互侧待澄清，不写落库/API 契约类问题。
 - **后端立场**：只写流程、规则与数据侧待澄清，不写控件选型、Tab 布局等纯 UI 问题。
 - **全栈立场**：同一业务点合并为一条 `clarify`，**不要**拆成两句意思重复的问题。
 
@@ -42,15 +42,25 @@ description: 结合本仓库上下文对需求做结构化评审，只有当用
 3. **锚定 PRD**：每条 `items[]` 必须写 **`anchor: { start, end }`**，与 Read 读到的 `prd.md` 行号一致；**不**在 `body` 里复述该段需求原文。
 4. **问题 = 文档缺口**：只写 PRD **未写清**且**影响本端理解边界**的点。已写清楚的规则不要重复质疑。
 
-## 不在「待澄清」里写的内容
+## 禁止输出的内容（不要写入 items）
 
-以下不得使用 `kind: clarify`，若需记录则用 **`kind: coordination`**（且必须有行号锚定）：
+以下内容**一律跳过**，不得创建任何评审条目（**禁止**使用已废弃的 `coordination` 类型）：
 
-- 接口字段名、请求体结构、子表编码
-- 前后端谁传哪个参数、现有 edit 接口是否够用
-- 与现网代码实现对齐的改造方案
+- 接口字段名、请求体结构、子表编码、API 路径
+- 前后端谁传哪个参数、与现网实现对齐的改造方案
+- 「联调依赖」「需与后端/前端对齐接口」类事项
 
-`coordination` **不用产品回复**，仅作记录，待技术评审阶段处理。若同一行区间既要澄清又要联调，**拆成两条** `items`。
+上述问题属于**技术评审**范畴，由研发在技术评审阶段处理，本产品评审只面向产品经理可回答的业务澄清。
+
+## 允许的 kind
+
+仅可使用以下三种（YAML 小写）：
+
+| `kind`       | 含义       | 何时使用                         |
+| ------------ | ---------- | -------------------------------- |
+| `clarify`    | 待澄清     | 文档未写清、影响本端理解边界     |
+| `difficulty` | 实现难度高 | 仅改造面大或业务逻辑影响大时     |
+| `business`   | 业务合理性 | 仅方案与业务目标明显冲突或非较优 |
 
 ## 评审原则
 
@@ -75,14 +85,14 @@ description: 结合本仓库上下文对需求做结构化评审，只有当用
 ### 步骤 3：评审与提交
 
 1. **锁定立场**，填入 YAML `reviewer.stance`（`frontend` / `backend` / `fullstack`）。
-2. **拆条**：每条对应 `prd.md` 连续行号；按需设置 `kind`（`clarify` / `difficulty` / `business` / `coordination`）与 `body`。
+2. **拆条**：每条对应 `prd.md` 连续行号；按需设置 `kind`（`clarify` / `difficulty` / `business`）与 `body`。
 3. **成文**：按 **[output-template.md](./output-template.md)** 写 YAML。
 4. 使用 **Write** 写入临时文件（建议 `/tmp/apm-review-<需求ID>.yaml`）。
 5. **自检**：
    - 每条均有 `anchor`，且无全篇评审；
    - `stance` 与立场一致；
    - `clarify` 均为产品可回答的业务问题；
-   - `coordination` 无 `reply` 字段；
+   - **未**出现 `coordination` 或联调/API 契约类条目；
    - 无重复语义的条目。
 6. 在项目根目录执行：
 

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

@@ -29,11 +29,6 @@ items:
     kind: difficulty
     body: |
       - 用产品语言说明改造面：涉及哪些页面/流程/规则，为何面大
-
-  - anchor: { start: 44, end: 55 }
-    kind: coordination
-    body: |
-      - 需与后端对齐的接口/字段诉求（不用产品回复）
 ```
 
 ## kind 与技能表述
@@ -43,17 +38,18 @@ items:
 | `clarify`           | 待澄清     | 文档未写清、影响本端理解边界 |
 | `difficulty`        | 实现难度高 | 仅改造面大或业务逻辑影响大时 |
 | `business`          | 业务合理性 | 仅方案明显不合理时           |
-| `coordination`      | 联调依赖   | **禁止** `reply`；待技术评审 |
+
+**禁止**使用 `coordination`（联调依赖已废弃）：接口/联调类事项不要写入评审。
 
 ## 字段规则
 
-| 字段              | 规则                                                             |
-| ----------------- | ---------------------------------------------------------------- |
-| `reviewer.stance` | 必填：`frontend` / `backend` / `fullstack`                       |
-| `reviewer.model`  | 建议填写；可被 CLI `--model` 覆盖                                |
+| 字段              | 规则                                                       |
+| ----------------- | ---------------------------------------------------------- |
+| `reviewer.stance` | 必填：`frontend` / `backend` / `fullstack`                 |
+| `reviewer.model`  | 建议填写；可被 CLI `--model` 覆盖                          |
 | `anchor`          | 必填 `{ start, end }`，1-based 闭区间，与 Read `prd.md` 行号一致 |
-| `body`            | 必填；产品语言；**禁止**全篇评审（必须有行号）                   |
-| 同区间多类型      | 拆成多条 `items`（例如同时 `clarify` 与 `coordination` 各一条）  |
+| `body`            | 必填；产品语言；**禁止**全篇评审（必须有行号）             |
+| 同区间多类型      | 可拆成多条 `items`（例如同时 `clarify` 与 `difficulty`）   |
 
 ## 提交命令