cloud
55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
---
|
||
name: edge-business-rule-extractor
|
||
description: edge_collector 业务与技术规则提取规范。用于从用户需求、讨论、故障复盘和实现方案中提取稳定规则，维护云边采集、上传策略、动态配置保护、权限、前端交互、部署同步和协议模板等项目规则。
|
||
---
|
||
|
||
# edge_collector 规则提取
|
||
|
||
## 适用场景
|
||
|
||
- 用户反复强调某个约束。
|
||
- 某个事故暴露出需要长期遵守的规则。
|
||
- 方案中出现“必须、不能、只允许、默认、除非明确要求”等表述。
|
||
- 需要把对话中的口头规范沉淀到文档或 skill。
|
||
|
||
## 规则类型
|
||
|
||
- `BR-COLLECT`：采集与上传规则。
|
||
- `BR-CONFIG`：配置和动态文件保护规则。
|
||
- `BR-DEPLOY`：打包、同步、部署规则。
|
||
- `BR-UI`：前端交互和用户可见文案规则。
|
||
- `BR-PERM`：权限和安全规则。
|
||
- `BR-PROTOCOL`：协议模板和驱动规则。
|
||
- `BR-AI`：AI 分析和模型配置规则。
|
||
|
||
## 当前项目典型规则
|
||
|
||
- 相同数据不上传，5 分钟强制上传；短时间点位不连续可能是正常现象。
|
||
- 打包或同步不能携带目标主机运行态动态配置。
|
||
- 同主机编译部署也要使用 `scripts/migrate_edge.sh`。
|
||
- `install_all.sh` 只有用户明确要求时才执行。
|
||
- 用户可见协议介绍不透露 helper、SDK、库路径等技术细节。
|
||
- AI 分析报告不展示内部 AI 配置名、Provider 名称或模型细节。
|
||
|
||
## 输出格式
|
||
|
||
```markdown
|
||
| 编号 | 类型 | 规则 | 来源 | 影响范围 | 验证方式 |
|
||
|------|------|------|------|----------|----------|
|
||
| BR-DEPLOY-001 | 部署 | ... | 用户确认 | package/sync | ... |
|
||
```
|
||
|
||
## 执行流程
|
||
|
||
1. 从需求、对话或文档中提取候选规则。
|
||
2. 去重，避免把同一规则写成多个版本。
|
||
3. 判断规则是否长期有效，临时现场处理不沉淀为规则。
|
||
4. 写明影响范围和验证方式。
|
||
5. 如需落盘，优先更新 `docs/` 下已有规则/概览文档；没有则建议新增规则表。
|
||
|
||
## 注意
|
||
|
||
- 不把猜测写成规则。
|
||
- 不把一次性临时命令写成规则。
|
||
- 规则变更会影响部署或运行安全时，先让用户确认。
|