project-interview-skill 1.1.0

package/bin/project-interview-skill.js

@@ -0,0 +1,470 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const PACKAGE_NAME = 'project-interview-skill';
+const SKILL_DIR_NAME = 'project-interview-skill';
+const SUPPORTED_PRODUCTS = ['agents', 'trae', 'cursor', 'vscode', 'claude-code', 'codex'];
+const COLORS = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  red: '\x1b[31m',
+};
+const BUNDLE_ENTRIES = [
+  'SKILL.md',
+  'references',
+  'scripts',
+  'README.md',
+  'LICENSE',
+];
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] && !args[0].startsWith('-') ? args.shift() : 'install';
+
+  try {
+    if (args.includes('--help') || args.includes('-h')) {
+      printHelp();
+      return;
+    }
+
+    if (command === 'install') {
+      install(parseArgs(args));
+    } else if (command === 'doctor') {
+      doctor(parseArgs(args));
+    } else if (command === 'help' || command === '--help' || command === '-h') {
+      printHelp();
+    } else {
+      throw new Error(`Unknown command: ${command}`);
+    }
+  } catch (error) {
+    errorLog(error.message);
+    process.exit(1);
+  }
+}
+
+function parseArgs(args) {
+  const options = {
+    product: '',
+    project: false,
+    dryRun: false,
+    installAll: false,
+    customPath: '',
+  };
+
+  for (let index = 0; index < args.length; index += 1) {
+    const arg = args[index];
+
+    if (arg === '--project') {
+      options.project = true;
+    } else if (arg === '--dry-run') {
+      options.dryRun = true;
+    } else if (arg === '--all') {
+      options.installAll = true;
+    } else if (arg === '--path') {
+      options.customPath = requireValue(args, index, '--path');
+      index += 1;
+    } else if (arg === '--platform' || arg === '--product') {
+      options.product = normalizeProduct(requireValue(args, index, arg));
+      index += 1;
+    } else if (arg.startsWith('--')) {
+      const product = normalizeProduct(arg.slice(2));
+      if (SUPPORTED_PRODUCTS.includes(product)) {
+        options.product = product;
+      } else {
+        throw new Error(`Unknown option: ${arg}`);
+      }
+    } else {
+      throw new Error(`Unexpected argument: ${arg}`);
+    }
+  }
+
+  if (options.installAll && options.product) {
+    throw new Error('Use either --all or one product flag, not both.');
+  }
+
+  return options;
+}
+
+function requireValue(args, index, flag) {
+  const value = args[index + 1];
+  if (!value || value.startsWith('-')) {
+    throw new Error(`Missing value for ${flag}`);
+  }
+  return value;
+}
+
+function normalizeProduct(value) {
+  const normalized = value.toLowerCase();
+  const aliases = {
+    agent: 'agents',
+    universal: 'agents',
+    claude: 'claude-code',
+    claudecode: 'claude-code',
+    'claude_code': 'claude-code',
+    vs: 'vscode',
+    'vs-code': 'vscode',
+    code: 'vscode',
+  };
+  return aliases[normalized] || normalized;
+}
+
+function install(options) {
+  validatePackage();
+
+  const products = options.installAll
+    ? SUPPORTED_PRODUCTS
+    : [options.product || 'agents'];
+  const installedTargets = new Set();
+  const installedProducts = [];
+
+  for (const product of products) {
+    validateProduct(product);
+    const target = resolveTarget(product, options);
+    if (installedTargets.has(target.displayPath)) {
+      info(`Skipping ${product}; target already handled: ${target.displayPath}`);
+      continue;
+    }
+    installedTargets.add(target.displayPath);
+    installProduct(product, target, options);
+    installedProducts.push(product);
+  }
+
+  if (!options.dryRun && installedProducts.length > 0) {
+    printNextSteps(installedProducts, options);
+  }
+}
+
+function doctor(options) {
+  const cwd = process.cwd();
+  const home = os.homedir();
+
+  info(`Package root: ${packageRoot()}`);
+  info(`Current project: ${cwd}`);
+  info(`Home: ${home}`);
+  console.log('');
+  console.log('Product targets:');
+
+  for (const product of SUPPORTED_PRODUCTS) {
+    const userTarget = resolveTarget(product, { ...options, project: false });
+    const projectTarget = resolveTarget(product, { ...options, project: true });
+    console.log(`- ${product}`);
+    console.log(`  user:    ${userTarget.displayPath}`);
+    console.log(`  project: ${projectTarget.displayPath}`);
+  }
+}
+
+function validateProduct(product) {
+  if (!SUPPORTED_PRODUCTS.includes(product)) {
+    throw new Error(`Unsupported product "${product}". Supported: ${SUPPORTED_PRODUCTS.join(', ')}`);
+  }
+}
+
+function resolveTarget(product, options) {
+  if (options.customPath) {
+    return {
+      type: 'bundle',
+      product,
+      root: path.resolve(options.customPath),
+      displayPath: path.resolve(options.customPath),
+    };
+  }
+
+  const base = options.project ? process.cwd() : os.homedir();
+
+  if (product === 'agents' || product === 'codex') {
+    const root = path.join(base, '.agents', 'skills', SKILL_DIR_NAME);
+    return { type: 'bundle', product, root, displayPath: root };
+  }
+
+  if (product === 'claude-code') {
+    const root = path.join(base, '.claude', 'skills', SKILL_DIR_NAME);
+    return { type: 'bundle', product, root, displayPath: root };
+  }
+
+  if (product === 'trae') {
+    const root = options.project
+      ? path.join(base, '.trae', 'rules', SKILL_DIR_NAME)
+      : path.join(base, '.trae', 'skills', SKILL_DIR_NAME);
+    return { type: 'bundle-with-plain-rule', product, root, displayPath: root };
+  }
+
+  if (product === 'cursor') {
+    const root = path.join(base, '.cursor', 'rules', SKILL_DIR_NAME);
+    return { type: 'bundle-with-cursor-rule', product, root, displayPath: root };
+  }
+
+  const instructionsFile = options.project
+    ? path.join(base, '.github', 'instructions', `${SKILL_DIR_NAME}.instructions.md`)
+    : path.join(base, '.copilot', 'instructions', `${SKILL_DIR_NAME}.instructions.md`);
+  return {
+    type: 'vscode-instructions',
+    product,
+    root: instructionsFile,
+    displayPath: instructionsFile,
+  };
+}
+
+function installProduct(product, target, options) {
+  if (options.dryRun) {
+    info(`[dry-run] ${product}: ${target.displayPath}`);
+    return;
+  }
+
+  if (target.type === 'vscode-instructions') {
+    writeVsCodeInstructions(target.root);
+    ok(`Installed for ${productLabel(product)}`);
+    console.log(`     ${dim(target.root)}`);
+    return;
+  }
+
+  replaceDirectory(target.root);
+  copyBundle(target.root);
+
+  if (target.type === 'bundle-with-cursor-rule') {
+    writeCursorRule(path.join(target.root, `${SKILL_DIR_NAME}.mdc`));
+  }
+
+  if (target.type === 'bundle-with-plain-rule') {
+    writePlainRule(path.join(target.root, `${SKILL_DIR_NAME}.md`));
+  }
+
+  ok(`Installed for ${productLabel(product)}`);
+  console.log(`     ${dim(target.root)}`);
+}
+
+function validatePackage() {
+  const skillPath = path.join(packageRoot(), 'SKILL.md');
+  if (!fs.existsSync(skillPath)) {
+    throw new Error(`Missing SKILL.md at ${skillPath}`);
+  }
+
+  const firstLine = fs.readFileSync(skillPath, 'utf8').split(/\r?\n/, 1)[0];
+  if (firstLine !== '---') {
+    throw new Error('SKILL.md must start with YAML frontmatter (---).');
+  }
+}
+
+function copyBundle(destination) {
+  fs.mkdirSync(destination, { recursive: true });
+
+  for (const entry of BUNDLE_ENTRIES) {
+    const source = path.join(packageRoot(), entry);
+    if (!fs.existsSync(source)) {
+      continue;
+    }
+    const target = path.join(destination, entry);
+    copyRecursive(source, target);
+  }
+}
+
+function copyRecursive(source, target) {
+  const stat = fs.statSync(source);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(target, { recursive: true });
+    for (const child of fs.readdirSync(source)) {
+      copyRecursive(path.join(source, child), path.join(target, child));
+    }
+    return;
+  }
+  fs.mkdirSync(path.dirname(target), { recursive: true });
+  fs.copyFileSync(source, target);
+}
+
+function replaceDirectory(directory) {
+  const absolute = path.resolve(directory);
+  const home = path.resolve(os.homedir());
+  if (absolute === path.parse(absolute).root || absolute === home || absolute === process.cwd()) {
+    throw new Error(`Refusing to replace unsafe directory: ${absolute}`);
+  }
+  fs.rmSync(absolute, { recursive: true, force: true });
+  fs.mkdirSync(absolute, { recursive: true });
+}
+
+function writeCursorRule(filePath) {
+  const description = extractDescription();
+  const body = skillBody();
+  const content = [
+    '---',
+    `description: ${description}`,
+    'globs:',
+    'alwaysApply: true',
+    '---',
+    body,
+  ].join('\n');
+  writeFile(filePath, content);
+}
+
+function writePlainRule(filePath) {
+  writeFile(filePath, skillBody());
+}
+
+function writeVsCodeInstructions(filePath) {
+  const body = skillBody();
+  const content = [
+    '---',
+    "applyTo: '**'",
+    '---',
+    body,
+  ].join('\n');
+  writeFile(filePath, content);
+}
+
+function writeFile(filePath, content) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, `${content.replace(/\s+$/, '')}\n`, 'utf8');
+}
+
+function skillBody() {
+  const content = fs.readFileSync(path.join(packageRoot(), 'SKILL.md'), 'utf8');
+  const lines = content.split(/\r?\n/);
+  let delimiterCount = 0;
+  const body = [];
+
+  for (const line of lines) {
+    if (line === '---') {
+      delimiterCount += 1;
+      continue;
+    }
+    if (delimiterCount >= 2) {
+      body.push(line);
+    }
+  }
+
+  return body.join('\n').trim();
+}
+
+function extractDescription() {
+  const content = fs.readFileSync(path.join(packageRoot(), 'SKILL.md'), 'utf8');
+  const lines = content.split(/\r?\n/);
+  let inFrontmatter = false;
+  let inDescriptionBlock = false;
+  const description = [];
+
+  for (let index = 0; index < lines.length; index += 1) {
+    const line = lines[index];
+    if (index === 0 && line === '---') {
+      inFrontmatter = true;
+      continue;
+    }
+    if (inFrontmatter && line === '---') {
+      break;
+    }
+    if (!inFrontmatter) {
+      continue;
+    }
+    if (inDescriptionBlock) {
+      if (/^\s+/.test(line)) {
+        description.push(line.trim());
+        continue;
+      }
+      break;
+    }
+    if (line.startsWith('description:')) {
+      const value = line.replace(/^description:\s*/, '').trim();
+      if (value === '>-' || value === '>' || value === '') {
+        inDescriptionBlock = true;
+      } else {
+        return value;
+      }
+    }
+  }
+
+  return description.join(' ') || PACKAGE_NAME;
+}
+
+function packageRoot() {
+  return path.resolve(__dirname, '..');
+}
+
+function printHelp() {
+  console.log(`${bold(PACKAGE_NAME)}
+
+Usage:
+  npx ${PACKAGE_NAME} install [--agents|--trae|--cursor|--vscode|--claude-code|--codex]
+  npx ${PACKAGE_NAME} install --project [--trae|--cursor|--vscode|--claude-code|--codex]
+  npx ${PACKAGE_NAME} install --all [--project]
+  npx ${PACKAGE_NAME} doctor
+
+Options:
+  --agents         Install to ~/.agents/skills/ (default user-level target)
+  --trae           Install for Trae
+  --cursor         Install for Cursor
+  --vscode         Install VS Code Copilot instructions
+  --claude-code    Install for Claude Code
+  --codex          Install to .agents/skills for Codex
+  --project        Install under the current project instead of the user home
+  --all            Install every supported target
+  --path PATH      Install the full skill bundle to a custom path
+  --dry-run        Print target paths without writing files
+  -h, --help       Show this help
+`);
+}
+
+function info(message) {
+  console.log(`${color('[info]', 'blue')} ${message}`);
+}
+
+function ok(message) {
+  console.log(`${color('[ok]', 'green')} ${message}`);
+}
+
+function errorLog(message) {
+  console.error(`${color('[error]', 'red')} ${message}`);
+}
+
+function printNextSteps(products, options) {
+  const targetText = products.map(productLabel).join(', ');
+  console.log('');
+  ok(`${PACKAGE_NAME} is ready for ${targetText}.`);
+  console.log('');
+  console.log(bold('Next:'));
+  console.log(`  1. Restart ${nextStepProductText(products)}.`);
+  console.log('  2. Open your project root.');
+  console.log(`  3. Start a new chat with ${bold('/project-interview-skill')}.`);
+  if (!options.project) {
+    console.log(`  4. For one-project-only setup, run ${dim(`npx ${PACKAGE_NAME} install --project --<product>`)} in that project.`);
+  }
+}
+
+function nextStepProductText(products) {
+  if (products.length === 1) {
+    return productLabel(products[0]);
+  }
+  return 'the target IDE or Agent';
+}
+
+function productLabel(product) {
+  const labels = {
+    agents: 'Generic Agent',
+    trae: 'Trae',
+    cursor: 'Cursor',
+    vscode: 'VS Code',
+    'claude-code': 'Claude Code',
+    codex: 'Codex',
+  };
+  return labels[product] || product;
+}
+
+function bold(text) {
+  return color(text, 'bold');
+}
+
+function dim(text) {
+  return color(text, 'dim');
+}
+
+function color(text, colorName) {
+  if (process.env.NO_COLOR || !process.stdout.isTTY) {
+    return text;
+  }
+  return `${COLORS[colorName]}${text}${COLORS.reset}`;
+}
+
+main();

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "project-interview-skill",
+  "version": "1.1.0",
+  "description": "Install a project interview preparation skill for AI coding agents.",
+  "license": "MIT",
+  "author": "EastonJiang <jiangxu05@outlook.com>",
+  "homepage": "https://github.com/Jaxon1216/interview-analyzer-skill#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Jaxon1216/interview-analyzer-skill.git"
+  },
+  "bin": {
+    "project-interview-skill": "bin/project-interview-skill.js"
+  },
+  "files": [
+    "bin/",
+    "SKILL.md",
+    "references/",
+    "scripts/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "python3 -m unittest discover -s tests -v",
+    "pack:check": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/references/interview-rubric.md

@@ -0,0 +1,41 @@
+# 大厂风格面试关注点（工程向）
+
+用于生成「面经」与「追问」时的隐性评分维度。不必逐条对用户展示，但**问题与 STAR 要点应能覆盖其中多数**。
+
+## 问题空间
+
+- **场景**：用户量、数据量、峰值、地域、合规（如有）。
+- **约束**：延迟 SLO、成本上限、兼容性、迁移窗口、团队规模。
+
+## 技术深度
+
+- **原理**：为何这样设计，替代方案为何不行或次优。
+- **边界**：失败模式、竞态、一致性、背压、超时与重试风暴。
+- **观测**：日志/指标/链路追踪如何证明「有效」而非「感觉」。
+
+## 工程实践
+
+- **质量**：测试策略（单测/契约/集成/E2E）、CI、灰度、特性开关。
+- **协作**：接口契约、Code Review 关注点、文档与 handoff。
+- **线上**：事故响应、回滚、数据修复、事后复盘（无责文化下的改进项）。
+
+## 前端补充
+
+- 性能：首屏、长列表、包体、缓存与 CDN。
+- 状态与数据：服务端状态 vs 客户端、错误与加载边界。
+
+## 后端补充
+
+- 存储与索引、事务边界、幂等、消息语义（at-most-once / at-least-once / exactly-once 的表述谨慎）。
+- 多租户、限流、熔断、降级。
+
+## AI / ML 补充
+
+- 数据与标签、离线 vs 在线、延迟与成本、评估指标与偏差。
+- 安全：提示注入、PII、模型版本与回滚。
+
+## 「空话」黑名单（出现则改写）
+
+- 「优化了性能」→ 改为指标或**如何测量**。
+- 「提高了用户体验」→ 改为具体交互或错误率/任务完成率。
+- 「使用了先进架构」→ 改为具体模式与权衡。

package/references/oral-and-resume-patterns.md

@@ -0,0 +1,26 @@
+# 口播叙述与简历一句话（抽象模板）
+
+## 口播长答（工程向）推荐结构
+
+来自典型高质量回答的抽象，**不固定标题名**，但信息块应齐全，便于第一人称口述 ≥150 字。
+
+1. **场景（现象）**：线上/联调/上线初期的具体现象；可带比例、范围、如何发现（DevTools、日志、监控）。术语可加英文（如 `option`、`JSON.parse`）。
+2. **归因（根因）**：为何会发生——错把不确定输出当稳定 API、缺防御层、契约不清等；一句话点出**本质**。
+3. **动作（方案）**：分层写清：我先……再……最后……；可用编号列表（容错提取 → Schema 校验 → sanitize → 边界兜底）；每层说**手段 + 目的**。
+4. **结果与兜底**：指标或（待测）；若仍有异常路径，写降级（如 Error Boundary）与观测。
+
+口播语气：**面经全文第一人称「我」**；导学讲解可用「你应当理解」或中性说明，但涉及「如何答面试」的示范段可用第一人称口播。
+
+## 简历「项目简介 / 一句话」写法
+
+用 **1～2 句** 说清：**做什么 + 关键技术/形态 + 可选一句价值**，避免形容词堆砌。
+
+**抽象公式**：
+
+> 基于 {核心技术栈/范式} 的 {产品形态}，用户/业务侧能 {核心操作}，系统支持 {关键能力 A、B}，{可选：差异点如同步/异步、端侧等}。
+
+**示例形态（勿照抄项目名）**：
+
+> 基于 AI 大模型的智能 BI：用户上传 Excel 后，AI 自动生成 ECharts 图表与分析结论，支持同步/异步生成与拖拽看板组合多图。
+
+面经文档中的 **项目概要** 必须接近此密度与信息量，可直接贴简历「项目描述」栏。

package/references/oral-style-samples.md

@@ -0,0 +1,59 @@
+# 口播抽象层级样例(前端 + 后端各一份)
+
+面经口播的默认调性:**通用工程语言为主 + 极少量内部名兜底证据**。以下两份样例都属于该调性(简称 "样例风格 B"),生成面经时应对齐该抽象层级,不得下沉到"框架内部 API 堆叠"风格。
+
+## 判定标准
+
+- ✅ 通用词占主导(React / SSR / Hydration / State Machine / JSBridge / Race Condition / Idempotency / P95 …)
+- ✅ 每 150 字口播里,内部私名(私有 hook、私有函数、后端字段、私有枚举、私有打点事件、私有容器/命名空间、灰度开关键、业务代号)出现次数 ≤ 2 次
+- ✅ 每次出现私名,后半句紧跟"本质是 ×× 模式 / 抽象上是 ××"的翻译
+- ❌ 一整段口播里堆叠 5 个以上私名、每句一个字段名或函数名,即使内容真实也判不通过
+
+---
+
+## 样例一(前端)——首页 SSR 主链路与失败降级
+
+**面试官问题**:你们首页是怎么做服务端渲染的?SSR 失败了怎么办?
+
+**口播版(第一人称,≥150 字,完整 STAR,对齐样例风格 B)**:
+
+我们首页是端内 H5 主入口,流量大、首屏敏感,所以走了 **Streaming SSR**(情境)。目标是让首屏尽量在服务端直出、同时任何异常都不能白屏(任务)。做法上我把主链路拆成三段:①**服务端预取阶段**拉首屏聚合接口,拿到数据先做**契约断言**——字段不合法就抛错触发框架降级(内部我们叫 assert,本质是**响应体 schema 校验**),宁可退化到 CSR 也不渲染错数据;②**渲染阶段**用一个 async data boundary(类似 `<Suspense for data>`),把加载、成功、失败三种边界显式建模,pending 期展示骨架屏防止布局抖动(CLS)、resolve 后走 hydration、reject 直接跳兜底页;③**客户端接管**后我用一个**运行时命中标志**判断本次是否真的走了 SSR——没命中或者数据没落地就补发一次 CSR 请求兜底,不依赖服务端一定成功(行动)。最终形成"SSR 直出 → 命中即水合 → 未命中/失败降级 CSR 或兜底页"的闭环,并用**水合成功率打点**观测效果,具体数值以监控为准(结果/兜底)。
+
+**追问**:你怎么保证服务端和客户端渲染结果一致,不出现 Hydration mismatch?
+
+**口播版(≥150 字)**:
+
+Hydration mismatch 是同构渲染最经典的坑,根因是**服务端和客户端首次渲染看到的输入不一致**(情境/归因)。我的防护分三层:第一层是**运行环境隔离**——服务端预取分支绝不访问 `window`/`localStorage`/`navigator` 这类浏览器专属 API,需要的上下文统一通过请求头/query 在服务端算好,再通过一个**可序列化的 context**透传给客户端 hook 消费(行动)。这里有个序列化的坑:Fetch 标准的 `Headers` 是迭代器对象、直接 JSON 化会丢字段,所以要手动 forEach 摊平成 plain object 再传。第二层是**只在客户端渲染的内容**用 `<ClientOnly>` 或延迟到 `useEffect` 里执行,避免服务端提前渲染出和客户端不一致的 DOM。第三层是**身份态校验**——因为 SSR 直出的 HTML 里带的是服务端识别到的用户身份,如果端上当前登录用户已经变了(比如切了账号),我会在 hydration 完成后做一次身份比对,不一致就带一个 query 参数(相当于**强制 CSR 的 feature flag**)重新打开页面,避免串数据(行动/兜底)。这套做法上线后 hydration 相关的报错基本收敛到 0,具体成功率以打点监控为准(结果/待测)。
+
+---
+
+## 样例二(后端)——高并发下单接口的幂等与限流
+
+**面试官问题**:秒杀/大促场景下单接口你们怎么设计的?高并发下怎么保证不超卖、不重复扣款?
+
+**口播版(第一人称,≥150 字,完整 STAR,对齐样例风格 B)**:
+
+秒杀场景对我这条链路的核心挑战有三个:**瞬时高 QPS、库存不能超卖、支付不能重复扣款**(情境/任务)。我把下单接口设计成一条**分层收敛**的链路:①**入口层**先做限流——网关用令牌桶按用户维度限流,再叠加一层**热点探测**,发现某个 SKU 突增就走单独的**熔断降级**通道,防止把下游打爆(行动);②**幂等层**是核心——每次下单前端必须带一个**客户端生成的 request id**(idempotency key),后端拿到后先查 Redis 是否已处理过,如果命中就直接返回上次结果,保证同一 key 无论重放多少次都只成功扣一次库存(行动);③**库存扣减层**用 Redis 原子操作(`DECR` + Lua 脚本)预扣,预扣成功才进 MQ 走真正的落库与支付流程,避免直接打 DB 造成行锁(行动);④**最终一致**——支付回调走事务消息,失败/超时靠对账 job 兜底,保证扣款和订单状态最终一致(行动)。整条链路的 P95 我控制在 200ms 以内,超卖率上线以来是 0,幂等命中率和限流拒绝率都有监控大盘可以看,具体数值以监控为准(结果/兜底)。
+
+**追问**:如果 Redis 挂了、库存扣减扛不住怎么办?你怎么设计降级?
+
+**口播版(≥150 字)**:
+
+Redis 是这条链路的**关键依赖**,单点挂掉必须有兜底,不能让业务直接雪崩(情境/归因)。我的降级分三档:第一档是**Redis 主从切换**——运维层用 Sentinel 做故障转移,业务侧客户端配置了合理的连接超时和重试,主挂了几秒内会切到从,业务方几乎无感(行动);第二档是**Redis 整体不可用时的软降级**——预扣库存这一步用**本地内存 + 分布式限流器**做临时替代,单机维度还是能阻挡明显的超卖,虽然精度下降但至少不崩;同时前端页面通过一个 feature toggle(**灰度开关**)提示"火爆中,稍后重试",让流量削峰,避免请求全部打到 DB(行动);第三档是**兜底对账**——即便真的超卖了几单,我在异步链路里跑一个**定时对账 job**,拿实际入库量对齐订单表,超出部分自动退款并通知用户,保证账目最终正确(行动/兜底)。这套设计的底层原则是**"关键依赖不能有单点"**,同时**每一层降级都要伴随可观测**——限流拒绝率、Redis 命中率、对账差异数都有监控告警,一旦触发能第一时间人工介入,具体阈值和历史触发次数以监控为准(结果/待测)。
+
+---
+
+## 反例(禁止的调性)
+
+同一个前端 SSR 问题,如果写成下面这样就是**私名堆叠型**,面经生成时要主动改写:
+
+> 我们首页配的是 `ssr: { mode: 'stream' }`,服务端 `prefetch.server.ts` 里先 `fetchXxxHomepage` 拿数据,`homepageAssert` 断言失败就抛错。客户端入口用 `<Await resolve={promise}>` 解析预取结果,pending 显示 `RouterSkeleton`,reject 走 `errorElement` 跳 50x。我在 `useEffect` 里用 `isSSR()` 判断,如果 `getSSRRuntimeInfo().hit` 为 false,就调 `fetchRouterData` 补发 CSR 请求。全链路水合成功打点用的是 `xxx_router_streaming_ssr_hydrate_success`。
+
+失败原因:150 字里堆叠了 10+ 个只在本项目/本公司能搜到的私名,外部面试官既记不住、也无法追问,信息密度看似高实则接近 0。生成时应对齐样例一的抽象层级重写。
+
+---
+
+## 使用方式
+
+- 生成面经每一道主问/追问的口播时,先写通用抽象叙述,再决定是否需要 1~2 个内部名做证据;不要反过来"从私名堆到抽象"。
+- 生成完成后,拿本文件的**判定标准**做自检:密度超标、翻译缺失、堆叠反例特征命中三项中任何一项 → 该题重写。