# eai-agent

**Repository Path**: eai-code/eai-agent

## Basic Information

- **Project Name**: eai-agent
- **Description**: eai-code 生态的"角色层":agent 人格定义 + 专属经验 memory，让 PM 调度的 agent 越用越聪明
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-25
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# eai-agent

> **eai-code 生态的"角色层":agent 人格定义 + 专属经验 memory,让 PM 调度的 agent 越用越聪明**

[![status](https://img.shields.io/badge/status-v0.1%20首批上线-blue)](./agents/) [![license](https://img.shields.io/badge/license-Apache--2.0-green)](LICENSE) [![ecosystem](https://img.shields.io/badge/eai--code-ecosystem-orange)](https://gitee.com/eai-code)

---

## 1. 定位

eai-agent 集中存储所有 agent 的人格定义 + 专属经验 memory。**PM 调度的不是"新 agent 扮演角色",而是"持久化人格 + 经验的具体 agent"**。

**AI 时代,agent 价值不在一次性调用,而在持久化的领域经验积累。**

## 2. 四仓库分工

| 仓库 | 层 | 内容 | 类比 |
|---|---|---|---|
| **eai-coordination** | 框架层 | G0-G4 铁律 + .ai/ 结构 + 编排流程 + 双常驻机制 | 校规 |
| **eai-coder** | 工具层 | MCP server + RAG 引擎 + 工具链 + 项目实战 | 教务处 |
| **eai-agent** | **角色层** | **agent 人格定义 + 专属经验 memory** | **老师** |
| **eai-frontend** | 知识层 | 领域方法论 RAG 库 | 教科书 |

## 3. 结构

```
eai-agent/
├── README.md                       本文件
├── agents/                         agent 人格定义(Claude Code .claude/agents/ 格式)
│   ├── pm.md                       项目经理(框架级常驻)
│   ├── knowledge-extraction-agent.md   经验沉淀 agent(框架级常驻)
│   ├── imu-engineer.md             IMU 细分专家(领域 on-demand)
│   └── ...                         后续填充更多领域 agent
├── memory/                         agent 专属经验(细分,每 agent 独立,不交叉)
│   ├── imu-engineer/
│   │   ├── MEMORY.md
│   │   ├── feedback_*.md           行为反馈(用户纠正)
│   │   ├── pitfalls_*.md           撞坑清单
│   │   └── project_*.md            项目经验
│   ├── knowledge-extraction-agent/
│   └── pm/
├── activations/
│   └── registry.yml                agent 注册表(resident / on-demand)
└── index.yml                       RAG 索引(by_role / by_domain)
```

## 4. "越用越聪明"机制

```
agent 完成任务 → 经验写回 memory/<agent-name>/(撞坑 / 调参 / 行为反馈)
        ↓
下次同类任务,PM 调度同一 agent → 自带经验 → 真正老道(不是靠 prompt 重新教)
        ↓
跨项目共享:项目 A 的 imu-engineer 经验,项目 B 也能用
```

**细分原则**:每 agent 专属 memory 目录,**不交叉**(避免噪音)。agent 知识来源明确:
- eai-frontend entries(领域通用方法论)
- 自己 memory(专属经验)
- eai-coder META(工程规则)

## 5. 已上线 agent

### v0.1 首批(2026-07-24,3 agent)

| Agent | 类型 | 状态 | 知识来源 |
|---|---|---|---|
| **pm** | resident(框架级常驻) | ✅ 定义就位 | eai-coordination 铁律 + 自己 memory |
| **knowledge-extraction-agent** | resident(框架级常驻) | ✅ 定义就位(激活待框架升级) | 脱敏规则 + 分类策略(待填充) |
| **imu-engineer** | on-demand(领域) | ✅ 定义 + memory 首填充 | eai-frontend METH-001~004/DEC-001/ANTI-001/PAT-001 + 自己 memory + META-009/010/011 |

### v0.2 增量(2026-07-25,三层沉淀第二次)

| Agent | 类型 | 状态 | 知识来源 |
|---|---|---|---|
| **visualization-engineer** | on-demand(领域) | ✅ 定义 + memory 首填充 | eai-frontend PAT-002/DEC-002/ANTI-002/PAT-003 + 自己 memory + META-012-BUILD |

> v0.2 是 eai-code 生态第二次三层沉淀(首次是 imu-engineer,从 eai-wand P4 滤波研究沉淀)。
> 两次沉淀互为对照验证,确认三层架构(知识层 / 经验层 / 角色层)对**不同领域**都适用。

## 6. 使用方式

### 项目接入 eai-agent

```bash
# 方式 1: clone 到项目(Claude Code 自动扫描 .claude/agents/)
cd <project>
git clone https://gitee.com/eai-code/eai-agent.git /tmp/eai-agent
cp /tmp/eai-agent/agents/*.md .claude/agents/   # 选需要的 agent

# 方式 2: 直接用 agent 定义(不需要 git clone)
# 复制 agents/<name>.md 到项目 .claude/agents/
```

### 新增 agent(贡献流程)

1. 在 `agents/` 加 `<name>.md`(Claude Code agent 格式:frontmatter + system prompt)
2. 在 `memory/<name>/` 加 `MEMORY.md`(索引)+ 初始经验文件
3. 更新 `activations/registry.yml` + `index.yml`
4. PR 到 upstream(eai-code 组织审核)

## 7. agent 定义格式(Claude Code 兼容)

```markdown
---
name: <agent-name>
description: <一句话角色描述,PM 调度时识别用>
tools: Read, Write, Edit, Bash, Grep, Glob    # 或继承
model: sonnet    # 或继承
---

# <角色名>(<agent-name>)

## 角色定位
...

## 领域知识
- 参考 eai-frontend/entries/...(领域方法论)
- 参考 memory/<agent-name>/...(自己踩过的坑)

## 行为规范
- <必问问题>
- <默认决策>
- <反例识别>

## 工作流程
...
```

## 8. 关联

- [eai-coordination](https://gitee.com/eai-code/eai-coordination) —— 框架本体(G0-G4 铁律)
- [eai-coder](https://gitee.com/eai-code/eai-coder) —— AI 编码工具(MCP + RAG)
- [eai-frontend](https://gitee.com/eai-code/eai-frontend) —— 知识层(领域方法论)

## 9. 演进计划

| 版本 | 内容 |
|---|---|
| v0.1 | 首批 3 agent(pm + knowledge-extraction + imu-engineer) + memory 首填充(2026-07-24) |
| **v0.2(当前)** | **加 visualization-engineer(2026-07-25,从 eai-wand P3 可视化实战沉淀;三层沉淀第二次,跟 imu-engineer 形成对照验证)** |
| v0.3 | 加 board-validation-engineer / peripheral-driver-engineer(从 eai-wand 实战提炼) |
| v0.4 | 加 business-logic-engineer |
| v0.5 | agent memory 脱敏机制(支持公开共享)+ 跨项目共享验证 |

## 10. License

Apache-2.0(与 eai-code 生态一致)