init the project
This commit is contained in:
evyzacq
@@ -0,0 +1,69 @@
|
||||
你是吉利汽车车机系统（XX Auto）的产品需求分析师。你的任务是从行车娱乐限制功能 PRD 文档中提取"语义索引"——一份结构化的功能清单，而不是逐字翻译。
|
||||
|
||||
## 文档结构说明
|
||||
|
||||
下面是一份 Word 文档的解析结果，包含：
|
||||
|
||||
1. **sections**：按章节组织的混合内容（段落 + 表格），每个 section 有 `source`（章节标题）、`blocks`（`para` 文本段落和 `table` 结构表格）、`images`（引用的图片 ID 列表）
|
||||
2. **image_analysis**：文档中流程图的程序化分析结果，其中 `logic_tree` 是由节点组成的决策树：
|
||||
- `state` 节点：状态说明
|
||||
- `decision` 节点：判断条件 + `branches`（分支值 → 目标节点 ID）
|
||||
- `action` 节点：系统或用户交互动作
|
||||
3. **resolved_conflicts**：文档中图文冲突的仲裁结果，明确指出应以文字还是图片为准
|
||||
|
||||
## 文档全文
|
||||
|
||||
{document_json}
|
||||
|
||||
## 你的任务
|
||||
|
||||
阅读整份文档后，输出一份 **语义索引 JSON**，包含：
|
||||
|
||||
### 1. feature_name
|
||||
功能名称，如"行车娱乐限制"
|
||||
|
||||
### 2. concepts
|
||||
文档中定义或使用的关键概念列表。每个概念包含：
|
||||
- `name`：概念的标准名称
|
||||
- `aliases`：同义词/别名列表（如"行车娱乐限制"、"行车娱乐禁止"）
|
||||
- `defined_in`：定义该概念的章节号列表（如 ["3.1", "3.1.1"]）
|
||||
|
||||
应识别的概念类型包括但不限于：功能名称、应用类型（系统限制、SDK限制、其他应用）、限制方式（打断、禁止、暂停）、触发条件（车速、档位、持续时间）、开关状态等。
|
||||
|
||||
### 3. function_units
|
||||
文档中描述的所有主要功能行为的列表。**每个 function_unit 对应一条完整的"如果...则..."规则**。每个 function unit 包含：
|
||||
|
||||
- `unit_id`：唯一标识，格式 "FU-001", "FU-002"...
|
||||
- `name`：简短名称，如"系统限制-前台-行车打断"
|
||||
- `description`：1-3 句描述该规则的行为
|
||||
- `sources`：该规则在文档中的来源锚点列表，每项包含：
|
||||
- `section`：章节号
|
||||
- `type`：来源类型，`"table"` 或 `"para"` 或 `"logic_tree"`
|
||||
- `row`：如果是表格行（从 1 开始）
|
||||
- `text_snippet`：前 200 字的关键文字
|
||||
- `image_id`：如果是逻辑树来源，填写图片 rId
|
||||
- `logic_tree_nodes`：如果是逻辑树来源，列出相关节点 ID 列表
|
||||
|
||||
## 关键要求
|
||||
|
||||
1. **必须覆盖所有逻辑树分支**：遍历每个 `logic_tree` 中从根到叶的每条决策路径，确保它们都出现在某个 function_unit 中。逻辑树中的每个 `decision` 节点及其分支、每个 `action` 节点都必须被至少一个 function_unit 引用。
|
||||
|
||||
2. **必须覆盖表格中的所有规则**：表格中列出的每种"限制方法"、"限制规则"都要有对应的 function_unit。
|
||||
|
||||
3. **区分"限制"与"禁止"**：文档中"行车娱乐限制"和"行车娱乐禁止"是两个不同的子场景（一个针对前台应用打断、一个针对后台应用启动限制），必须分别建模。
|
||||
|
||||
4. **区分不同应用类型**：系统限制、SDK 限制、其他应用的行为路径不同。
|
||||
|
||||
5. **包含开关状态**：开关"开启"和"关闭"两种状态下的行为都要覆盖。
|
||||
|
||||
6. **如果 resolved_conflicts 中以图片为准**，则优先按逻辑树的路径描述行为；**如果以文字为准**，则优先按表格文字描述。
|
||||
|
||||
## 输出格式
|
||||
|
||||
**只输出 JSON，不要有 markdown 代码块标记或其他文字**：
|
||||
|
||||
{
|
||||
"feature_name": "...",
|
||||
"concepts": [ ... ],
|
||||
"function_units": [ ... ]
|
||||
}
|
||||
+162
@@ -0,0 +1,162 @@
|
||||
你是吉利汽车车机系统的需求分析专家。你的任务是基于给定的精准上下文包，为单个功能单元（Function Unit）提取详细的 **IR 规则（Intermediate Representation Rule）**。
|
||||
|
||||
## 上下文
|
||||
|
||||
下面是一个功能单元的精准上下文包，包含了从原始需求文档中提取的相关文字、表格和逻辑树：
|
||||
|
||||
### 功能单元概要
|
||||
- **unit_id**: {unit_id}
|
||||
- **unit_name**: {unit_name}
|
||||
- **unit_description**: {unit_description}
|
||||
|
||||
### 相关文字段落
|
||||
{texts}
|
||||
|
||||
### 相关表格
|
||||
{tables}
|
||||
|
||||
### 相关逻辑树
|
||||
{logic_trees}
|
||||
|
||||
### 图文冲突仲裁（如有）
|
||||
{resolved_conflicts}
|
||||
|
||||
## IR Schema
|
||||
|
||||
你需要为这个功能单元输出一个 **规则数组（rules）**。每条规则遵循以下 schema：
|
||||
|
||||
```json
|
||||
{{
|
||||
"rule_id": "{unit_id}-SYS-FG-01",
|
||||
"description": "用完整的中文自然语言描述该规则的触发条件和行为，一句话概括",
|
||||
"priority": "P0",
|
||||
"sources": [
|
||||
{{"type": "table", "section": "3.1.1", "row": 2, "text_snippet": "打断：车速≥15km/h..."}},
|
||||
{{"type": "logic_tree", "image_id": "rId16", "node_ids": ["n19", "n21", "n23", "n25", "n26"]}}
|
||||
],
|
||||
"precondition": {{
|
||||
"switch": "开启",
|
||||
"app_type": "系统限制",
|
||||
"app_state": "前台"
|
||||
}},
|
||||
"trigger": {{
|
||||
"operator": "AND",
|
||||
"conditions": [
|
||||
{{"signal": "车速", "operator": ">=", "value": 15, "unit": "km/h"}},
|
||||
{{"signal": "车速_持续时间", "operator": ">", "value": 5, "unit": "秒"}},
|
||||
{{"signal": "档位", "operator": "!=", "value": "P"}}
|
||||
]
|
||||
}},
|
||||
"actions": [
|
||||
{{"type": "system", "description": "打断应用前台进程"}},
|
||||
{{"type": "system", "description": "将应用调入后台"}},
|
||||
{{"type": "user_interaction", "description": "显示Toast", "content": "在行车状态下无法使用该应用"}}
|
||||
]
|
||||
}}
|
||||
```
|
||||
|
||||
### 字段说明（必读）
|
||||
|
||||
1. **rule_id**: 格式为 `{unit_id}-类型-序号`，其中类型可以是 SYS（系统行为）、UI（用户交互）、SDK（SDK 限制）。序号从 01 开始。
|
||||
2. **description**: 完整但简洁地描述整个规则，包括前置条件、触发条件和所有动作。用中文。
|
||||
3. **priority**: P0（核心安全规则）、P1（重要规则）、P2（边界情况）。
|
||||
4. **sources**: 每条规则必须列出所有数据来源，包括：
|
||||
- 引用的表格行（section, row, text_snippet）
|
||||
- 引用的逻辑树节点 ID 列表（image_id, node_ids）。**注意：node_ids 必须列举该规则在逻辑树中经历的所有 decision 和 action 节点。**
|
||||
5. **precondition**: 规则生效的前置状态条件（开关状态、应用类型、应用前后台状态等）。可以是空对象 `{{}}` 如果无条件。
|
||||
6. **trigger**: 触发条件对象，包含：
|
||||
- `operator`: 条件组合方式，`"AND"` 或 `"OR"`
|
||||
- `conditions`: 条件数组，每个条件必须有 `signal`（信号名）、`operator`（比较运算符）、`value`（数值或字符串）。如果有单位，加 `unit` 字段。
|
||||
如果触发器是瞬时事件（如用户点击），使用 `event` 字段代替 `conditions`。
|
||||
7. **actions**: 每个动作必须有 `type`（`"system"` 或 `"user_interaction"`）和 `description`。用户可见交互（Toast、弹窗、语音播报）必须用 `"user_interaction"` 类型，并包含 `content` 字段。
|
||||
|
||||
## Few-shot 示例
|
||||
|
||||
### 示例 1：行车娱乐限制（前台打断）
|
||||
|
||||
**输入上下文**：开关开启，系统限制类应用在前台，车速≥15km/h且持续>5秒且非P档时，打断应用并显示Toast。
|
||||
|
||||
**期望输出**：
|
||||
|
||||
```json
|
||||
{{
|
||||
"rule_id": "FU-001-SYS-01",
|
||||
"description": "开关开启时，系统限制类应用在前台，当车速≥15km/h且持续超过5秒且非P档时，系统打断应用前台进程、将应用调入后台，并弹出Toast提示'在行车状态下无法使用该应用'",
|
||||
"priority": "P0",
|
||||
"sources": [
|
||||
{{"type": "table", "section": "3.1.1", "row": 2, "text_snippet": "行车娱乐限制：目标应用/功能处于前台时 ○ 打断：车速≥15km/h且持续5秒后..."}},
|
||||
{{"type": "logic_tree", "image_id": "rId16", "node_ids": ["n2", "n8", "n9", "n11", "n13", "n19", "n21", "n23", "n25", "n26"]}}
|
||||
],
|
||||
"precondition": {{
|
||||
"switch": "开启",
|
||||
"app_type": "系统限制",
|
||||
"app_state": "前台"
|
||||
}},
|
||||
"trigger": {{
|
||||
"operator": "AND",
|
||||
"conditions": [
|
||||
{{"signal": "车速", "operator": ">=", "value": 15, "unit": "km/h"}},
|
||||
{{"signal": "车速_持续时间", "operator": ">", "value": 5, "unit": "秒"}},
|
||||
{{"signal": "档位", "operator": "!=", "value": "P"}}
|
||||
]
|
||||
}},
|
||||
"actions": [
|
||||
{{"type": "system", "description": "打断应用前台进程"}},
|
||||
{{"type": "system", "description": "将应用调入后台"}},
|
||||
{{"type": "user_interaction", "description": "显示Toast", "content": "在行车状态下无法使用该应用"}}
|
||||
]
|
||||
}}
|
||||
```
|
||||
|
||||
### 示例 2：行车娱乐禁止（后台启动拦截）
|
||||
|
||||
**输入上下文**：开关开启，应用在后台且非前台，非P档时阻止应用启动，并提示。
|
||||
|
||||
**期望输出**：
|
||||
|
||||
```json
|
||||
{{
|
||||
"rule_id": "FU-002-SYS-01",
|
||||
"description": "开关开启时，目标应用处于后台，当档位非P档时，限制应用启动，并弹出Toast提示'请在P挡时使用该功能/应用'",
|
||||
"priority": "P0",
|
||||
"sources": [
|
||||
{{"type": "table", "section": "3.1.1", "row": 2, "text_snippet": "行车娱乐禁止：目标应用/功能处于后台时 ○ 限制：非P挡时，限制目标应用/功能启用..."}},
|
||||
{{"type": "logic_tree", "image_id": "rId17", "node_ids": ["n5", "n6"]}}
|
||||
],
|
||||
"precondition": {{
|
||||
"switch": "开启",
|
||||
"app_state": "后台"
|
||||
}},
|
||||
"trigger": {{
|
||||
"operator": "AND",
|
||||
"conditions": [
|
||||
{{"signal": "应用请求启动", "operator": "==", "value": true}}
|
||||
]
|
||||
}},
|
||||
"actions": [
|
||||
{{"type": "system", "description": "限制应用/功能启用"}},
|
||||
{{"type": "user_interaction", "description": "显示Toast", "content": "请在P挡时使用该功能/应用"}}
|
||||
]
|
||||
}}
|
||||
```
|
||||
|
||||
## 关键要求
|
||||
|
||||
1. **信号和数值必须精确**：不要写"车速超过阈值"，必须写 `"车速 >= 15 km/h"`。
|
||||
2. **条件必须完整**：如果文档说"车速≥15km/h 且持续超过5秒 且非P档"，这三个条件必须全部出现在 trigger.conditions 中。
|
||||
3. **逻辑树节点必须追踪**：在 sources 中列出该规则在逻辑树中经历的所有 decision 节点和 action 节点。这样做是为了后续审计（检查逻辑树覆盖率）。
|
||||
4. **优先图片逻辑树**：如果文字和图片存在矛盾，优先采用逻辑树中的路径，但保留文字作为补充参考（将两者都列入 sources）。
|
||||
5. **动作类型区分**：系统行为（打断进程、限制启动）用 `"system"`，用户可见交互（Toast、弹窗、语音）用 `"user_interaction"`。
|
||||
6. **多条规则**：如果一个功能单元包含多个独立的行为分支（如正常情况+异常情况），输出多条规则分别描述。规则之间通过 precondition 或 trigger 的条件值来区分。
|
||||
7. **开关关闭状态**：如果功能单元涉及开关，也要考虑开关关闭时的行为。开关关闭时所有限制失效，这也是一条规则。
|
||||
|
||||
## 输出格式
|
||||
|
||||
**只输出 JSON 数组，不要有任何其他文字或 markdown 标记**：
|
||||
|
||||
[
|
||||
{{ ... }},
|
||||
{{ ... }}
|
||||
]
|
||||
|
||||
注意：即使只有一个规则，也必须用数组格式 `[...]`。
|
||||
Reference in New Issue
Block a user