wurenzhi
2b86715c09
- 移除未使用的TabPane组件 - 修复类型定义和导入方式 - 优化mock数据源的环境变量判断逻辑 - 更新文档结构并归档旧文件 - 添加新的UI组件和Memo组件 - 调整API路径和响应处理
153 lines
3.1 KiB
Markdown
153 lines
3.1 KiB
Markdown
# AI协作规则
|
||
|
||
> **入口**: [_index.md](_index.md)
|
||
|
||
---
|
||
|
||
## 1. 角色定位
|
||
|
||
| 角色 | 职责 |
|
||
|------|------|
|
||
| **Brain** | 全局调度与决策 |
|
||
| **Agent** | 原子任务包闭环开发 |
|
||
|
||
---
|
||
|
||
## 2. 任务包领取
|
||
|
||
### 2.1 核心原则
|
||
|
||
```
|
||
任务包 = 同一闭环的连续任务 + 依赖链完整 + 文件归属明确
|
||
```
|
||
|
||
### 2.2 领取规则
|
||
|
||
| 规则 | 说明 |
|
||
|------|------|
|
||
| **优先领取任务包** | 必须优先领取同一闭环的完整任务链 |
|
||
| **最小粒度** | 单次领取不少于 2 个相关任务 |
|
||
| **依赖自包含** | 领取的任务包内依赖必须闭环 |
|
||
|
||
### 2.3 任务包类型
|
||
|
||
| 类型 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| 🔗 闭环包 | 同一业务闭环的全部任务 | BE-P001 + BE-P002 + BE-P003 |
|
||
| 📦 模块包 | 同一模块的连续任务 | FE-P001 + FE-P002 + FE-P003 |
|
||
| 🔗 依赖链包 | 有依赖关系的任务链 | BE-P001 → BE-P002 → BE-P003 |
|
||
|
||
---
|
||
|
||
## 3. 协作防撞车
|
||
|
||
### 3.1 占用声明
|
||
|
||
领取任务时，必须同时声明：
|
||
|
||
1. 占用的模块/闭环名称
|
||
2. 涉及的主要文件路径
|
||
3. 预计完成时间
|
||
|
||
### 3.2 占用状态模板
|
||
|
||
```markdown
|
||
## 🔒 当前任务占用状态
|
||
|
||
| Agent | 占用模块 | 涉及任务 | 主要文件 | 开始时间 | 状态 |
|
||
|-------|----------|----------|----------|----------|------|
|
||
| AI-Backend-1 | 商品闭环 | BE-P001~003 | ProductService.ts | 2026-03-22 10:00 | 🔒 进行中 |
|
||
```
|
||
|
||
### 3.3 冲突处理
|
||
|
||
| 优先级 | 规则 |
|
||
|--------|------|
|
||
| 1 | 先声明者优先 |
|
||
| 2 | 后到者避让 |
|
||
| 3 | 争议由 Brain 协调 |
|
||
|
||
---
|
||
|
||
## 4. 执行原则
|
||
|
||
### 4.1 一次性分发
|
||
|
||
每轮下发完整任务包（P0/P1/P2）
|
||
|
||
### 4.2 连续执行
|
||
|
||
任务包内连续执行到"完成或明确阻塞"
|
||
|
||
### 4.3 文件占用锁
|
||
|
||
- 同目录协作先声明归属
|
||
- "谁领取谁编辑"
|
||
- 后写入方必须先 Read 最新内容，增量合并
|
||
|
||
---
|
||
|
||
## 5. 自省要求
|
||
|
||
Agent 必须在以下阶段上报"自我问题"：
|
||
|
||
1. 对话开始时
|
||
2. 执行过程中
|
||
3. 交付前
|
||
|
||
---
|
||
|
||
## 6. 禁止行为
|
||
|
||
| 行为 | 说明 |
|
||
|------|------|
|
||
| ❌ 单独领取任务包内的部分任务 | 必须领取完整任务包 |
|
||
| ❌ 不声明占用直接开始开发 | 必须先声明 |
|
||
| ❌ 跨模块同时占用多个任务包 | 一次只占一个模块 |
|
||
| ❌ 占用超过 24 小时未释放 | 及时释放占用 |
|
||
|
||
---
|
||
|
||
## 7. 任务ID格式
|
||
|
||
### 7.1 格式定义
|
||
|
||
```
|
||
[模块]-[子模块][序号]
|
||
```
|
||
|
||
### 7.2 模块代码
|
||
|
||
| 代码 | 含义 |
|
||
|------|------|
|
||
| **FE** | Frontend (前端) |
|
||
| **BE** | Backend (后端) |
|
||
| **PL** | Plugin (插件) |
|
||
| **AI** | AI (人工智能) |
|
||
| **DT** | Data (数据) |
|
||
| **OP** | Operation (运维) |
|
||
|
||
### 7.3 子模块代码
|
||
|
||
| 代码 | 含义 |
|
||
|------|------|
|
||
| **P** | Product (商品) |
|
||
| **O** | Order (订单) |
|
||
| **F** | Finance (财务) |
|
||
| **I** | Inventory (库存) |
|
||
| **C** | Collection (采集) |
|
||
| **A** | Advertisement (广告) |
|
||
|
||
### 7.4 示例
|
||
|
||
```
|
||
FE-P001 → 前端商品模块任务001
|
||
BE-O005 → 后端订单模块任务005
|
||
PL-C002 → 插件采集模块任务002
|
||
AI-A001 → AI广告模块任务001
|
||
```
|
||
|
||
---
|
||
|
||
*最后更新: 2026-03-22*
|