ai-project-manage-cli 2.0.26 → 3.0.1

package/dist/core/utils.d.ts

@@ -1,19 +0,0 @@
-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;
-export declare function readPackageJson(): any;
-//# sourceMappingURL=utils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/core/utils.ts"],"names":[],"mappings":"AAGA,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;AAED,wBAAgB,eAAe,QAM9B"}

package/dist/core/utils.js

@@ -1,71 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseNdjsonLine = parseNdjsonLine;
-exports.cleanPrompt = cleanPrompt;
-exports.escapePromptForCliArg = escapePromptForCliArg;
-exports.readPackageJson = readPackageJson;
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
-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;
-}
-function readPackageJson() {
-    const packageJson = (0, node_fs_1.readFileSync)(node_path_1.default.resolve(__dirname, "../../package.json"), "utf-8");
-    return JSON.parse(packageJson);
-}
-//# sourceMappingURL=utils.js.map

package/dist/core/utils.js.map

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

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

@@ -1,29 +0,0 @@
-/**
- * 员工 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;
-};
-type EmployeeWebSocketClientOptions = {
-    debug?: boolean;
-};
-export declare class EmployeeWebSocketClient {
-    client: WebSocket;
-    debug: boolean;
-    constructor(options?: EmployeeWebSocketClientOptions);
-    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;
-}
-export {};
-//# sourceMappingURL=ws-client.d.ts.map

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

@@ -1 +0,0 @@
-{"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,KAAK,8BAA8B,GAAG;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,qBAAa,uBAAuB;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;gBAEH,OAAO,GAAE,8BAAmC;IAWxD,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

@@ -1,81 +0,0 @@
-"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;
-    debug;
-    constructor(options = {}) {
-        this.debug = Boolean(options.debug);
-        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.getApmRuntimeConfig)();
-        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 = "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, debug: this.debug });
-        cmd.execute();
-    };
-}
-exports.EmployeeWebSocketClient = EmployeeWebSocketClient;
-//# sourceMappingURL=ws-client.js.map

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

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

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

@@ -1,42 +0,0 @@
-/**
- * 员工 CLI WebSocket：与后端 `AppWebSocketGateway` 一致，
- * 使用 URL 查询参数 `token`（`Employee.cliToken`），路径 `/ws`；
- * 端口优先 `apm config set ws-port`，否则回退 {@link FALLBACK_EMPLOYEE_WS_PORT}。
- */
-import WebSocket from "ws";
-import { FALLBACK_EMPLOYEE_WS_PORT, resolveEmployeeWsPortFromConfig } from "./config-store";
-export { FALLBACK_EMPLOYEE_WS_PORT, resolveEmployeeWsPortFromConfig };
-/** 与 `EmployeeWebsocketPushService.pushToEmployee` 发送格式一致 */
-export type EmployeeWsServerMessage = {
-    event: string;
-    data: unknown;
-};
-export type BuildEmployeeWebSocketUrlOptions = {
-    /** 显式端口；不传则 {@link resolveEmployeeWsPortFromConfig}（配置 → 回退 4000） */
-    port?: number;
-};
-/**
- * 由 `baseUrl` 解析主机名（与 HTTP 同源），使用独立 WS 端口构造 `ws(s)://host:port/ws?token=...`。
- */
-export declare function buildEmployeeWebSocketUrl(baseUrl: string, token: string, options?: BuildEmployeeWebSocketUrlOptions): string;
-export type CreateEmployeeWebSocketOptions = {
-    baseUrl: string;
-    token: string;
-    wsPort?: number;
-    /** 服务端推送的 JSON：`{ event, data }`；解析失败时 `parsed` 为 `null` */
-    onMessage?: (raw: string, parsed: EmployeeWsServerMessage | null) => void;
-    onOpen?: () => void;
-    onClose?: (code: number, reason: Buffer) => void;
-    onError?: (err: Error) => void;
-};
-/**
- * 使用员工 token 建立 WebSocket，连接成功后可在 `onMessage` 中接收服务端推送。
- */
-export declare function createEmployeeWebSocket(options: CreateEmployeeWebSocketOptions): WebSocket;
-/**
- * 连接并等待服务端消息，直到连接关闭或 `signal` 中止。
- */
-export declare function connectEmployeeWebSocketAndWait(options: CreateEmployeeWebSocketOptions & {
-    signal?: AbortSignal;
-}): Promise<WebSocket>;
-//# sourceMappingURL=employee-ws-client.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"employee-ws-client.d.ts","sourceRoot":"","sources":["../src/employee-ws-client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,SAAS,MAAM,IAAI,CAAC;AAC3B,OAAO,EACL,yBAAyB,EAEzB,+BAA+B,EAChC,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,CAAC;AAEtE,6DAA6D;AAC7D,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gCAAgC,GACzC,MAAM,CAaR;AAED,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,SAAS,CA2BX;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,8BAA8B,GAAG;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CAAC,SAAS,CAAC,CA8BpB"}

package/dist/employee-ws-client.js

@@ -1,99 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveEmployeeWsPortFromConfig = exports.FALLBACK_EMPLOYEE_WS_PORT = void 0;
-exports.buildEmployeeWebSocketUrl = buildEmployeeWebSocketUrl;
-exports.createEmployeeWebSocket = createEmployeeWebSocket;
-exports.connectEmployeeWebSocketAndWait = connectEmployeeWebSocketAndWait;
-/**
- * 员工 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 config_store_1 = require("./config-store");
-Object.defineProperty(exports, "FALLBACK_EMPLOYEE_WS_PORT", { enumerable: true, get: function () { return config_store_1.FALLBACK_EMPLOYEE_WS_PORT; } });
-Object.defineProperty(exports, "resolveEmployeeWsPortFromConfig", { enumerable: true, get: function () { return config_store_1.resolveEmployeeWsPortFromConfig; } });
-/**
- * 由 `baseUrl` 解析主机名（与 HTTP 同源），使用独立 WS 端口构造 `ws(s)://host:port/ws?token=...`。
- */
-function buildEmployeeWebSocketUrl(baseUrl, token, options) {
-    const u = new URL((0, config_store_1.normalizeBaseUrl)(baseUrl));
-    const explicit = options?.port;
-    const port = explicit != null &&
-        Number.isFinite(explicit) &&
-        explicit >= 1 &&
-        explicit <= 65535
-        ? Math.floor(explicit)
-        : (0, config_store_1.resolveEmployeeWsPortFromConfig)();
-    const wsProto = u.protocol === "https:" ? "wss:" : "ws:";
-    const params = new URLSearchParams({ token: token.trim() });
-    return `${wsProto}//${u.hostname}:${port}/ws?${params.toString()}`;
-}
-/**
- * 使用员工 token 建立 WebSocket，连接成功后可在 `onMessage` 中接收服务端推送。
- */
-function createEmployeeWebSocket(options) {
-    const url = buildEmployeeWebSocketUrl(options.baseUrl, options.token, {
-        port: options.wsPort,
-    });
-    const ws = new ws_1.default(url);
-    ws.on("open", () => options.onOpen?.());
-    ws.on("close", (code, reason) => options.onClose?.(code, reason));
-    ws.on("error", (err) => options.onError?.(err));
-    ws.on("message", (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 */
-        }
-        options.onMessage?.(raw, parsed);
-    });
-    return ws;
-}
-/**
- * 连接并等待服务端消息，直到连接关闭或 `signal` 中止。
- */
-function connectEmployeeWebSocketAndWait(options) {
-    return new Promise((resolve, reject) => {
-        const ws = createEmployeeWebSocket({
-            ...options,
-            onOpen: () => {
-                options.onOpen?.();
-                resolve(ws);
-            },
-            onError: (err) => {
-                options.onError?.(err);
-                reject(err);
-            },
-        });
-        const onAbort = () => {
-            try {
-                ws.close();
-            }
-            catch {
-                /* ignore */
-            }
-        };
-        if (options.signal) {
-            if (options.signal.aborted) {
-                onAbort();
-                reject(new Error("aborted"));
-                return;
-            }
-            options.signal.addEventListener("abort", onAbort, { once: true });
-        }
-    });
-}
-//# sourceMappingURL=employee-ws-client.js.map

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

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

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * ai-project-manage 后端 SDK（目录结构对齐 apps/fe/src/api）。
- */
-export * from "./api/index";
-export * from "./employee-ws-client";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;GAEG;AACH,8CAA4B;AAC5B,uDAAqC"}

package/templates/commands/apm-auto-dev.md

@@ -1,6 +0,0 @@
----
-name: "apm-auto-dev"
-description: "基于 apm 命令实现全自动开发，当用户在对话中主动提及使用"
----
-
-你必须严格遵循本指令：使用 **READ** 工具阅读 {project-root}/.apm/skills/apm-auto-dev/SKILL.md，并严格按其说明执行！

package/templates/commands/apm-fixbug.md

@@ -1,6 +0,0 @@
----
-name: "apm-fixbug"
-description: "基于需求 ID 与 bugs 目录执行标准化缺陷修复：分支准备、同步缺陷、按「待处理」修复并部署测试环境；在对话中主动提及时使用"
----
-
-你必须严格遵循本指令：使用 **READ** 工具阅读 {project-root}/.apm/skills/apm-fixbug/SKILL.md，并严格按其说明执行！

package/templates/commands/apm-prd-review.md

@@ -1,6 +0,0 @@
----
-name: "apm-prd-review"
-description: "结合仓库上下文对需求做结构化评审，依赖需求 ID；评审正文落盘并提交 comment；在对话中主动提及时使用"
----
-
-你必须严格遵循本指令：使用 **READ** 工具阅读 {project-root}/.apm/skills/prd-review/SKILL.md，并严格按其说明执行！

package/templates/commands/apm-prd-sync.md

@@ -1,6 +0,0 @@
----
-name: "apm-prd-sync"
-description: "根据评论与用户回复合并修订 PRD，覆盖本地 prd.md 并通过 apm 同步服务端；依赖需求 ID；在对话中主动提及时使用"
----
-
-你必须严格遵循本指令：使用 **READ** 工具阅读 {project-root}/.apm/skills/prd-sync/SKILL.md，并严格按其说明执行！

package/templates/skills/apm-apply-change/SKILL.md

@@ -1,191 +0,0 @@
----
-name: apm-apply-change
-description: 在 .apm/workitems/<requirementId>/ 按 tasks.md 逐项实现、勾选；一项任务一个 commit。遇事实性阻塞（如规划与代码严重不符）须停止执行，仅陈述事实与需用户提供的材料，不替用户决策或列方案。/opsx:apply 同此技能。
----
-
-# APM 工作项：按任务实现
-
-根据工作项目录下的 **`tasks.md`** 驱动实现：**读规划 → 做代码 → 对账元数据 → 勾选 → 单独 commit**，直至全部完成或遇硬阻塞；上下文以 **`.apm/workitems/<requirementId>/`** 内文件为准。
-
----
-
-## 输入
-
-| 字段 | 规则 |
-| --- | --- |
-| **`requirementId`** | **推荐显式提供**（与 `.apm/workitems/<requirementId>/` 目录名一致）。 |
-
-若本轮未提供 `requirementId`：
-
-1. 若对话中已能**唯一**确定工作项目录名，则用之。
-2. 否则查看 **`.apm/workitems/`** 下子目录：若**仅有一个**，自动采用；若**多个**，**按目录名字典序取第一个**作为本次工作项，并在回复中列出当时可见的候选名，声明 **使用工作项：`<requirementId>`** 及如何覆盖（例如下次显式给出 id）。**不要**调用 AskUserQuestion，**不要**停下来让用户当场选择。
-
-**不要**为澄清需求而反问用户。若执行中发现**无法在无决策前提下继续**的事实性问题（见上文 **「停止执行」**），**不要**用推断顶过去。
-
----
-
-## 停止执行（优先于继续推进）
-
-若在实施过程中**发现**任一情况，**立即停止**本技能所驱动的后续实现与勾选（不再继续下一项任务），仅在会话中输出：
-
-1. **客观事实**：已读到的文件/路径、与代码或任务条目的**具体矛盾点**（可摘引，避免主观评价）。
-2. **当前进度**：处理到 `tasks.md` 的哪一条、仓库是否已有未提交改动（若有，说明范围）。
-3. **需要用户提供什么**：为继续推进所**缺的信息或决策**（例如：以何者为准、是否接受某类改动、需确认的业务口径）。用**清单**列出，**一句一项**。
-
-**禁止**：给出「建议你先改 A / 再改 B」「可选方案 1/2/3」「宜采用…」等**替用户决策**或**行动建议**；不指导用户如何改文档、不预设优先级。
-
-**允许**：描述「若不补充某信息则无法继续」的**逻辑关系**（仍不展开成方案）。
-
----
-
-## 工作项路径与必备文件
-
-- **根路径**：**`.apm/workitems/<requirementId>/`**
-- **必备**：**`tasks.md`**（含 `- [ ]` / `- [x]` 待办）。若不存在或无可执行条目：**阻塞**，说明须先完成 **apm-propose**（或手工补齐 `tasks.md`）。
-- **强烈建议读**：**`prd.md`**（范围与验收）；实现时按需 **Read** **`proposal.md`**、**`design.md`**、**`specs/`**（与 **`tasks-instruction.md`** 中每条任务的元数据一致）。
-- **进度**：仅由 **`tasks.md`** 中复选框统计「已完成 / 总数」。
-
-### 单会话读取（可选减负）
-
-同一轮连续执行多项任务时：**`prd.md` / `design.md` / 各 spec** 若已在会话内读过且无疑虑，不必每个任务重复全文 Read；以**当前任务行**及元数据指向的 spec/设计段落为准，必要时对文件 **Read（偏移）** 或再读全文。
-
----
-
-## Steps
-
-### 1. 锚定工作项
-
-确定 **`requirementId`** 与工作项根路径；声明 **使用工作项：`<requirementId>`**（若依上节规则自动选定，须说明如何覆盖）。
-
-### 2. 读取 `tasks.md` 并判断状态
-
-- **Read** **`.apm/workitems/<requirementId>/tasks.md`**。
-- 若文件缺失、为空、或无任何 `- [ ]`：**停止**，提示先具备可执行 `tasks`（规划阶段）。
-- 若全部已为 `- [x]`：**可**直接汇报「已全部完成」（仅作事实陈述，不建议是否提交或发 MR）。
-
-### 3. 读取实现上下文（按任务需要）
-
-开始**第一个**未勾选任务前，至少 **Read**：
-
-- **`prd.md`**（若存在；与验收相关条款）
-- 与任务相关的 **`design.md`** 片段、**`specs/`** 下对应文件（见任务条目的 **需求编号** / 描述）
-
-不要求每次任务都重读全部规划文件；以 **`tasks.md` 当前项** + **缺口再 Read** 为准。
-
-### 4. 展示当前进度
-
-在对话中简要展示：
-
-- **工作项**：`requirementId`
-- **进度**：「N/M 个任务已完成」（由 `tasks.md` 勾选统计）
-- **当前将处理**：下一条 `- [ ]` 的摘要（含组号/编号如 `2.1`）
-
-### 5. 实现任务（循环直至完成或阻塞）
-
-对每一条 **未勾选** 任务（建议按 `tasks.md` 自上而下顺序）：
-
-1. **说明**正在处理哪一项（编号 + 简述）。
-2. **实现**所需代码/配置/迁移等；改动保持**最小**、与该项描述一致。
-3. **标记完成前**在回复或备注中收集依据（与 **`tasks-instruction.md`** 子列表字段对齐即可）：
-   - **需求编号**：本实现对应 specs / tasks 中的哪条需求或场景。
-   - **预期改动路径** 与 **实际改动文件**：若有合理偏差，简要说明原因。
-   - **验证用例编号**（若任务中有）。
-   - **验证结果** / **完成标准**：如何确认本项已达成（可简短）。
-4. 仅在依据已齐、且自洽通过后，将 **`tasks.md`** 中对应行 **`- [ ]` 改为 `- [x]`**。
-5. **Git**：本待办对应的**实现 + 勾选**等改动，**单独 `git commit` 一次**（**一项待办 = 一个 commit**；勿把多项待办混在同一 commit）。提交信息建议包含 `requirementId` 与任务编号或简述。
-
-**何时停止（不继续下一项）**——与上文 **「停止执行」** 一致：
-
-- **`design` / `specs` / `tasks` 与当前代码或彼此严重不一致**，以致无法按任务字面含义在**不臆造**的前提下完成 → **按「停止执行」输出**（事实 + 需用户提供的材料），**不**建议先改哪份文档、不改哪些。
-- 命令失败、环境错误、权限等**硬阻塞** → 说明原因、失败点、已执行步骤；**不**给排障步骤或替代命令建议（除非任务本身要求执行某命令且该命令已写在任务/文档中）。
-- 用户中断。
-
-**何时仍可继续**（仅当满足）：任务表述略含糊，但可在 **prd / design / specs / tasks** 已有文字内**自洽**完成；若有**假设**，在回复中写清**假设**（仍不反问）。一旦假设会触及「以谁为准」的**产品/架构决策**，转 **「停止执行」**。
-
-### 6. 完成或暂停时展示状态
-
-- **本会话**完成了哪些任务（可列勾选项摘要）。
-- **总体进度**：「N/M 个任务已完成」。
-- 若**全部完成**：仅陈述事实（进度与勾选状态），**不**建议后续流程（MR/发布/归档等）。
-- 若**暂停**：按 **「停止执行」** 或硬阻塞格式输出，**无**「可选后续」或方案建议。
-
----
-
-## 实现过程中的输出（示例）
-
-```
-## 正在实施：<requirementId>
-
-处理任务 3/7：2.1 实现导出接口
-[...实现过程...]
-✓ 任务完成 · commit <short-sha> <subject>
-
-处理任务 4/7：2.2 …
-```
-
----
-
-## 全部完成时的输出（示例）
-
-```
-## 实现完成
-
-**工作项：** <requirementId>
-**进度：** 7/7 个任务已完成 ✓
-
-### 本会话已完成
-- [x] …
-- [x] …
-
-（每项待办均已对应独立 commit。）
-```
-
----
-
-## 暂停时的输出（示例）
-
-```
-## 实现已暂停
-
-**工作项：** <requirementId>
-**进度：** 4/7 个任务已完成
-
-### 事实与原因
-<客观描述：文件/行/与任务或代码的矛盾点>
-
-### 需要用户提供（或决策）
-- …
-- …
-```
-
-（无方案列表、无「建议」；用户补充信息后可再次运行本技能。）
-
----
-
-## 约束
-
-- 持续执行待办直至完成、**停止执行**或硬阻塞。
-- 开始前须已能对照 **`tasks.md`** 与 **`prd.md`**（及任务所需的 design/spec）；**不要**在未读清当前任务依赖时盲改。
-- 任务表述有歧义时，仅在**无需用户决策**的前提下依据 **specs / design / prd** 推断；一旦涉及**以谁为准**或**严重不一致**，**停止执行**（见上文）。
-- **不**因「发现规划与代码不符」而**主动建议**修改 `design.md` / `specs/` / `tasks.md`；**停止**并说明事实与需用户提供的材料即可。
-- 代码改动保持最小、与**当前任务**范围一致。
-- 未完成需求/验证对账前，**不要**将任务勾为完成。
-- 验证失败或依据不足时，保持 **`- [ ]`**，并明确写出缺口。
-- 若任务元数据缺失（需求编号、预期改动路径、完成标准等），在可能范围内于实现前**补全或按 tasks 模板推断**，并在说明中注明。
-- 每完成一项任务并记录依据后，**立即**更新勾选并**随即**单独 `git commit`。
-- 遇硬阻塞时暂停并说明原因（**不**给出替代命令或排查建议，除非任务/文档已写明）；
-- 需求不清且无法自洽推断时，**停止执行**并列出需用户提供的材料；**不反问用户**。
-
----
-
-## 与规划流程的衔接
-
-- **`tasks.md`** 须由 **apm-propose**（或等价流程）生成并符合 **`tasks-instruction.md`** 格式（`- [ ]`、元数据子列表等），否则本技能无法可靠追踪。
-- 若执行中发现 **`design` / `specs` 与代码严重不一致**：**停止执行**，按上文输出事实与**需用户提供**的决策/信息；**不**建议先改哪类工件、不代用户排优先级。
-
----
-
-## 流动工作流
-
-- **可分段调用**：可在部分任务完成后结束会话，下次同一工作项继续。
-- **规划修订**：由用户在**流程外**修订 `design.md` / `specs/` / `tasks.md` 后，再触发本技能；本技能执行中**不因发现不符**而主动改规划文件或提出修改方案。