项目介绍文档需删除无主语形容词，用真实角色与动作重写开头，并补充本地联调路径、环境切换方式和报错速查表三类关键信息。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
写项目介绍文档时，套话感会让技术负责人一眼扫过去就关掉页面——“高性能”“易扩展”“模块化设计”这类词既不能帮你过立项评审，也无法让新同事快速上手。
第一步：删掉所有没主语的形容词短语
打开你正在写的项目介绍文档，通读三遍，把所有不带具体执行者、不指向可验证动作的词直接删掉。比如“具备高可用性”→删；“支持灵活配置”→删；“采用微服务架构”→保留，但必须紧跟着写清楚“谁在什么环节调用哪个服务”。
这一步不做，后面加再多细节都是浮沙筑塔。【删完后全文剩余形容词不得超过2个】。
第二步：用真实角色+真实动作重写开头段
方法一：以“新人第一天要做的事”为锚点重写首段
不要写“本系统面向企业级用户”，而写：“运维同学入职第一天，执行 trae deploy --env=prod --region=shanghai，5分钟内完成灰度发布并收到钉钉告警确认。”
方法二：用故障场景反推价值
不要写“提供完善的监控能力”，而写：“当订单支付回调超时率突增至12%时，值班工程师打开 /dashboard/trace?service=pay-gateway，30秒内定位到是Redis连接池耗尽，而非下游接口问题。”
第三步：补全中文团队真正卡点的三类信息
① 本地联调路径：
前端同学拉完代码后，执行 npm run dev → 打开 http://localhost:8080/mock/order/list 查看模拟返回数据；后端同学需先启动 docker-compose -f docker/mock.yml up -d。
② 环境切换方式：
修改 src/config/env.ts 中的 API_BASE_URL 字段，从 https://api-dev.trae.cn 切换为 https://api-prod.trae.cn；【切换后必须运行 yarn test:e2e --env=prod 验证核心链路】。
③ 报错速查表：
报错信息 “ERR_CONNECTION_REFUSED” → 检查是否漏启 mock 服务；
报错信息 “401 Unauthorized” → 核对 .env.local 中 VUE_APP_TOKEN 是否为空或过期；
报错信息 “Module not found: Error: Can't resolve 'lodash/debounce'” → 运行 npm install lodash@4.17.21 锁死版本（因内部Harbor镜像仅缓存该版本）。
