# ai-experience

**Repository Path**: rr84/ai-experience

## Basic Information

- **Project Name**: ai-experience
- **Description**: 积攒使用ai的经验,在每个项目中默认触发
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-04
- **Last Updated**: 2026-05-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI Experience

通用经验管理框架。将开发过程中的教训转化为结构化规则文件，由 AI 按需加载执行。

## 快速开始

### 作为项目引入

```bash
# 在目标项目中添加 submodule
git submodule add <repo-url> .ai-experience

# 进入框架目录，创建项目分支
cd .ai-experience
git checkout -b <project-name>
```

### 配置全局层（可选）

```bash
mkdir -p ~/.ai-experience/rules/personal
```

全局层的个人偏好规则跨项目生效，优先级低于项目规则。

### 开始使用

- `/add-experience` — 录入新经验
- `/review-experiences` — 审视已有经验
- 运行 `build.ps1` 或 `build.sh` 生成平台文件

## 平台支持

| 平台 | 加载方式 |
|------|---------|
| Claude Code | SKILL.md 动态按需加载 |
| Cursor | build 脚本拼接 → .cursorrules |
| Codex/Copilot | build 脚本拼接 → .github/copilot-instructions.md |

## 项目结构

```
.
├── README.md
├── LICENSE (MIT)
├── TEMPLATE.md                        ← 经验录入模板
├── INDEX.md                           ← 经验索引（AI 先读这个）
├── .claude/skills/
│   ├── add-experience/SKILL.md        ← /add-experience 录入经验
│   └── review-experiences/SKILL.md    ← /review-experiences 审视经验
├── rules/
│   ├── core.md                        ← 核心规则（始终加载，待填充）
│   └── project/                       ← 项目经验（团队共享）
│       ├── dev-workflow.md            ← 规划、文档、版本检查、Git 推送
│       ├── ai-interaction.md          ← AI 交互习惯
│       ├── frontend-rules.md          ← 前端规范
│       └── tool-habits.md             ← 工具使用习惯
├── platforms/
│   ├── build.ps1
│   └── build.sh
├── .gitignore
└── 过程文件/                          ← 设计文档、原始素材
```

## 已有经验（11 条规则，4 个文件）

| 文件 | 内容 |
|---|---|
| `dev-workflow.md` | 提前规划思路、管理过程文档、开发后检查版本完整度、Git 推送前验证 |
| `ai-interaction.md` | 主动输入完整 skill 名、上下文中毒开新会话、AI 代码逐步审查、先对齐思路再查资料 |
| `frontend-rules.md` | 前端以展示数据为本、联调禁止前端造假数据 |
| `tool-habits.md` | 优先本地工具，减少平台切换 |

## 命令

- `/add-experience` — 录入新经验，AI 翻译为结构化规则，逐条确认后写入
- `/review-experiences` — 审视已有经验，检查冲突、过期、一致性

## 分层加载

1. **Core 规则** — 始终加载（上限 10 条，标准：高频 + 高代价 + 跨分类 + 行为层）
2. **项目经验** — 按触发词 + 工具 + 任务类型按需匹配
3. **全局层** `~/.ai-experience/rules/personal/` — 个人偏好，跨项目生效

匹配宁可漏掉也不全量加载。项目经验覆盖全局同名规则。

## 经验文件格式

```yaml
---
触发: [关键词1, 关键词2]
工具: [工具名, 或 "通用"]
任务: [调试|开发|审查|部署|通用]
类型: [core|分类名]
添加日期: YYYY-MM-DD
---
### 规则标题

祈使句正文，说明该做什么或不该做什么。

**案例**
（选填）触发该规则的真实场景。
```

## 维护原则

- 分类文件不存在时自动创建，同步更新 INDEX.md
- INDEX.md 与文件 frontmatter 不一致时以文件为准
- 冲突或重复时提醒用户裁决
- 经验系统自身就是验证机制：冲突则调整，不冲突则有效

## 许可证

MIT License — 详见 LICENSE

## 升级

```bash
cd .ai-experience
git fetch origin
git rebase origin/main
```