# 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-09-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# eai-agent

> **eai-code 生态的全局 agent 公共池（RAG）**：受控标签 DAG + 自演化角色卡 + 专属经验 memory，让 PM 调度的 agent 越用越聪明。

[![status](https://img.shields.io/badge/status-pool%20v2-blue)](./pool/) [![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 是全局公共池数据源：**PM 派发前先检索本池，命中则带卡派发，未命中则按建卡协议建卡**。agent 价值随经验积累持续增值，而非一次性调用。

设计规格（唯一权威）：`docs/design/rag-pool-redesign.md`。

## 2. 目录结构

| 路径 | 内容 |
| --- | --- |
| `pool/` | 角色卡单池（schema v2，front-matter 限定子集）——domain-expert 与 process-role 同池 |
| `taxonomy.yml` | 受控标签词表（多维 DAG，多父允许；节点 id kebab-case，路径用点号连���） |
| `scripts/` | `build-index.mjs`（校验+建索引）/ `query.mjs`（检索）/ `lib.mjs`（解析+打分）/ `lib.test.mjs`（node:test） |
| `agents-index.json` | 构建产物（build-index 生成，入库保证克隆即可检索） |
| `memory/` | 各 agent 专属经验（`<id>/MEMORY.md` 为索引页，`<id>/*.md` 为记忆条目） |
| `docs/design/` | 设计文档 |

## 3. PM 派发前必跑（检索三档）

```bash
node scripts/query.mjs "任务描述关键词"          # exit 0=命中（带 top 卡派发）
node scripts/query.mjs --json "任务描述"         # JSON 输出（程序化用）
# exit 2 = 缺口信号（top 分 < threshold）→ suggest_create → 走建卡协议
```

- **命中**：任务卡直接附 top 卡（pool/<id>.md 全文）派发。
- **缺口**：PM 起草新卡（taxonomy 可申请新节点 / **≥3 keywords** / summary ≤80 字禁万金油 / scope.do·dont 必写）→ `node scripts/build-index.mjs` 校验入库 → 派发（`first_mission: pending`），首任务后 PM 复核转 `done`。

## 4. 退单队列（防呆：两次即触发）

子 agent scope 自查不符 → `{verdict:"out-of-scope", reason, suggest_keywords, suggest_agent?, suggest_new_agent?}`：

1. PM 收退单 → 任务携反馈**入队尾**，FIFO 逐个出队重组再派；
2. 再退单 → 再入队尾（反馈累加）；
3. **同任务累计退单 ≥2 次 → 不再入队**，PM 拆解自办或上报用户。

## 5. 自学习三层

1. **memory/**：子 agent 把本次经验写进自己的 `memory/<id>/`（PM 收口时归档）；
2. **卡自升级**：基于经验修正自己的卡（claim_keywords / scope / version+1），**只准改自己的卡**；
3. **普适教训升全局 META**：跨项目规则进 `C:\.ai_global\meta`（META-NNNN）。

## 6. 维护纪律

- 任何建卡/改卡/改 taxonomy 之后**必须跑** `node scripts/build-index.mjs`（校验失败会列出全部错误，exit 1）；
- 改动后跑 `node --test scripts/lib.test.mjs` 保持全绿；
- taxonomy 演化四动作：**诞生**（note 记 who/why/date）/ **繁荣**（build stats 报分布）/ **剔除**（`status: deprecated` + redirect，不物理删）/ **合并**（redirect 多目标）；
- 卡的 `summary` 禁含「通用/杂项/万能/all-in-one」——单池不收万金油卡。

## 7. 全新机器 bootstrap

配合 pi-ai-coordination 框架的 `scripts/init-global.mjs`：检测 `C:\.ai_global` 缺失时自动创建目录架构并克隆本仓库（`agents/`）与 meta 仓库（`meta/`）作为公共池数据源；已存在则 `git pull` 幂等更新。凭据从 `personal_token.yml` 静默读取，全程掩码。