需求翻译器 · ReqX v1.0
把客户的一句话需求，翻译成多部门可分工执行的技术任务清单。
产品经理 / 零代码开发者的「需求到执行」转换引擎。
§0 痛点
客户说：「我想要一个用户积分系统，可以查积分、兑礼品、看排行榜。」
开发说：「你这个需求太大了，能不能再细化一下？」
你夹在中间，反复翻译了三遍依然对不齐——ReqX 把这个活一次性做完。
§Q 快速上手
两种用法：
- AI 对话：「我的客户提了个需求：[原文]，帮我拆成技术任务清单」
- Python CLI：python reqx.py translate --text "[原文]" 或 python reqx.py demo
CLI 子命令一览：
- translate — 翻译需求
- depts — 列出六大部门及关键词
- demo — 演示完整流程
- echo — 客户可读的回译确认
§1 核心能力
- 六部门拆解：UI/UX、前端、后端、测试、数据/算法、运维/安全
- 要素提取：功能点、平台、数据实体、外部集成、约束
- 三策略匹配：完全匹配 1.0 / 部分匹配 0.3 / 归一化 0-1
- 工期估算：S(<1PD) / M(1-3PD) / L(3-7PD) / XL(>7PD)，按特征长度和复杂度
- 依赖分析：跨部门首尾接续，同部门任务并行
- 三种输出：Markdown 任务清单 / JSON 结构化 / 客户回译
§R 核心铁律
| # | 铁律 |
|---|---|
| R1 | 只翻译，不编码——不替技术团队写代码 |
| R2 | 输出前必校验——输入异常时返回错误码而非猜测 |
| R3 | 置信度透明——部门匹配置信度 < 0.5 时标注「待确认」 |
| R4 | 依赖保守——只设置跨部门首尾接续，不强加同部门链式依赖 |
| R5 | 默认值合理——未指定平台默认 Web，未指定优先级默认 P1 |
| R6 | 工期是参考——实际工时由技术负责人评估 |
§A 异常处理（完整速查表见 EXTEND.md §1）
| 级别 | 含义 | 示例 |
|---|---|---|
| E1 阻断 | 无法继续 | E1-001 输入过短 / E1-002 无可识别功能点 |
| E2 警告 | 建议补充 | E2-001 平台未指定 / E2-003 部门置信度低 |
| E3 建议 | 可用但可改进 | E3-001 优先级未指定 / E3-003 功能描述过简 |
§C 能力边界
| ✅ 能做 | ❌ 不做 |
|---|---|
| 自然语言→技术任务清单 | 详细技术方案设计 |
| 六部门智能派单 | 真实工时排期（仅估算） |
| 三种格式输出（MD/JSON/客户回译） | 直接对接 Jira/飞书任务系统 |
| 依赖链自动分析 | 自动通知开发团队 |
| 工期估算（S/M/L/XL） | 跨项目资源调度 |
§D 避坑指南
- 客户原话越具体越好——「登录注册」不如「手机号+微信快捷登录」
- 明确平台——Web/iOS/Android/小程序差异巨大
- 明确数据实体——「订单系统」要指明订单的字段
- 集成系统要列全——「接支付」要说明微信支付/支付宝/银联
- 优先级用 P0/P1/P2——比「紧急」这类词清晰
§E FAQ
| # | 问题 | 回答 |
|---|---|---|
| 1 | 怎么用？ | 「我有个需求：[原文]」或 python reqx.py translate --text "..." |
| 2 | 六部门怎么分？ | UI/UX、前端、后端、测试、数据/算法、运维/安全 |
| 3 | 能改部门吗？ | 改 reqx.py 中 DEPARTMENTS 字典的 keywords 和 task_templates |
| 4 | 输出能直接给开发吗？ | 能。Markdown 清单按部门分组，含 ID/工期/优先级/依赖 |
| 5 | 怎么确认客户理解？ | 用 python reqx.py echo 生成客户可读版回译 |
| 6 | 跨项目复用？ | 任务清单按项目归档到 ~/reqx/项目名/ 即可 |
| 更多（共 12 条）见 EXTEND.md §3 |
§F 版本历史
| 版本 | 日期 | 变更 |
|---|---|---|
| v1.0 | 2026-07 | 首次发布：六部门定义、模糊匹配引擎、三级错误码、依赖分析、三种输出格式 |
| （内容由AI生成，仅供参考） | ||
| （内容由AI生成，仅供参考） |
