Files
makemd/docs/RULES/collaboration.md
wurenzhi 2b86715c09 refactor: 优化代码结构并修复类型问题
- 移除未使用的TabPane组件
- 修复类型定义和导入方式
- 优化mock数据源的环境变量判断逻辑
- 更新文档结构并归档旧文件
- 添加新的UI组件和Memo组件
- 调整API路径和响应处理
2026-03-23 12:41:35 +08:00

3.1 KiB
Raw Blame History

AI协作规则

入口: _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 占用状态模板

## 🔒 当前任务占用状态

| 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