# ai-meta

**Repository Path**: eai-code/ai-meta

## Basic Information

- **Project Name**: ai-meta
- **Description**: 全局 META 规则仓库 — 所有项目 META 规则集中于此，由 PA agent 自治分类入库、维护索引
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 全局 META 规则仓库

> 所有项目的 META 规则集中于此，由 **项目助理（PA）agent** 自治分类入库、维护索引。
> 全局仓库本身是 git 仓库，git push/pull 即跨设备同步。remote 决定池子性质：
> 指向 `gitee.com/eai-code/ai-meta` = 公共池（社区共享）；改成自己的私有仓库 = 私有池。

## 目录结构

```
C:/.ai_meta/
  README.md              # 本文件
  INDEX.md               # 人类可读导航（PA 自动重生成）
  meta-index.json        # 机器可读索引（meta-index.js 扫 rules/ 生成）
  rules/                 # 按 category 分目录
    ASYNC/
      META-NNN.md        # 每条规则独立文件
    SECURITY/
      META-NNN.md
    ...（共 12 个受控词表类别）
```

## CATEGORY 受控词表

`ASYNC | SECURITY | CONCURRENCY | DEPENDENCY | LAYERING | API_CONTRACT | DATA_INTEGRITY | ERROR_HANDLING | TESTING | PERFORMANCE | BUILD | STATE_MGMT`

## 规则入库协议（PA 执行）

1. 消费 `.ai/pa-inbox/MSG-*.md`（生产者 = 任何 agent）
2. 分类（meta-classify 复核 category）
3. 查重（meta-retriever，命中则 merge / supersede / skip）
4. 编号（全局 META-NNN 最大+1，含 git pull 防冲突）
5. 写入 `rules/<CATEGORY>/META-NNN.md`（每条独立文件）
6. 刷新 INDEX.md + meta-index.json
7. ACK = 删除 inbox 消息文件

## 单条规则文件格式（schema_version: 1）

见任一 `rules/<CAT>/META-*.md`。必填字段：
category / layer / applies_to / keywords / rule / semantic_summary。

## 向量 RAG（预留）

规则量达阈值（≥30）后，可对「规则 + 语义摘要」生成 embedding 写入单文件 embedding 字段，
meta-retriever.js 自动切换向量检索，格式向前兼容。