listpage_cli 0.0.311 → 0.0.313

package/bin/adapters/cli-interaction.js

@@ -156,9 +156,12 @@ function printHelp() {
         `    用法: ${helpColor("listpage_cli init", "dim")}`,
         "    说明: 进入中文引导式交互，按提示填写即可",
         "",
-        `  ${helpColor("install-skill", "green")}`,
-        `    用法: ${helpColor("listpage_cli install-skill [skillName] [--project]", "dim")}`,
-        "    说明: 安装技能到 Cursor；默认 skillName 为 test，安装到当前命令执行目录的 .cursor/skills/",
+        `  ${helpColor("skill", "green")}`,
+        `    用法: ${helpColor("listpage_cli skill list", "dim")}`,
+        "    说明: 列出 CLI 包内可安装的技能名称（模板目录下的子文件夹）",
+        "",
+        `    用法: ${helpColor("listpage_cli skill add [技能名称]", "dim")}`,
+        "    说明: 安装技能到 Cursor；省略技能名时默认为 test，安装到当前命令执行目录的 .cursor/skills/",
         "",
         `  ${helpColor("project", "green")}`,
         `    用法: ${helpColor("listpage_cli project build", "dim")}`,

package/bin/adapters/node-fs-adapter.js

@@ -88,6 +88,14 @@ function createNodeFsAdapter() {
                 throw toFsPortError("writeBuffer", targetPath, error);
             }
         },
+        removeDirRecursive: (targetPath) => {
+            try {
+                (0, fs_1.rmSync)(targetPath, { recursive: true, force: true });
+            }
+            catch (error) {
+                throw toFsPortError("removeDirRecursive", targetPath, error);
+            }
+        },
     };
 }
 function toFsPortError(operation, targetPath, error) {

package/bin/app/parse-args.js

@@ -7,7 +7,7 @@ exports.parseCommandOptions = parseCommandOptions;
 exports.parseCommandPositionals = parseCommandPositionals;
 const KNOWN_COMMANDS = new Set([
     "init",
-    "install-skill",
+    "skill",
     "project",
     "lark",
 ]);

package/bin/cli.js

@@ -5,7 +5,7 @@ const cli_interaction_1 = require("./adapters/cli-interaction");
 const execute_1 = require("./app/execute");
 const command_result_1 = require("./domain/command-result");
 const init_command_1 = require("./commands/init-command");
-const install_skill_command_1 = require("./commands/install-skill-command");
+const skill_command_1 = require("./commands/skill-command");
 const project_command_1 = require("./commands/project-command");
 const lark_command_1 = require("./commands/lark-command");
 const node_fs_adapter_1 = require("./adapters/node-fs-adapter");
@@ -23,7 +23,7 @@ const initCommandHandler = (0, init_command_1.createInitCommandHandler)({
     fs: fsAdapter,
     files: filesystemCapability,
 });
-const installSkillCommandHandler = (0, install_skill_command_1.createInstallSkillCommandHandler)({
+const skillCommandHandler = (0, skill_command_1.createSkillCommandHandler)({
     fs: fsAdapter,
     files: filesystemCapability,
     config: {
@@ -45,7 +45,7 @@ async function main() {
         printVersion: cli_interaction_1.printVersion,
         handlers: {
             init: initCommandHandler,
-            "install-skill": installSkillCommandHandler,
+            skill: skillCommandHandler,
             project: projectCommandHandler,
             lark: larkCommandHandler,
         },

package/bin/commands/lark/read-command.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handleReadCommand = handleReadCommand;
+const node_fs_1 = require("node:fs");
 const command_result_1 = require("../../domain/command-result");
 const parse_doc_1 = require("./parse-doc");
 async function handleReadCommand(input, client, fs) {
@@ -23,9 +24,16 @@ async function handleReadCommand(input, client, fs) {
     const relativePath = `.listpage/lark/${docToken}/prd.md`;
     const absolutePath = fs.resolve(fs.cwd(), relativePath);
     const outputDir = fs.dirname(absolutePath);
-    if (!fs.exists(outputDir)) {
+    try {
+        if ((0, node_fs_1.existsSync)(outputDir)) {
+            (0, node_fs_1.rmSync)(outputDir, { recursive: true, force: true });
+        }
         fs.ensureDir(outputDir);
     }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`清理旧文档产物失败: ${message}`, "cleanup_lark_doc_dir_failed", 1);
+    }
     const docContent = await (0, parse_doc_1.parseBlocksToMarkdown)(blocks, {
         fs,
         outputDir,

package/bin/commands/{build-project-command.js → project/build-project-command.js}

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createBuildProjectCommandHandler = createBuildProjectCommandHandler;
-const build_project_service_1 = require("../services/build-project-service");
+const build_project_service_1 = require("../../services/build-project-service");
 function createBuildProjectCommandHandler(deps) {
     return async (_input) => {
         return (0, build_project_service_1.runBuildProjectFlow)(deps);

package/bin/commands/{deploy-project-command.js → project/deploy-project-command.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDeployProjectCommandHandler = createDeployProjectCommandHandler;
-const parse_args_1 = require("../app/parse-args");
-const deploy_project_service_1 = require("../services/deploy-project-service");
+const parse_args_1 = require("../../app/parse-args");
+const deploy_project_service_1 = require("../../services/deploy-project-service");
 function createDeployProjectCommandHandler(deps) {
     return async (input) => {
         const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];

package/bin/commands/{release-project-command.js → project/release-project-command.js}

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createReleaseProjectCommandHandler = createReleaseProjectCommandHandler;
-const parse_args_1 = require("../app/parse-args");
-const release_project_service_1 = require("../services/release-project-service");
+const parse_args_1 = require("../../app/parse-args");
+const release_project_service_1 = require("../../services/release-project-service");
 function createReleaseProjectCommandHandler(deps) {
     return async (input) => {
         const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];

package/bin/commands/project-command.js

@@ -2,9 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createProjectCommandHandler = createProjectCommandHandler;
 const command_result_1 = require("../domain/command-result");
-const build_project_command_1 = require("./build-project-command");
-const release_project_command_1 = require("./release-project-command");
-const deploy_project_command_1 = require("./deploy-project-command");
+const build_project_command_1 = require("./project/build-project-command");
+const release_project_command_1 = require("./project/release-project-command");
+const deploy_project_command_1 = require("./project/deploy-project-command");
 function createProjectCommandHandler(deps) {
     const build = (0, build_project_command_1.createBuildProjectCommandHandler)(deps.build);
     const release = (0, release_project_command_1.createReleaseProjectCommandHandler)(deps.release);

package/bin/commands/skill/add-command.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillAddCommandHandler = createSkillAddCommandHandler;
+const skill_add_service_1 = require("../../services/skill-add-service");
+function createSkillAddCommandHandler(deps) {
+    return async (input) => {
+        return (0, skill_add_service_1.runSkillAddFlow)(input, deps);
+    };
+}

package/bin/commands/skill/list-command.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillListCommandHandler = createSkillListCommandHandler;
+const skill_list_service_1 = require("../../services/skill-list-service");
+function createSkillListCommandHandler(deps) {
+    return async (_input) => {
+        return (0, skill_list_service_1.runSkillListFlow)(deps);
+    };
+}

package/bin/commands/skill-command.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillCommandHandler = createSkillCommandHandler;
+const command_result_1 = require("../domain/command-result");
+const add_command_1 = require("./skill/add-command");
+const list_command_1 = require("./skill/list-command");
+function createSkillCommandHandler(deps) {
+    const add = (0, add_command_1.createSkillAddCommandHandler)(deps);
+    const list = (0, list_command_1.createSkillListCommandHandler)(deps);
+    return async (input) => {
+        const sub = input.positionals[0];
+        switch (sub) {
+            case "add":
+                return add(input);
+            case "list":
+                return list(input);
+            default:
+                return (0, command_result_1.commandError)("用法: listpage_cli skill add [技能名称]\n       listpage_cli skill list", command_result_1.COMMAND_ERROR_CODES.unknownCommand, 1);
+        }
+    };
+}

package/bin/services/build-project-service.js

@@ -31,6 +31,13 @@ async function runBuildProjectFlow(deps) {
         const message = error instanceof Error ? error.message : String(error);
         return (0, command_result_1.commandError)(message, command_result_1.COMMAND_ERROR_CODES.invalidPath, 1);
     }
+    try {
+        removeOutputDirBeforeBuild(projectRoot);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`[${command_runner_1.COMMAND_RUNNER_STAGE}] 清理输出目录失败: ${message}`, command_result_1.COMMAND_ERROR_CODES.executionFailed, 1);
+    }
     if (deps.executeBuild) {
         try {
             const result = await deps.executeBuild({
@@ -138,6 +145,13 @@ function resolveBuildTarget(projectRoot, projectDir) {
         ? projectDir
         : node_path_1.default.resolve(projectRoot, projectDir);
 }
+/** 构建前删除 `.listpage/output`，避免遗留旧产物。 */
+function removeOutputDirBeforeBuild(projectRoot) {
+    const outputRoot = node_path_1.default.resolve(projectRoot, ".listpage", "output");
+    if ((0, node_fs_1.existsSync)(outputRoot)) {
+        (0, node_fs_1.rmSync)(outputRoot, { recursive: true, force: true });
+    }
+}
 function toCopySpecs(value) {
     if (!Array.isArray(value)) {
         return [];

package/bin/services/{install-skill-service.js → skill-add-service.js}

@@ -1,18 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.runInstallSkillFlow = runInstallSkillFlow;
+exports.runSkillAddFlow = runSkillAddFlow;
 const command_result_1 = require("../domain/command-result");
-function runInstallSkillFlow(input, deps) {
-    const skillName = input.positionals[0] || deps.config.defaultSkillName;
+function runSkillAddFlow(input, deps) {
+    const skillName = input.positionals[1] ?? deps.config.defaultSkillName;
     const sourceDir = deps.fs.join(deps.config.getSkillTemplateRoot(), skillName);
     if (!deps.fs.exists(sourceDir)) {
         return (0, command_result_1.commandError)(`技能 ${skillName} 不存在: ${sourceDir}`, command_result_1.COMMAND_ERROR_CODES.skillNotFound, 1);
     }
-    const targetDirResult = resolveTargetDir(input, skillName, deps.fs);
+    const targetDirResult = resolveTargetDir(skillName, deps.fs);
     if (targetDirResult.kind === "error") {
         return targetDirResult.result;
     }
     try {
+        if (deps.fs.exists(targetDirResult.targetDir)) {
+            deps.fs.removeDirRecursive(targetDirResult.targetDir);
+        }
         deps.files.copySkillDir(sourceDir, targetDirResult.targetDir);
         return (0, command_result_1.commandOk)(`已安装 ${skillName} 技能到 ${targetDirResult.targetDir}`);
     }
@@ -21,7 +24,7 @@ function runInstallSkillFlow(input, deps) {
         return (0, command_result_1.commandError)(`安装技能失败(${skillName} -> ${targetDirResult.targetDir}): ${message}`, command_result_1.COMMAND_ERROR_CODES.fsOperationFailed, 1);
     }
 }
-function resolveTargetDir(input, skillName, fs) {
+function resolveTargetDir(skillName, fs) {
     const baseDir = fs.cwd();
     if (!baseDir || !baseDir.trim()) {
         return {

package/bin/services/skill-list-service.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSkillListFlow = runSkillListFlow;
+const command_result_1 = require("../domain/command-result");
+function runSkillListFlow(deps) {
+    const root = deps.config.getSkillTemplateRoot();
+    if (!deps.fs.exists(root)) {
+        return (0, command_result_1.commandError)(`技能模板目录不存在: ${root}`, command_result_1.COMMAND_ERROR_CODES.invalidPath, 1);
+    }
+    try {
+        const names = deps.fs
+            .readDir(root)
+            .filter((name) => {
+            const entry = deps.fs.join(root, name);
+            return deps.fs.exists(entry) && deps.fs.isDirectory(entry);
+        })
+            .sort((a, b) => a.localeCompare(b));
+        if (names.length === 0) {
+            return (0, command_result_1.commandOk)("(暂无可用技能)");
+        }
+        return (0, command_result_1.commandOk)(names.join("\n"));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return (0, command_result_1.commandError)(`列出技能失败: ${message}`, command_result_1.COMMAND_ERROR_CODES.fsOperationFailed, 1);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "listpage_cli",
-  "version": "0.0.311",
+  "version": "0.0.313",
   "private": false,
   "bin": {
     "listpage_cli": "bin/cli.js"

package/templates/backend-template/package.json.tmpl

@@ -25,7 +25,7 @@
     "class-transformer": "^0.5.1",
     "class-validator": "~0.14.2",
     "rxjs": "^7.8.1",
-    "listpage-next-nest": "~0.0.311"
+    "listpage-next-nest": "~0.0.313"
   },
   "devDependencies": {
     "@nestjs/schematics": "^11.0.0",

package/templates/backend-template/tsconfig.build.json

@@ -9,6 +9,7 @@
     "test",
     "**/*spec.ts",
     "prisma",
+    "dist",
     "prisma.config.ts"
   ]
 }

package/templates/backend-template/tsconfig.json

@@ -4,7 +4,7 @@
     "moduleResolution": "nodenext",
     "resolvePackageJsonExports": true,
     "esModuleInterop": true,
-    "isolatedModules": true,
+    "isolatedModules": false,
     "declaration": true,
     "removeComments": true,
     "emitDecoratorMetadata": true,
@@ -20,6 +20,9 @@
     "forceConsistentCasingInFileNames": true,
     "noImplicitAny": false,
     "strictBindCallApply": false,
-    "noFallthroughCasesInSwitch": false
+    "noFallthroughCasesInSwitch": false,
+    "paths": {
+      "exclude": ["node_modules", "dist"]
+    }
   }
 }

package/templates/frontend-template/package.json.tmpl

@@ -10,22 +10,18 @@
     "preview": "rsbuild preview"
   },
   "dependencies": {
-    "react": "^19.2.0",
-    "react-dom": "^19.2.0",
-    "listpage-next": "~0.0.311",
-    "react-router-dom": ">=6.0.0",
-    "@ant-design/v5-patch-for-react-19": "~1.0.3",
+    "listpage-http": "0.0.313",
+    "listpage-components": "0.0.313",
+    "antd": "6.3.1",
     "ahooks": "^3.9.5",
-    "antd": "^5.27.3",
-    "axios": "^1.12.2",
+    "@ant-design/icons": "~6.0.2",
     "dayjs": "^1.11.18",
     "lodash": "^4.17.21",
-    "styled-components": "^6.1.19",
-    "mobx": "~6.15.0",
-    "@ant-design/icons": "~6.0.2",
-    "listpage-components": "~0.0.311",
-    "lucide-react": "~0.575.0"
-    "mobx-react-lite": "~4.1.1"
+    "lucide-react": "~0.575.0",
+    "recharts": "^3.7.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router-dom": ">=6.0.0"
   },
   "devDependencies": {
     "@rsbuild/core": "^1.6.0",

package/templates/frontend-template/src/api/index.ts

@@ -1,5 +1,33 @@
-import user from './user';
+import { createApiClient } from 'listpage-http';
+import { requestConfig, type RequestConfig } from './request-config';
+import { TOKEN_STORAGE_KEY } from '@/constants/auth';
+import { notification } from 'antd';
 
-export default {
-  user,
-};
+const isDev = process.env.NODE_ENV === 'development';
+
+const api = createApiClient<RequestConfig>(requestConfig, {
+  baseURL: '/api/v1',
+  tokenKey: TOKEN_STORAGE_KEY,
+  defaultTimeout: 10_000,
+  successCodes: [20000, 200, 201],
+  unauthorizedCodes: [401],
+  unauthorizedRedirectPath: '/login',
+  server: {
+    protocol: undefined,
+    host: isDev ? 'localhost' : undefined,
+    port: isDev ? 3000 : undefined,
+    publicPath: '/api/v1',
+  },
+  onError: (code, msg) => {
+    // 统一错误处理
+    console.error('[API Error]', code, msg);
+    notification.open({
+      title: String(code),
+      description: msg || `请求失败 (${code})`,
+      placement: 'topRight',
+      type: 'error',
+    });
+  },
+});
+
+export default api;

package/templates/frontend-template/src/api/request-config.ts

@@ -0,0 +1,13 @@
+import { defineEndpoint } from 'listpage-http';
+import type { ReqLogin, ResLogin } from './user';
+
+export const requestConfig = {
+  user: {
+    login: defineEndpoint<ReqLogin, ResLogin>({
+      method: 'POST',
+      path: '/auth/login',
+    }),
+  },
+} as const;
+
+export type RequestConfig = typeof requestConfig;

package/templates/frontend-template/src/api/user.ts

@@ -1,19 +1,8 @@
-import apiClient from './config';
-
-type ReqLogin = {
+export type ReqLogin = {
   email: string;
   password: string;
 };
 
-type ResLogin = {
+export type ResLogin = {
   token: string;
 };
-
-const login = async (values: ReqLogin) => {
-  const response = await apiClient.post<ResLogin>('/auth/login', values);
-  return response.data.data!;
-};
-
-export default {
-  login,
-};

package/templates/rush-template/.gitignore.tmpl

@@ -119,4 +119,6 @@ dist-storybook/
 
 # Heft temporary files
 .cache/
-.heft/
+.heft/
+
+.listpage

package/templates/rush-template/listpage.config.json.tmpl

@@ -85,5 +85,9 @@
 			},
 			"volumes": []
 		}
+	},
+	"lark": {
+		"APP_ID": "",
+		"APP_SECRET": ""
 	}
 }

package/templates/skills-template/feishu-prd-reviewer/SKILL.md

@@ -0,0 +1,124 @@
+---
+name: feishu-prd-reviewer
+description: 评审飞书 PRD（支持评审后结合待办反向澄清需求）
+---
+
+# Feishu PRD Reviewer（产品视角）
+
+## 触发条件
+
+- 用户要求处理该飞书 PRD（评审或补齐待办），并明确提供文档地址（URL）或 `doc_token`
+- 通过 `npx listpage_cli lark read <doc_token>` 能成功读取到文档内容
+
+## 输入
+
+- 飞书 PRD URL（用于解析 `doc_token`）
+- 或用户直接提供 `doc_token`
+
+## 输出
+
+- PRD 含待办：结合“AI 评审章节 + 待办问题”逐条处理待办，更新需求清单描述并回写对应区块、将待办标记为 done；随后结束
+- PRD 不含待办：生成产品经理易读的评审结论并回写区块；随后结束
+
+## 核心原则
+
+- **互斥执行**：一次仅执行一个模式。
+  - 有待办：只做“待办处理”，不做任何新的需求评审与结论生成（但可读取既有 AI 评审章节作为待办处理输入）。
+  - 无待办：只做“需求评审”，不进行待办处理流程（不创建 requirements.md）。
+- **待办口径**：以“未完成待办”为准；若文档中的待办区块全部为 done（或没有待办条目），视为“无待办”。
+- 产品视角优先：以“用户侧影响、业务闭环、风险与待确认点”为主，避免晦涩技术术语堆砌
+- 与代码对齐：结合仓库现有实现推断隐含约束与异常场景，补齐开发需要的澄清点
+- 约束强执行：待办处理阶段严格遵循标题层级与提示语移除规则（见“待办处理约束”）
+
+## 执行流程
+
+1. 获取 `doc_token`：从 URL 提取，或直接使用用户提供的 token
+2. 读取需求文档：在项目根目录执行
+   - `npx listpage_cli lark read <doc_token>`
+   - 该命令会把内容写入 `.listpage/lark/<doc_token>/prd.md`，并输出文件路径
+3. 判断待办是否存在
+   - 无待办：指“未完成待办”数量为 0（包括：文档没有待办、或所有待办均已标记 done）-> 进入步骤 6（代码评审 + 结论生成）
+   - 有待办：存在未完成待办 -> 进入步骤 4（待办逐条处理）
+4. 待办逐条处理（有待办时不进入新的代码评审与结论生成）
+   - 创建新文档
+     - 文件路径示例：`.listpage/lark/<doc_token>/requirements.md`
+     - 标题约束：严禁使用 H1/H2，所有标题必须从 H3 开始
+     - 内容约束：移除提示语“下面部分由产品经理编写，内容为准备评审的需求点”
+   - 内容来源：以原文档中“需求清单”作为基底，并结合“AI 评审章节（如 robot_face 回写的评审结论）”与待办问题进行澄清改写；去掉“需求清单”标题与相关提示语
+   - 循环处理每条待办
+     1. 读取待办事项内容
+   2. 同步读取对应需求点的 AI 评审内容（需求描述/问题/可行性/风险点）
+   3. 以“待办问题 + AI 评审结论”共同作为输入，改写 `requirements.md` 中对应需求点，让需求描述更清晰、可执行
+   4. 如 AI 评审与待办口径冲突，以“待办明确的新口径”优先，并在需求描述中消除歧义
+   5. 回写时只更新需求清单内容，不改变既定回写命令和回写目标区块
+   6. 直到所有待办处理完成
+   - 回写飞书文档（待办全部完成后）
+     - 执行：`npx listpage_cli lark update-block <doc_token> woman "<markdown_file_path>"`
+   - 更新待办状态
+     - 执行：`npx listpage_cli lark check-todo <doc_token> <index>`
+     - 将待办标记为完成（done）
+5. 流程结束：待办处理完成后停止，不再执行后续步骤
+6. 代码评审与结论生成（无待办时执行）
+
+- 目标：先把“需求点列表”固定到 `review.md`，再对每条需求点按序逐条评审并回写，避免一次性把所有需求点塞进上下文导致爆炸
+- 阶段 A：需求点提炼并写入 `review.md`（仅拆条，不写评审）
+  - 从步骤 2 读取到的 PRD 内容中，提取“需求清单”区段的全部需求点（包含图片/补充信息的隐含诉求）
+  - 将需求拆成 N 条“可执行条目”，为每条生成稳定编号（例如 `i=1..N`）
+  - 在本地创建/覆盖 Markdown：`.listpage/lark/<doc_token>/review.md`
+  - 在 `review.md` 顶部添加一个“执行待办清单”（仅用于阶段 B 驱动逐条处理）
+    - 格式示例（必须是 Markdown checklist）：`- [ ] 需求点 1`
+    - 对每条生成一行：`- [ ] 需求点 i`
+    - 阶段 A 不把任何条目标为已完成
+  - 每条使用固定区块边界，格式示例：`### 需求点 i`（注意：仅要求禁止 H1/H2，H3 允许）
+  - 仅在每个 `### 需求点 i` 区块内写“需求描述”，并严格复用 `example.md` 的字段与缩进/子 bullet 结构（产品视角）
+  - 阶段 A 不写“问题/可行性/风险点”，只负责把每个需求点的“需求描述”结构固定下来，避免一次性输出过多评审内容导致上下文爆炸
+  - 格式约束：严禁使用 H1/H2 标题或表格；允许使用列表与加粗字段
+- 阶段 B：逐条评审并回写 `review.md`（按序、只处理一条）
+  - 对 i = 1..N 循环执行，直到全部条目完成
+    1. 只读取 `review.md` 中两处内容：
+       - 执行待办清单里第 i 行（`- [ ] 需求点 i` 或 `- [x] 需求点 i`）
+       - `### 需求点 i` 对应的区块（不要把其它条目的内容也纳入本轮处理）
+    2. 只基于 PRD 需求本身进行判断，不做“结合代码去猜口径/猜实现”的推断；并且收紧“问题”触发条件：
+       - 只有当 PRD 信息不足以形成“开发可执行的需求描述”（关键落点/口径/范围/汇总规则无法确定）时，才输出 `**问题：**`（不写 `可行性/风险点`）
+       - 如果基于该需求点本身已足够做出“可以实现”的判断（即使仍存在非关键细节，也不阻塞落地），则不要问问题：直接输出 `**可行性：**`（成本等级 + 精简的必要说明）
+    3. 将输出严格复用 `example.md` 的区块结构，并回写到对应 `### 需求点 i` 区块，保持其它区块不变：
+       - 不新增其它字段/标题/正文块
+       - 仅按需要填写 `需求描述` / `问题` / `可行性` / `风险点`（这些字段与缩进/子 bullet 结构必须与 `example.md` 一致）
+       - 不允许出现代码/组件/函数/文件名；不要根据代码猜口径（需求不清晰就只提问题）
+    4. 把执行待办清单里第 i 行从 `- [ ] 需求点 i` 更新为 `- [x] 需求点 i`（作为“本条已完成”的唯一状态）
+- 阶段 C：最终回写飞书
+  - 等循环全部完成后，在本地生成“回写版”文件：`review_writeback.md`
+    - `review_writeback.md` 最顶部新增 `### 评审人` 标题，并下一行写 `<当前模型名称>`（格式与 `example.md` 一致）
+    - 该文件同时保留 `### 评审人` 区块与所有 `### 需求点 i` 区块
+    - 必须删除顶部的“执行待办清单”（`- [ ]/- [x] 需求点 i` 那一段及其所在行），确保飞书里不出现 checklist 待办格式
+  - 执行飞书回写时，仅使用 `review_writeback.md`：
+    - `npx listpage_cli lark update-block <doc_token> robot_face "review_writeback.md"`
+
+## 评审方法（无待办时）
+
+（无待办时执行第 6 步的“阶段 A/B/C”，本节仅保留总体输出原则）
+
+- 需求点提炼：从“需求清单”区段理解全部需要落地的需求点（包括图片描述与补充信息中的隐含诉求），并拆成可逐条评审的 N 条条目
+- 输出模板：每个 `### 需求点 i` 区块的呈现结构必须严格复用 `example.md`
+  - `- **需求描述：**:` 必须出现
+  - 仅当信息缺口会阻塞落地：才出现 `- **问题：**:`（此时不出现 `**可行性：**` 与 `**风险点：**`）
+  - 其余情况（能实现/不阻塞落地）：出现 `- **可行性：**:`（可追加 `- **风险点：**:`，仅影响范围大时）
+- 澄清优先（但不泛问）：不阻塞落地时不提问；不做口径猜测
+- 禁止代码猜测：不引用仓库代码/组件/函数/文件名；也不要根据代码推断不清晰的口径（应改为提问）
+
+## 写回文档（无待办时）
+
+- 本地写回：通过第 6 步阶段 C 生成 `review_writeback.md`
+- 格式要求：严禁使用（H1-H2）标题或表格；只保留 `### 评审人` 与所有 `### 需求点 i` 区块
+- 同步飞书：执行 `npx listpage_cli lark update-block <doc_token> robot_face "review_writeback.md"`
+
+## 待办处理约束（强制）
+
+- 新建 requirements.md 文档禁止 H1/H2，标题从 H3 开始
+- 必须移除指定提示语，并去掉“需求清单”标题本身
+- 必须把“AI 评审章节 + 待办问题”合并后再更新需求清单，不可仅依据待办原文机械改写
+
+## 成功标准
+
+- 有待办：所有待办均回写并标记 done；已基于“AI 评审章节 + 待办问题”完成需求清单澄清更新；仅完成待办处理相关的文档更新；不生成新的需求评审结论（也不创建新的 review.md）
+- 无待办：生成的评审结论回写成功；且回写内容满足“无 H1-H2 标题,无表格”的格式要求

package/templates/skills-template/feishu-prd-reviewer/example.md

@@ -0,0 +1,36 @@
+### 评审人
+
+模型名称
+
+### 需求点 1
+
+- **需求描述：**: （一句话概括要做什么，产品视角）
+  - （关键点 1）
+  - （关键点 2）
+
+### 需求点 2
+
+- **需求描述：**: （一句话概括要做什么，产品视角）
+
+- **问题：**
+  - （问题 1：必须澄清“页面/表/口径/范围/汇总规则”等）
+  - （问题 2）
+  - （问题 3）
+
+### 需求点 3
+
+- **需求描述：**: （一句话概括要做什么，产品视角）
+
+- **可行性：**
+  - 成本：低/中/高
+  - （在不引入猜测的前提下，说明成本对应的业务/口径/环节调整）
+
+### 需求点 4
+
+- **需求描述：**: （一句话概括要做什么，产品视角）
+- **可行性：**
+  - 成本：中/高
+  - （在不引入猜测的前提下，说明成本对应的业务/口径/环节调整）
+- **风险点：**
+  - （风险 1：可能影响的不止是展示文案，例如统计口径/汇总逻辑/跨模块联动等）
+  - （风险 2）

package/templates/skills-template/listpage-cli-deploy/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: listpage-cli-deploy
+description: Runs listpage_cli project build, release, and deploy in sequence (Docker build/push to registry and remote container). After a successful deploy, derive and tell the user the app access URL from listpage.config.json and backend listen port (see skill body). Use ONLY when the user explicitly asks to deploy using listpage_cli—e.g. mentions deploying with listpage_cli, listpage_cli 部署, or similar. Do NOT use for generic deployment, Docker/compose/K8s/CI, or Aliyun push without an explicit listpage_cli request. Default tag/environment is dev; users may name other environments in listpage.config.json docker.releaseProfiles (e.g. test, prod).
+---
+
+# listpage_cli 自动化部署
+
+## 何时使用本技能
+
+- **仅当用户明确说要通过 `listpage_cli` 部署**（例如：用 listpage_cli 部署、listpage_cli 发版等**且语境指向该 CLI**）时再应用本技能。
+- **不要**因泛泛的「部署」「上线」「打镜像」「推阿里云」等就启用；除非用户同时点明 **listpage_cli**。
+
+## Tag 与环境
+
+- `project release` / `project deploy` 的 **`<tag>`** 在习惯上对应**环境名**（开发 / 测试 / 生产等），与 `listpage.config.json` 里 **`docker.releaseProfiles`** 下的 key 一致；同一仓库可配置多套 profile（如 `dev`、`test`、`prod`），每套可有各自的 `tag`、`envFile` 等。
+- **若用户未指定环境或 tag，默认使用 `dev`**。
+
+在**项目根目录**（需存在 `listpage.config.json`）按顺序执行三条命令即可完成构建、镜像推送与远程容器部署。
+
+## 前置条件
+
+- 已安装并可执行 `listpage_cli`（可先运行 `listpage_cli --help` 核对子命令）。
+- 本机已安装 **Docker**，且 **Docker 守护进程已启动**（`release` / `deploy` 会用到本地 Docker 与远程配置）。
+- `listpage.config.json` 中 `docker.registry`、`docker.remote`、`docker.releaseProfiles` 等已按目标环境填好（见下文「常见坑」）。
+
+## 部署步骤（顺序固定）
+
+在项目根目录执行：
+
+```bash
+listpage_cli project build
+```
+
+- 校验当前目录为有效项目根，构建产物写入 **`.listpage/output`**。
+
+```bash
+listpage_cli project release <tag>
+```
+
+- 默认：`listpage_cli project release dev`（未指定环境时）。
+- `<tag>` 与 `listpage.config.json` 中 `docker.releaseProfiles` 的环境 key 对齐（如 `dev` / `test` / `prod`）；也可用 CLI 覆盖项，见 `listpage_cli --help` 中 `project release` 说明。
+- 流程：校验 `.listpage/output` → 登录 / 构建 / 打 tag / 推送到配置的镜像仓库。
+
+```bash
+listpage_cli project deploy <tag>
+```
+
+- 默认：`listpage_cli project deploy dev`（与 `release` 使用同一环境名）。
+- 使用 `docker.remote` + `docker.container` 部署；支持 `ports`、`envFile`、`env` 等合并。
+- 若镜像已在目标环境且仅需更新容器步骤，可使用 CLI 中的 `--skip-image`（以 `listpage_cli --help` 为准）。
+
+**CLI 参数优先级**（来自官方说明）：`CLI 参数 > profile > 配置文件中的 base 项`。可选参数包括 `--profile`、`--platform`、`--env KEY=VALUE` 等，需要时查阅 `listpage_cli --help`。
+
+## 部署成功后：告知用户访问地址
+
+在 **`project deploy` 成功结束**后，必须结合**项目根目录的 `listpage.config.json`**（以及必要时后端监听端口）拼出**应用访问地址**，并用一句话告诉用户。**不要**把 `docker.registry` 密码、`envFile` 内容等敏感信息写入回复。
+
+### 推导规则（按顺序）
+
+1. **主机（host）**  
+   使用 `docker.remote.host`（远程部署目标机的 IP 或域名）。**不要**用 `docker.remote.port`（那是连接 Docker API 的端口，例如 2376，不是浏览器访问端口）。
+
+2. **协议（scheme）**  
+   - **默认**：面向用户的应用 URL 使用 **`http`**。  
+   - `docker.remote.protocol`（如 `https`）仅表示连接 **Docker daemon** 的方式，**不能**直接当作浏览器访问应用的协议。  
+   - 若用户在前方挂了 **Nginx / 负载均衡 / 全站 HTTPS**，实际对外可能是 **`https`**；技能无法从配置文件唯一确定时，以 **`http` + host + 端口** 为主，并**简短说明**「若前面有 HTTPS 终止，请改用 https」。
+
+3. **路径（pathname / 前缀）**  
+   - **一般情况**：路径前缀与 **`docker.container.name`** 一致，格式为 **`/<container.name>`**（注意前导 `/`，且通常**全小写**与配置一致）。  
+   - **少数差异**：若前端 `assetPrefix` / `base`（如 `apps/fe` 的 `rsbuild.config.ts`）与 `docker.container.name` 不一致，应以**前端实际配置的 public 路径**为准（部署仍成功但路径不同时需核对前端）。默认在技能中优先 **`docker.container.name`**。
+
+4. **端口（浏览器访问的 host 端口）**  
+   读取 `docker.container.ports` 中每一项 **`"hostPort:containerPort"`** 字符串（与 Docker `-p` 一致）。  
+   - 先确定**容器内后端 HTTP 监听端口**：查看 `servers/be`（或配置里 `artifacts.backend.projectDir`）中 `listen(...)`、`Dockerfile` 的 `EXPOSE` 或 `PORT` 环境变量；常见为 **3000**。  
+   - 在 `ports` 数组里找到 **右侧（container）端口等于该后端端口** 的那一条，取**左侧（host）端口**作为 URL 中的端口。  
+   - **多条映射时**：始终使用「**对应后端对外提供 Web 服务的那一个容器端口**」所映射到主机上的端口，而不是 Docker API 或其它服务端口。  
+   - **单条映射**（如 `"3333:3000"`）：后端在容器内监听 3000 → 浏览器访问 **`3333`**。
+
+5. **拼 URL**  
+
+   `{scheme}://{docker.remote.host}:{上一步得到的 host 端口}/{路径前缀去掉多余斜杠}`  
+
+   路径前缀：若规则 3 得到 `/<name>`，则完整示例形态为：  
+   `http://{host}:{hostPort}/{container.name}/`  
+   末尾是否带 `/` 可按习惯，保持与前端 `assetPrefix` 一致即可。
+
+### 示例（与配置字段对应）
+
+若 `docker.remote.host` 为 `localhost`，`docker.container.name` 为 `contract-payment-collection`，`docker.container.ports` 为 `["3333:3000"]`，且后端在容器内监听 **3000**，则访问地址为：
+
+`http://localhost:3333/contract-payment-collection`
+
+（若用户仅配置了 http 场景，上述即为默认输出；支持 https 时由用户或前置代理决定，可在说明中一句带过。）
+
+## 常见坑与配置要点
+
+### 1. Dockerfile 基础镜像（如 `FROM node:25-slim`）
+
+本地构建镜像时，若基础镜像未拉取过，`docker build` 可能失败或变慢。部署前可在本机先执行 `docker pull node:25-slim`（或与 `servers/be/Dockerfile` 中 `FROM` 一致的镜像），保证与构建环境一致。
+
+### 2. `docker.remote.tls`（ca / cert / key）
+
+`listpage.config.json` 里 `docker.remote.tls` 的 `ca`、`cert`、`key` 路径指向的证书**与目标远程 Docker 主机绑定**；换一台部署机或重建 TLS 时，需替换为对应文件并保持路径可访问。
+
+### 3. `docker.build.platform`（如 `linux/amd64`）
+
+该字段影响**构建出的镜像架构**。例如：在 Apple Silicon Mac 上若要把镜像跑到 **x86 云服务器**，通常使用 `linux/amd64`；若目标为本机或 ARM 机器，需改为匹配的 `platform`（或通过 CLI 传 `--platform` 覆盖）。与运行环境不一致会导致容器无法运行或性能异常。
+
+### 4. 阿里云镜像仓库账号
+
+`docker.registry` 中的 `url`、`namespace`、`username`、`password` 为**敏感信息**。技能与文档中只描述「在配置中填写」，不要在对话、提交记录或示例中粘贴真实密码；
+
+## 快速排错
+
+| 现象 | 可检查项 |
+|------|----------|
+| `build` 失败 | 是否在项目根目录、`listpage.config.json` 是否完整、前后端构建脚本是否正常 |
+| `release` 失败 | Docker 是否启动、基础镜像是否可拉取、registry 账号与网络、platform 是否与预期一致 |
+| `deploy` 失败 | `docker.remote` 地址/端口/协议、TLS 证书是否匹配当前主机、`envFile` 路径是否存在 |
+
+## 参考命令说明
+
+执行 `listpage_cli --help` 可查看 `project build` / `project release` / `project deploy` 的完整参数与备注。

package/bin/commands/install-skill-command.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createInstallSkillCommandHandler = createInstallSkillCommandHandler;
-const install_skill_service_1 = require("../services/install-skill-service");
-function createInstallSkillCommandHandler(deps) {
-    return async (input) => {
-        return (0, install_skill_service_1.runInstallSkillFlow)(input, deps);
-    };
-}

package/templates/frontend-template/src/api/config.tsx

@@ -1,26 +0,0 @@
-import { HttpClient } from 'listpage-next';
-
-const isDev = process.env.NODE_ENV === 'development';
-
-// 创建axios实例
-const apiClient = new HttpClient({
-  token: 'admin',
-  tokenKey: '',
-  successCodes: [20000, 200],
-  server: {
-    protocol: undefined,
-    host: isDev ? 'localhost' : undefined,
-    port: isDev ? '3000' : undefined,
-    publicPath: '/api/v1',
-  },
-  config: {
-    timeout: 10000,
-    headers: {
-      'Content-Type': 'application/json',
-    },
-  },
-});
-
-apiClient.setup();
-
-export default apiClient;

package/templates/rush-template/.github/workflows/ci.yml

@@ -1,27 +0,0 @@
-name: CI
-on:
-  push:
-    branches: [ "main" ]
-  pull_request:
-    branches: [ "main" ]
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v3
-        with:
-          fetch-depth: 2
-      - name: Git config user
-        uses: snow-actions/git-config-user@v1.0.0
-        with:
-          name: # Service Account's Name
-          email: # Service Account's Email Address
-      - uses: actions/setup-node@v3
-        with:
-          node-version: 16
-      - name: Verify Change Logs
-        run: node common/scripts/install-run-rush.js change --verify
-      - name: Rush Install
-        run: node common/scripts/install-run-rush.js install
-      - name: Rush rebuild
-        run: node common/scripts/install-run-rush.js rebuild --verbose --production

package/templates/rush-template/.trae/rules/project_rules.md

@@ -1,25 +0,0 @@
-# 项目规则
-
-## 必须遵守的规则
-
-### 技术方案编写规则
-
-1. 存放目录: .trae/documents/ 下面。
-2. 文件名称: xxx 技术方案.md
-
-### 前端开发的规则
-
-1. 前端组件导出必须使用具名导出，禁止 export default 的写法！！！
-2. 当使用 ListPage 组件时，必须遵守项目内容文档：[ListPage-AI 生成规范](docs/ListPage-AI生成规范.md)。
-3. 禁止使用 React.FC 来定义组件，组件的类型应该是 `(props: Props) => JSX.Element`, 不用显式声明。
-4. 前端接口维护在 `api` 目录下, 所有的接口从 `api/index.ts` 中导出,严格遵守现在`api`目录的结构，并在需要的使用的时候从 `api/index.ts` 中引入
-
-### 后端开发的规则
-
-1. 后端接口如无特殊要求均采用 POST 请求
-2. 对于列表查询的，默认请求体一定包含 current, pageSize 两个参数
-3. 后端接口返回的格式要求如下：
-   - 失败时，直接抛出异常，由拦截器自行处理，不用管
-   - 成功时：
-     - 常规数据的格式：{ code: 0, data: {} }，控制器返回的数据直接就是 data，不需要再包一层
-     - 列表数据的格式：{ code: 0, data: { list: [], total: 0, current: 1, pageSize: 10 } }，控制器返回的数据直接就是 data，不需要再包一层