ai-project-manage-cli 1.0.29 → 2.0.1

package/dist/core/cursor-cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-cmd.js","sourceRoot":"","sources":["../../src/core/cursor-cmd.ts"],"names":[],"mappings":"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"}

package/dist/core/std-event-handler.d.ts

@@ -0,0 +1,25 @@
+export declare class StdoutEventHandler {
+    private onChunk;
+    cacheText: string;
+    constructor(onChunk: (chunk: any) => void);
+    onData: (chunk: Buffer) => void;
+    onEnd: () => void;
+    private log;
+}
+export declare class StderrEventHandler {
+    private onChunk;
+    private stderrDecoder;
+    constructor(onChunk: (chunk: any) => void);
+    onData: (chunk: Buffer) => void;
+    onEnd: () => void;
+    private log;
+}
+export declare class ChildProcessEventHandler {
+    private command;
+    private onChunk;
+    private errorMessage;
+    constructor(command: string, onChunk: (chunk: any) => void);
+    onClose: (code: number, signal: string) => void;
+    onError: (err: Error) => void;
+}
+//# sourceMappingURL=std-event-handler.d.ts.map

package/dist/core/std-event-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"std-event-handler.d.ts","sourceRoot":"","sources":["../../src/core/std-event-handler.ts"],"names":[],"mappings":"AAGA,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,OAAO;IAF3B,SAAS,EAAE,MAAM,CAAM;gBAEH,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI;IAEjD,MAAM,UAAW,MAAM,UAerB;IAEF,KAAK,aAOH;IAEF,OAAO,CAAC,GAAG;CAGZ;AAED,qBAAa,kBAAkB;IAGjB,OAAO,CAAC,OAAO;IAF3B,OAAO,CAAC,aAAa,CAAgB;gBAEjB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI;IAKjD,MAAM,UAAW,MAAM,UAMrB;IAEF,KAAK,aAKH;IAEF,OAAO,CAAC,GAAG;CAGZ;AAED,qBAAa,wBAAwB;IAEvB,OAAO,CAAC,OAAO;IAAU,OAAO,CAAC,OAAO;IADpD,OAAO,CAAC,YAAY,CAAc;gBACd,OAAO,EAAE,MAAM,EAAU,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI;IAE1E,OAAO,SAAU,MAAM,UAAU,MAAM,UAMrC;IAEF,OAAO,QAAS,KAAK,UAOnB;CACH"}

package/dist/core/std-event-handler.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChildProcessEventHandler = exports.StderrEventHandler = exports.StdoutEventHandler = void 0;
+const node_string_decoder_1 = require("node:string_decoder");
+const utils_1 = require("./utils");
+class StdoutEventHandler {
+    onChunk;
+    cacheText = "";
+    constructor(onChunk) {
+        this.onChunk = onChunk;
+    }
+    onData = (chunk) => {
+        const text = String(chunk);
+        // 输出到控制台
+        this.log(text);
+        this.cacheText += text;
+        let idx;
+        while ((idx = this.cacheText.indexOf("\n")) !== -1) {
+            const line = this.cacheText.slice(0, idx);
+            this.cacheText = this.cacheText.slice(idx + 1);
+            const ev = (0, utils_1.parseNdjsonLine)(line);
+            if (ev !== null) {
+                this.onChunk(ev);
+            }
+        }
+    };
+    onEnd = () => {
+        const rest = this.cacheText;
+        this.cacheText = "";
+        const ev = (0, utils_1.parseNdjsonLine)(rest);
+        if (ev !== null) {
+            this.onChunk(ev);
+        }
+    };
+    log(text) {
+        process.stdout.write(text);
+    }
+}
+exports.StdoutEventHandler = StdoutEventHandler;
+class StderrEventHandler {
+    onChunk;
+    stderrDecoder;
+    constructor(onChunk) {
+        this.onChunk = onChunk;
+        const stderrDecoder = new node_string_decoder_1.StringDecoder("utf8");
+        this.stderrDecoder = stderrDecoder;
+    }
+    onData = (chunk) => {
+        const text = this.stderrDecoder.write(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
+        this.log(text);
+        this.onChunk(text);
+    };
+    onEnd = () => {
+        const tail = this.stderrDecoder.end();
+        if (!tail)
+            return;
+        this.log(tail);
+        this.onChunk(tail);
+    };
+    log(text) {
+        process.stderr.write(text);
+    }
+}
+exports.StderrEventHandler = StderrEventHandler;
+class ChildProcessEventHandler {
+    command;
+    onChunk;
+    errorMessage = "";
+    constructor(command, onChunk) {
+        this.command = command;
+        this.onChunk = onChunk;
+    }
+    onClose = (code, signal) => {
+        if (this.errorMessage) {
+            console.error(`[${this.command}]执行出错: ${this.errorMessage}`);
+            return;
+        }
+        console.log(`[${this.command}]执行结束, ${code} ${signal}`);
+    };
+    onError = (err) => {
+        this.errorMessage = err.message;
+        this.onChunk({
+            type: "error",
+            message: err.message,
+            at: new Date().toISOString(),
+        });
+    };
+}
+exports.ChildProcessEventHandler = ChildProcessEventHandler;
+//# sourceMappingURL=std-event-handler.js.map

package/dist/core/std-event-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"std-event-handler.js","sourceRoot":"","sources":["../../src/core/std-event-handler.ts"],"names":[],"mappings":"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"}

package/dist/core/utils.d.ts

@@ -0,0 +1,18 @@
+export declare function parseNdjsonLine(line: string): unknown | null;
+/**
+ * 统一处理来自服务端或本地的 prompt：安全字符、空白与首词拆分。
+ * 典型用法：先 `cleanPrompt`，再对 `fullText` 或 `bodyWithoutHead` 调用 `escapePromptForCliArg` 作为 agent argv。
+ */
+export declare function cleanPrompt(raw: string): {
+    fullText: string;
+    headToken: string;
+    bodyWithoutHead: string;
+};
+/**
+ * 将用户 prompt 转为适合作为 CLI 单个 argv 的字符串。
+ * Windows 下经 cmd.exe 拼接时，换行、未配对引号等易破坏解析；使用 C 风格转义
+ *（\\、\\n、\\t、\\"）压成单行。Unix 下 spawn argv 虽通常可原样传递，
+ * 为与 agent 行为一致仍做相同归一化。
+ */
+export declare function escapePromptForCliArg(raw: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAiB5D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM;;;;EAatC;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CASzD"}

package/dist/core/utils.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseNdjsonLine = parseNdjsonLine;
+exports.cleanPrompt = cleanPrompt;
+exports.escapePromptForCliArg = escapePromptForCliArg;
+function parseNdjsonLine(line) {
+    const trimmed = line.replace(/\r$/, "").trim();
+    if (!trimmed)
+        return null;
+    let v;
+    try {
+        v = JSON.parse(trimmed);
+    }
+    catch {
+        return { type: "stdout", parseError: true, raw: trimmed };
+    }
+    if (typeof v === "string") {
+        try {
+            return JSON.parse(v);
+        }
+        catch {
+            return v;
+        }
+    }
+    return v;
+}
+/**
+ * 统一处理来自服务端或本地的 prompt：安全字符、空白与首词拆分。
+ * 典型用法：先 `cleanPrompt`，再对 `fullText` 或 `bodyWithoutHead` 调用 `escapePromptForCliArg` 作为 agent argv。
+ */
+function cleanPrompt(raw) {
+    let s = raw.replace(/\0/g, "");
+    s = s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    s = s.replace(/\u2028/g, "\n").replace(/\u2029/g, "\n");
+    s = s.trim();
+    const parts = s.split(/\s+/).filter(Boolean);
+    const head = parts[0] ?? "";
+    const bodyWithoutHead = parts.slice(1).join(" ").trim();
+    return {
+        fullText: s,
+        headToken: head || "unknown",
+        bodyWithoutHead,
+    };
+}
+/**
+ * 将用户 prompt 转为适合作为 CLI 单个 argv 的字符串。
+ * Windows 下经 cmd.exe 拼接时，换行、未配对引号等易破坏解析；使用 C 风格转义
+ *（\\、\\n、\\t、\\"）压成单行。Unix 下 spawn argv 虽通常可原样传递，
+ * 为与 agent 行为一致仍做相同归一化。
+ */
+function escapePromptForCliArg(raw) {
+    let s = raw.replace(/\0/g, "");
+    s = s.replace(/\r\n/g, "\n").replace(/\r/g, "\n");
+    s = s.replace(/\u2028/g, "\n").replace(/\u2029/g, "\n");
+    s = s.replace(/\\/g, "\\\\");
+    s = s.replace(/\n/g, "\\n");
+    s = s.replace(/\t/g, "\\t");
+    s = s.replace(/"/g, '\\"');
+    return s;
+}
+//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":";;AAAA,0CAiBC;AAMD,kCAaC;AAQD,sDASC;AArDD,SAAgB,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAU,CAAC;IACf,IAAI,CAAC;QACH,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACb,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,IAAI,IAAI,SAAS;QAC5B,eAAe;KAChB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,qBAAqB,CAAC,GAAW;IAC/C,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/core/ws-client.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 员工 CLI WebSocket：与后端 `AppWebSocketGateway` 一致，
+ * 使用 URL 查询参数 `token`（`Employee.cliToken`），路径 `/ws`；
+ * 端口优先 `apm config set ws-port`，否则回退 {@link FALLBACK_EMPLOYEE_WS_PORT}。
+ */
+import WebSocket from "ws";
+import { CursorCmdPayload } from "./cursor-cmd";
+/** 与 `EmployeeWebsocketPushService.pushToEmployee` 发送格式一致 */
+export type EmployeeWsServerMessage = {
+    event: string;
+    data: CursorCmdPayload;
+};
+export declare class EmployeeWebSocketClient {
+    client: WebSocket;
+    constructor();
+    buildEmployeeWebSocketUrl(): string;
+    parseMessageData(data: Buffer): EmployeeWsServerMessage | null;
+    close: () => void;
+    onOpen: () => void;
+    onClose: (code: number, reason: Buffer) => void;
+    onError: (err: Error) => void;
+    onMessage: (data: Buffer) => void;
+}
+//# sourceMappingURL=ws-client.d.ts.map

package/dist/core/ws-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.d.ts","sourceRoot":"","sources":["../../src/core/ws-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,OAAO,EAAa,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE3D,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,qBAAa,uBAAuB;IAClC,MAAM,EAAE,SAAS,CAAC;;IAYlB,yBAAyB,IAAI,MAAM;IAcnC,gBAAgB,CAAC,IAAI,EAAE,MAAM;IAmB7B,KAAK,aAEH;IAEF,MAAM,aAEJ;IAEF,OAAO,SAAU,MAAM,UAAU,MAAM,UAErC;IAEF,OAAO,QAAS,KAAK,UAEnB;IAEF,SAAS,SAAU,MAAM,UAQvB;CACH"}

package/dist/core/ws-client.js

@@ -0,0 +1,79 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmployeeWebSocketClient = void 0;
+/**
+ * 员工 CLI WebSocket：与后端 `AppWebSocketGateway` 一致，
+ * 使用 URL 查询参数 `token`（`Employee.cliToken`），路径 `/ws`；
+ * 端口优先 `apm config set ws-port`，否则回退 {@link FALLBACK_EMPLOYEE_WS_PORT}。
+ */
+const ws_1 = __importDefault(require("ws"));
+const apm_config_1 = require("./apm-config");
+const cursor_cmd_1 = require("./cursor-cmd");
+class EmployeeWebSocketClient {
+    client;
+    constructor() {
+        const url = this.buildEmployeeWebSocketUrl();
+        const client = new ws_1.default(url);
+        this.client = client;
+        client.on("open", this.onOpen);
+        client.on("close", this.onClose);
+        client.on("error", this.onError);
+        client.on("message", this.onMessage);
+    }
+    buildEmployeeWebSocketUrl() {
+        const config = (0, apm_config_1.loadApmConfig)();
+        const url = new URL(config.server.url);
+        const token = config.auth.token;
+        const port = config.server.wsPort || 4000;
+        if (!token) {
+            console.error("token 不存在，请先执行 apm login");
+            process.exit(1);
+        }
+        const wsProto = url.protocol === "https:" ? "wss:" : "ws:";
+        const params = new URLSearchParams({ token: token.trim() });
+        return `${wsProto}//${url.hostname}:${port}/ws?${params.toString()}`;
+    }
+    parseMessageData(data) {
+        const raw = Buffer.isBuffer(data) ? data.toString("utf8") : String(data);
+        let parsed = null;
+        try {
+            const j = JSON.parse(raw);
+            if (j &&
+                typeof j === "object" &&
+                "event" in j &&
+                typeof j.event === "string") {
+                parsed = j;
+            }
+        }
+        catch {
+            /* 非 JSON 时 parsed 保持 null */
+        }
+        return parsed;
+    }
+    close = () => {
+        this.client.close();
+    };
+    onOpen = () => {
+        console.log("已连接AI项目管理平台，等待服务指令...");
+    };
+    onClose = (code, reason) => {
+        console.log(`连接关闭 code=${code} ${reason.toString()}`);
+    };
+    onError = (err) => {
+        console.error(err.message);
+    };
+    onMessage = (data) => {
+        // 仅处理Cursor事件
+        const parsed = this.parseMessageData(data);
+        if (parsed?.event !== "cursor") {
+            return;
+        }
+        const cmd = new cursor_cmd_1.CursorCmd(parsed.data);
+        cmd.execute();
+    };
+}
+exports.EmployeeWebSocketClient = EmployeeWebSocketClient;
+//# sourceMappingURL=ws-client.js.map

package/dist/core/ws-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-client.js","sourceRoot":"","sources":["../../src/core/ws-client.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "ai-project-manage-cli",
-  "version": "1.0.29",
+  "version": "2.0.1",
   "private": false,
-  "description": "CLI / SDK for AI项目管理",
+  "description": "AI 项目管理 CLI 工具，结合飞书项目实现AI项目开发工作流",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "bin": {
@@ -48,4 +48,4 @@
     "typescript": "~5.7.3",
     "@types/ws": "~8.18.1"
   }
-}
+}

package/templates/skills/apm-auto-dev/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: apm-auto-dev
-description: 按分支 ID、分支名、基准分支、需求 ID、版本序号全自动拉分支、更新分支状态、落盘 PRD、串联 openspec-propose 与 openspec-apply-change、生成 MR 评审说明并推送远程。在用户要求全自动开发、APM 自动交付、或给出上述参数时使用。
+description: 按分支 ID、分支名、基准分支、需求 ID、版本序号全自动拉分支、更新分支状态、落盘 PRD；步骤 3 后主 Agent 据 PRD 二选一 Quick（直接实现）或 Spec（openspec-propose + openspec-apply-change）；再生成 MR 评审说明、推送、部署与分支状态更新。在用户要求全自动开发、APM 自动交付、或给出上述参数时使用。
 ---
 
 # APM 全自动开发（编排技能）
 
-**角色**：主 Agent 只做参数传递、**串行**启动子 Agent、校验上一步产物、失败则停止并汇总（**例外见步骤 8/9**）；**禁止**在同一对话里自己执行完整 propose+apply 长流程而不用子 Agent。
+**角色**：主 Agent 只做参数传递、**串行**启动子 Agent、校验上一步产物、失败则停止并汇总（**例外见步骤 8/9**）；**禁止**在同一对话里自己执行完整 propose+apply 长流程而不用子 Agent。流程结束须输出**步骤结果汇总表**（见文末「主 Agent 汇总输出」）。
 
 **输入（必填）**
 
@@ -21,8 +21,11 @@ description: 按分支 ID、分支名、基准分支、需求 ID、版本序号
 
 ## 子 Agent 强制隔离
 
-- 下列步骤 **1～9** 各对应一次 **Task 子 Agent**（或等价：独立子会话），**严格串行**：仅当上一步子 Agent **明确结束**且主 Agent **已校验产物**后，再启动下一步（**步骤 8 发布失败时仍须启动步骤 9**，见步骤 8 说明）。
-- **禁止**并行启动多个子 Agent 执行本流程中的步骤。
+- 步骤 **1～3** 各对应一次 **Task 子 Agent**；**步骤 3 之后**主 Agent 判定 **Quick / Spec**（二选一，见下节），再启动 **仅一条**开发路径：
+  - **Quick**：一步子 Agent 完成「步骤 4（Quick）」后，直接进入步骤 6。
+  - **Spec**：步骤 **4（Spec）— openspec-propose** 与 **步骤 5（Spec）— openspec-apply-change** 各一次子 Agent，再进入步骤 6。
+- 步骤 **6～9** 各对应一次子 Agent，**严格串行**：仅当上一步子 Agent **明确结束**且主 Agent **已校验产物**后，再启动下一步（**步骤 8 发布失败时仍须启动步骤 9**，见步骤 8 说明）。
+- **禁止**并行启动多个子 Agent 执行本流程中的步骤；**禁止**同一次流程中既走 Quick 又走 Spec。
 - 子 Agent 需执行完毕：读 SKILL、跑命令、写文件、回报结构化结果（路径、变更名、成功/失败）。
 
 ---
@@ -78,7 +81,38 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status IN_DEVELOPMEN
 
 ---
 
-## 步骤 4 — 子 Agent：openspec-propose
+## 开发模式判定（主 Agent，紧接步骤 3 之后）
+
+在启动任何「步骤 4」子 Agent 之前，主 Agent 根据 **`.apm/workitems/<name>/prd.md`**（或步骤 2 回报摘要）判断本次采用 **Quick** 还是 **Spec**，**二者必选其一、互斥**：
+
+| 倾向 Quick | 倾向 Spec |
+|------------|-----------|
+| 逻辑面少、改动范围小、对现有行为影响面低 | 涉及多模块、协议/数据模型/权限等契约变化 |
+| 多为文案、样式、单点配置、小函数修补 | 需要可追溯规格与任务拆解、跨文件协调 |
+| 回归路径清晰、不易引入隐蔽 BUG | 歧义多或易出边界 BUG，需 propose/tasks 约束 |
+
+**规则**：若同时满足表中「倾向 Quick」的典型特征且不满足必须走 Spec 的红线，选 **Quick**；否则选 **Spec**。判定结果须写入最终汇总表（含一句简要理由）。
+
+- 选 **Quick** → 只执行 **步骤 4（Quick）**，**跳过** openspec-propose 与 openspec-apply-change（原步骤 4/5 Spec）。
+- 选 **Spec** → **跳过**步骤 4（Quick），依次执行 **步骤 4（Spec）**、**步骤 5（Spec）**。
+
+---
+
+## 步骤 4（Quick）— 子 Agent：直接实现（与 Spec 二选一）
+
+**前置**：开发模式判定为 **Quick**；本步与「步骤 4（Spec）+ 步骤 5（Spec）」**不得**同跑。
+
+1. 读取 **`.apm/workitems/<name>/prd.md` 全文**，按 PRD 在仓库内**直接完成实现**（改代码、配置、测试等以项目惯例为准），**不**创建 `openspec/changes/` 下的变更目录，**不**调用 openspec-propose / openspec-apply-change。
+2. 改动应可审阅：子 Agent 回报主要修改文件路径列表、自测结论（若有）；**不要**向用户追问需求细节，歧义按合理假设处理。
+3. 主 Agent 校验：工作区存在与 PRD 对应的实质变更（或子 Agent 明确说明无需改文件的合法情况）。
+
+**完成判定**：PRD 要点已在代码库中落实；无未完成的中途阻塞。
+
+---
+
+## 步骤 4（Spec）— 子 Agent：openspec-propose（与 Quick 二选一）
+
+**前置**：开发模式判定为 **Spec**；若已走 Quick，**不得**执行本节。
 
 1. 读取并遵循项目内技能：`.cursor/skills/openspec-propose/SKILL.md`。
 2. **输入**：仓库内文件路径 **`.apm/workitems/<name>/prd.md`**（子 Agent 应用 Read 读全文）；变更名可据 PRD 归纳 kebab-case；**不要**向用户追问。
@@ -88,10 +122,12 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status IN_DEVELOPMEN
 
 ---
 
-## 步骤 5 — 子 Agent：openspec-apply-change
+## 步骤 5（Spec）— 子 Agent：openspec-apply-change
+
+**前置**：仅 **Spec** 模式；步骤 4（Spec）已成功。
 
 1. 读取并遵循：`.cursor/skills/openspec-apply-change/SKILL.md`。
-2. **输入（必须）**：上一步回报的变更目录路径或 **`<change-name>`**（与 openspec-propose 产出一致）；主 Agent 必须将步骤 4 的结构化结果传入本子 Agent。
+2. **输入（必须）**：上一步回报的变更目录路径或 **`<change-name>`**（与 openspec-propose 产出一致）；主 Agent 必须将步骤 4（Spec）的结构化结果传入本子 Agent。
 3. 按该 SKILL 执行任务直至完成或**硬阻塞**（硬阻塞时停止全流程，汇总原因）。
 
 **完成判定**：该 SKILL 定义的完成/暂停语义达成；代码与任务勾选与仓库状态一致。
@@ -113,7 +149,7 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status IN_DEVELOPMEN
 ## 步骤 7 — 子 Agent：全量提交并推送
 
 1. `git status`：若有未跟踪或已修改文件，则 `git add -A`。
-2. 若有暂存变更：生成一条概括「全自动交付 + PRD/MR 文档 + OpenSpec 实现」的提交说明（可附 `change-name`、requirement id、version-seq），执行 `git commit`。
+2. 若有暂存变更：生成提交说明——**Spec** 模式可写「全自动交付 + PRD/MR 文档 + OpenSpec 实现」；**Quick** 模式写「全自动交付 + PRD/MR 文档 + 直接实现」（可附 `change-name`、requirement id、version-seq，Quick 无 openspec 时可省略 change-name），执行 `git commit`。
 3. **必须** `git push -u origin "<TARGET>"`（或当前分支已设 upstream 则 `git push`）；推送失败则回报 stderr，全流程标记失败。
 
 **完成判定**：推送成功；工作区干净或仅剩用户需自理的 stash 提示。
@@ -148,19 +184,40 @@ apm requirement branch set-status --branch-id <BRANCH_ID> --status PENDING_TEST
 
 ## 主 Agent 汇总输出
 
-用精简 Markdown 汇总：
+主 Agent 在流程末尾**必须**给出两部分：**（1）步骤结果汇总表**、**（2）补充说明**。
+
+### （1）步骤结果汇总表（必填）
+
+用 Markdown 表格列出**本流程实际执行的每一步**及结果（未执行的步骤标为「跳过」并简述原因）。列建议：`步骤` | `说明` | `结果` | `备注`。
+
+示例结构（主 Agent 按实况填行，不得留空表）：
+
+| 步骤 | 说明 | 结果 | 备注 |
+|------|------|------|------|
+| 1 | Git 分支与未提交处理 | 成功/失败 | … |
+| 2 | PRD 落盘 | … | `<name>` |
+| 3 | 分支状态 → 开发中 | … | |
+| 开发模式 | Quick 或 Spec | … | 一句判定理由 |
+| 4 | Quick 直接实现 **或** Spec propose **或** 跳过 | … | 与模式一致 |
+| 5 | Spec apply **或** 跳过 | … | Quick 时跳过 |
+| 6 | change.md | … | |
+| 7 | 提交与推送 | … | |
+| 8 | test-env-release | … | 失败仍继续步骤 9 |
+| 9 | 分支状态 → 待测试 | … | |
+
+### （2）补充说明
+
+在表后以精简列表补充：
 
-- 分支名、`.apm/workitems/<name>/` 路径、`openspec/changes/<change-name>/`
-- 各子步骤成功/失败
-- 步骤 8 测试环境部署结果（成功或失败原因；失败不阻断步骤 9）
-- 步骤 9 分支是否已置为「待测试」
-- 最终 commit SHA（若有）、远程推送结果
-- 若有 stash：提醒用户在其他分支上 `git stash pop` 时注意冲突
+- 分支名、`.apm/workitems/<name>/` 路径；**Spec** 时补充 `openspec/changes/<change-name>/`，**Quick** 时写明「未使用 OpenSpec 变更目录」。
+- 步骤 8 测试环境部署结果（成功或失败原因；失败不阻断步骤 9）。
+- 最终 commit SHA（若有）、远程推送结果。
+- 若有 stash：提醒用户在其他分支上 `git stash pop` 时注意冲突。
 
 ---
 
 ## 护栏
 
 - 任一步子 Agent 失败：**不要**静默跳过；停止后续步骤，输出失败步骤与可复现命令（**例外**：步骤 8 发布失败**不**停止步骤 9）。
-- 全程**不向用户追问**澄清需求；歧义按 openspec / apply 技能中的「合理假设、不反问」处理。
+- 全程**不向用户追问**澄清需求；歧义按 openspec / apply 技能中的「合理假设、不反问」处理；**Quick** 路径下同样适用合理假设、不反问。
 - **全流程交付完成**以步骤 9（分支已置为待测试）成功为准；步骤 8 发布失败仅作为告警项写入汇总，**不**单独阻断「交付完成」判定（但若步骤 9 失败，仍不得宣称全流程完成）。

package/templates/skills/requirement-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: requirement-review
-description: 结合本仓库上下文对需求做结构化评审，按 output-template.md 形成完整 Markdown 评审正文，并通过 CLI 写入评论正文（短正文可直接 --content；过长时用临时文件 --content-file，成功后删除）。输入为需求正文及 `commentId`（首轮与正文一起给出）。仅在用户明确声明使用本技能时应用。
+description: 结合本仓库上下文对需求做结构化评审，按 output-template.md 形成完整 Markdown 评审正文；**始终**将正文落盘到 `.apm/workitems/<name>/comment-<commentId>.md` 并通过 CLI `--content-file` 写入评论（**不删除**该文件）。输入为需求正文、`commentId`、workitem 目录名 `<name>`（首轮一并给出或可从 `.apm/workitems/` 唯一定位）。仅在用户明确声明使用本技能时应用。
 ---
 
 # 需求评审（仓库内）
@@ -10,18 +10,19 @@ description: 结合本仓库上下文对需求做结构化评审，按 output-te
 - **必须**：用户**明确声明**使用本技能（例如在对话中 @ 本 SKILL）
 - 未作上述声明时，**不**因「帮我看看需求」「评审一下」等表述自动套用本技能的工作方式与输出模板
 
-满足触发后，用户须在**首轮对话**中一并给出：**需求正文**、`commentId`（评论 id）。不要求路径或附件。
+满足触发后，用户须在**首轮对话**中一并给出：**需求正文**、`commentId`（评论 id）、**workitem 目录名 `<name>`**（与 `.apm/workitems/<name>/prd.md` 等同级产物所在目录一致，通常为 kebab-case）。若未给出 `<name>` 但仓库内**仅有一个**合理关联的 workitem 目录，可据 `.apm/workitems/` 推断；否则须先索要。不要求其他附件。
 
 ## 输入
 
 - **需求正文**：用户粘贴的待评审内容
 - **`commentId`**：评论记录 id（整数，与正文一起在对话中给出）
+- **`<name>`**：`.apm/workitems/<name>/` 下的目录名，用于落盘评论存档（见下文）；与首轮一并给出或由仓库唯一定位
 
-若首轮未给出 `commentId`，须先向用户索要后再执行第 6 步。
+若首轮未给出 `commentId` 或无法确定 `<name>`，须先向用户索要（或澄清）后再执行第 6 步。
 
 ## 输出
 
-- **评审正文**：须先按模板在**逻辑上**成文（完整 Markdown 字符串），不得仅给零散要点。可在回复中展示、可选保存为 `.md`，**均非必须**；第 6 步将该字符串写入评论：**短正文**可直接 `--content` 或 heredoc；**过长**（易触 shell 参数长度/转义问题）时写入**临时文件**并用 `--content-file`，成功后**删除该临时文件**（不落盘到仓库）。
+- **评审正文**：须先按模板在**逻辑上**成文（完整 Markdown 字符串），不得仅给零散要点。可在回复中展示。**落盘（强制）**：将第 4 步全文以 UTF-8 写入 **`.apm/workitems/<name>/comment-<commentId>.md`**（文件名中的 id 与输入 `commentId` 一致，例如 `comment-42.md`）；**始终保留该文件**，不因 CLI 成功而删除，也不使用临时目录替代。第 6 步**统一**用该路径作为 `--content-file` 更新评论（避免 shell 参数长度与转义问题）。
 - 将需求拆成若干条「需求点」（若本就一条则一条），对每条按 [output-template.md](output-template.md) 的**字段规则与并存关系**输出结论。
 - 语言面向产品/研发可读：少堆砌实现细节，**不**用具体文件路径、函数名当「证据」；仓库仅用于理解**能力边界、术语与业务上下文**。
 
@@ -42,29 +43,19 @@ description: 结合本仓库上下文对需求做结构化评审，按 output-te
 1. **锁定正文**：以用户提供的全部需求正文为准；若明显缺段或指代不清，在「问题」中列出待澄清点。
 2. **按需读仓库**：快速扫 `AGENTS.md`、`apps/fe/AGENTS.md`、`servers/be/AGENTS.md` 及 `.apm/product-capability-inventory` 中与需求相关的条目；不展开无关模块代码。
 3. **拆条**：多条诉求时拆成 `### 需求点 1..N`，每条独立走完「业务合理性（可选）→ 问题 或 可行性（+风险）」逻辑。
-4. **成文**：按 `output-template.md` 拼出完整 Markdown 字符串（顶格可加 `### 评审人` + 当前模型名）；该字符串即评审正文，可与是否保存文件、是否在聊天中展示解耦。
+4. **成文**：按 `output-template.md` 拼出完整 Markdown 字符串（顶格可加 `### 评审人` + 当前模型名）；**随即**将全文写入 **`.apm/workitems/<name>/comment-<commentId>.md`**（目录不存在则创建；同一 id 重跑则**覆盖**该文件，仍不删除）。
 5. **自检**：每条是否都有「需求描述」；「问题」与「可行性/风险」是否互斥符合 `output-template.md`；是否误引代码路径作论据。
-6. **提交评审记录**：调用 **CLI 命令**，将第 4 步的**完整评审正文**（与若已保存的 `.md` 内容一致）写入指定评论正文。
+6. **提交评审记录**：调用 **CLI 命令**，读取第 4 步已落盘的 **`.apm/workitems/<name>/comment-<commentId>.md`**，将内容与评论正文同步。
 
-   - **CLI 命令**：使用 `apm comment update` 将评审正文写入指定评论
-   - **短正文**（不易超长）：`apm comment update --id <commentId> --content "<评审正文全文>"`，或多行用 heredoc 避免转义：
+   - **CLI 命令**：`apm comment update --id <commentId> --content-file .apm/workitems/<name>/comment-<commentId>.md`
+   - **禁止**：成功后 `rm` 该文件或使用仅存在于系统临时目录、意图事后删除的副本；评论存档以 workitem 目录下该文件为准。
 
    ```bash
-   apm comment update --id 1 --content "$(cat <<'EOF'
-这里是评审正文（第 4 步成文结果）
-EOF
-)"
+   apm comment update --id 42 --content-file .apm/workitems/my-feature/comment-42.md
    ```
 
-   - **过长正文**：勿强行塞进一条 shell 参数；将第 4 步全文写入**临时文件**（如 `mktemp` 或系统临时目录下的唯一文件名，UTF-8），再：
-
-   ```bash
-   apm comment update --id <commentId> --content-file /path/to/tmp-review.md
-   rm -f /path/to/tmp-review.md
-   ```
-
-   `comment update` **成功后**再执行 `rm`；失败时保留文件便于排查。实际调用时把 `commentId` 换成首轮对话给出的值。失败时把命令的报错信息贴出；成功时可简要确认评论正文已更新。
+   实际调用时替换为你的 `<commentId>`、`<name>`。失败时把命令报错贴出；成功时可简要确认评论已更新且 **`comment-<commentId>.md` 仍保留在仓库中**。
 
 ## 附加资源
 
-- 输出结构与字段规则：[output-template.md](output-template.md)（本技能独立维护，可与飞书 `example.md` 分叉迭代）
+- 输出结构与字段规则：[output-template.md](output-template.md)