listpage_cli 0.0.310 → 0.0.312

package/bin/adapters/cli-interaction.js

@@ -160,17 +160,15 @@ function printHelp() {
         `    用法: ${helpColor("listpage_cli install-skill [skillName] [--project]", "dim")}`,
         "    说明: 安装技能到 Cursor；默认 skillName 为 test，安装到当前命令执行目录的 .cursor/skills/",
         "",
-        `  ${helpColor("build-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli build-project", "dim")}`,
-        "    说明: 非交互校验当前目录是否为有效项目根（需存在 listpage.config.json）",
+        `  ${helpColor("project", "green")}`,
+        `    用法: ${helpColor("listpage_cli project build", "dim")}`,
+        "    说明: 非交互校验当前目录是否为有效项目根（需存在 listpage.config.json），构建并写入 .listpage/output",
         "",
-        `  ${helpColor("release-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli release-project [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE]", "dim")}`,
+        `    用法: ${helpColor("listpage_cli project release [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE]", "dim")}`,
         "    说明: 先校验 .listpage/output 产物，再按 login/build/tag/push 执行 Docker 发布",
         `    备注: ${helpColor("参数优先级为 CLI > profile > base", "yellow")}`,
         "",
-        `  ${helpColor("deploy-project", "green")}`,
-        `    用法: ${helpColor("listpage_cli deploy-project [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE] [--skip-image]", "dim")}`,
+        `    用法: ${helpColor("listpage_cli project deploy [tag] [--profile dev] [--platform linux/amd64] [--env KEY=VALUE] [--skip-image]", "dim")}`,
         "    说明: 使用 docker.remote + docker.container 执行部署，支持 ports[] 与 envFile/env 合并",
         `    备注: ${helpColor("默认会清理并拉取镜像；传入 --skip-image 时只执行容器相关步骤（假定镜像已是最新且已存在）", "yellow")}`,
         `          ${helpColor("参数优先级为 CLI > profile > base", "yellow")}`,

package/bin/app/parse-args.js

@@ -1,16 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliOptionArgStartIndex = cliOptionArgStartIndex;
+exports.parseProjectTailPositionals = parseProjectTailPositionals;
 exports.parseArgs = parseArgs;
 exports.parseCommandOptions = parseCommandOptions;
 exports.parseCommandPositionals = parseCommandPositionals;
 const KNOWN_COMMANDS = new Set([
     "init",
     "install-skill",
-    "build-project",
-    "release-project",
-    "deploy-project",
+    "project",
     "lark",
 ]);
+function cliOptionArgStartIndex(command) {
+    return 1;
+}
+/**
+ * `project <sub> [tag] ...` 中，子命令之后的位置参数（如 release/deploy 的镜像 tag）。
+ */
+function parseProjectTailPositionals(rawArgs) {
+    return parseCommandPositionals(rawArgs, "project").slice(1);
+}
 function parseArgs(argv) {
     const rawArgs = [...argv];
     const commandToken = rawArgs[0];
@@ -41,8 +50,8 @@ function parseArgs(argv) {
         positionals,
     };
 }
-function parseCommandOptions(rawArgs) {
-    const args = rawArgs.slice(1);
+function parseCommandOptions(rawArgs, command) {
+    const args = rawArgs.slice(cliOptionArgStartIndex(command));
     const profile = readSingleOption(args, "profile");
     const platform = readSingleOption(args, "platform");
     const envEntries = readMultiOption(args, "env");
@@ -55,8 +64,8 @@ function parseCommandOptions(rawArgs) {
         skipImage: skipImage || undefined,
     };
 }
-function parseCommandPositionals(rawArgs) {
-    const args = rawArgs.slice(1);
+function parseCommandPositionals(rawArgs, command) {
+    const args = rawArgs.slice(cliOptionArgStartIndex(command));
     const positionals = [];
     const optionsWithValue = new Set(["--profile", "--platform", "--env"]);
     for (let index = 0; index < args.length; index += 1) {

package/bin/cli.js

@@ -6,9 +6,7 @@ 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 build_project_command_1 = require("./commands/build-project-command");
-const release_project_command_1 = require("./commands/release-project-command");
-const deploy_project_command_1 = require("./commands/deploy-project-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");
 const filesystem_capability_service_1 = require("./services/filesystem-capability-service");
@@ -33,14 +31,10 @@ const installSkillCommandHandler = (0, install_skill_command_1.createInstallSkil
         defaultSkillName: "test",
     },
 });
-const buildProjectCommandHandler = (0, build_project_command_1.createBuildProjectCommandHandler)({
-    fs: fsAdapter,
-});
-const releaseProjectCommandHandler = (0, release_project_command_1.createReleaseProjectCommandHandler)({
-    fs: fsAdapter,
-});
-const deployProjectCommandHandler = (0, deploy_project_command_1.createDeployProjectCommandHandler)({
-    fs: fsAdapter,
+const projectCommandHandler = (0, project_command_1.createProjectCommandHandler)({
+    build: { fs: fsAdapter },
+    release: { fs: fsAdapter },
+    deploy: { fs: fsAdapter },
 });
 const larkCommandHandler = (0, lark_command_1.createLarkCommandHandler)({
     fs: fsAdapter,
@@ -52,9 +46,7 @@ async function main() {
         handlers: {
             init: initCommandHandler,
             "install-skill": installSkillCommandHandler,
-            "build-project": buildProjectCommandHandler,
-            "release-project": releaseProjectCommandHandler,
-            "deploy-project": deployProjectCommandHandler,
+            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,15 +1,15 @@
 "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.parseCommandPositionals)(input.rawArgs)[0];
+        const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];
         const tag = typeof firstPositional === "string" && firstPositional.trim() !== ""
             ? firstPositional.trim()
             : undefined;
-        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs);
+        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs, "project");
         const cliOverrides = {
             tag,
             profile: options.profile,

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

@@ -1,15 +1,15 @@
 "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.parseCommandPositionals)(input.rawArgs)[0];
+        const firstPositional = (0, parse_args_1.parseProjectTailPositionals)(input.rawArgs)[0];
         const tag = typeof firstPositional === "string" && firstPositional.trim() !== ""
             ? firstPositional.trim()
             : undefined;
-        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs);
+        const options = (0, parse_args_1.parseCommandOptions)(input.rawArgs, "project");
         const cliOverrides = {
             tag,
             profile: options.profile,

package/bin/commands/project-command.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createProjectCommandHandler = createProjectCommandHandler;
+const command_result_1 = require("../domain/command-result");
+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);
+    const deploy = (0, deploy_project_command_1.createDeployProjectCommandHandler)(deps.deploy);
+    return async (input) => {
+        const subCommand = input.positionals[0];
+        switch (subCommand) {
+            case "build":
+                return build(input);
+            case "release":
+                return release(input);
+            case "deploy":
+                return deploy(input);
+            default:
+                return (0, command_result_1.commandError)("错误: 未知的子命令。目前仅支持: build, release, deploy", "invalid_subcommand", 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({
@@ -76,13 +83,36 @@ function getBuildTargets(projectRoot, config) {
         projectDir: resolveBuildTarget(projectRoot, item.projectDir),
     }));
 }
+function resolveArtifactsBuildSlice(config) {
+    const artifacts = config.artifacts;
+    if (artifacts && typeof artifacts === "object" && !Array.isArray(artifacts)) {
+        const a = artifacts;
+        return {
+            frontend: a.frontend ?? config.frontend,
+            backend: a.backend ?? config.backend,
+            copyFiles: a.copyFiles ?? config.copyFiles,
+        };
+    }
+    return {
+        frontend: config.frontend,
+        backend: config.backend,
+        copyFiles: config.copyFiles,
+    };
+}
 function toBuildProjectConfig(config) {
-    const frontendRaw = config.frontend;
-    const backendRaw = config.backend;
+    const slice = resolveArtifactsBuildSlice(config);
+    const frontendRaw = slice.frontend;
+    if (!Array.isArray(frontendRaw) || frontendRaw.length === 0) {
+        throw new Error("配置字段无效: frontend (至少包含一个构建项)");
+    }
+    const backendRaw = slice.backend;
+    if (!backendRaw || typeof backendRaw !== "object" || Array.isArray(backendRaw)) {
+        throw new Error("配置字段无效: backend");
+    }
     return {
         frontend: frontendRaw.map((item) => toBuildTarget(item)),
         backend: toBuildTarget(backendRaw),
-        copyFiles: toCopySpecs(config.copyFiles),
+        copyFiles: toCopySpecs(slice.copyFiles),
     };
 }
 function toBuildTarget(item) {
@@ -115,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "listpage_cli",
-  "version": "0.0.310",
+  "version": "0.0.312",
   "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.310"
+    "listpage-next-nest": "~0.0.312"
   },
   "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.310",
-    "react-router-dom": ">=6.0.0",
-    "@ant-design/v5-patch-for-react-19": "~1.0.3",
+    "listpage-http": "0.0.312",
+    "listpage-components": "0.0.312",
+    "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.310",
-    "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/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，不需要再包一层