自动化实现总览

# 自动化实现总览

> **版本**: v1.0.0 | **更新日期**: 2026-03-10 | **维护人**: 未来鸟FutureBird码巢企业服务引擎开发组

---

## 一、Git Hooks 自动化

### pre-commit（提交前检查）

**触发时机**：`git commit` 前

**执行流程**：
```bash
git commit
    ↓
&#128737;️ 红线检测 (pnpm redline:check)
    ↓ (失败则阻止提交)
&#128221; lint-staged (代码格式化)
    ↓
&#128269; TypeScript 类型检查 (pnpm type-check)
    ↓
&#129514; 单元测试 (pnpm test:unit)
    ↓ (全部通过)
✅ 允许提交
```

**配置文件**：`.husky/pre-commit`

---

### post-commit（提交后自动化）

**触发时机**：`git commit` 后

**执行流程**：
```bash
git commit 完成
    ↓
&#129504; 自动记忆 → 记录到项目记忆系统
    ↓
&#128218; 知识库同步 → 同步到向量知识库
    ↓
&#128203; 待发布累积 → 添加到 PENDING_CHANGES
    ↓
&#128228; 自动推送 → git push origin
    ↓
&#128295; 错误学习 → fix: 提交触发错误模式学习
    ↓
&#128221; 决策追溯 → decision: 提交触发决策记录
    ↓
&#128260; 自动提交 → hook 产生的文件变更自动提交
```

**特殊处理**：
- `[auto]` 标记的提交自动跳过 hook 任务，避免无限循环
- 自动推送需要配置 Git 凭据

**配置文件**：`.husky/post-commit`

---

## 二、CI/CD (GitHub Actions)

### 文档质量检查

**配置文件**：`.github/workflows/doc-quality-check.yml`

**触发条件**：
- push 到 main/master/develop 分支，且修改了 `docs/**/*.md`
- PR 到 main/master/develop 分支
- 手动触发

**检查项目**：

| Job | 功能 |
|-----|------|
| check-docs-quality | 运行文档质量检查脚本 |
| check-docs-index | 检查每个目录是否有 README.md 索引 |
| check-large-docs | 检查超大文档（>50KB）并提示拆分 |

---

## 三、项目记忆加载器

**配置文件**：`docs/skills/project-memory-loader/SKILL.md`

### 自动触发规则

| 场景 | 触发条件 |
|------|---------|
| 新会话开始 | AI 自动检测 |
| 用户说"继续"或"开始" | 关键词触发 |
| 用户提出开发需求 | 开发前自动加载 |

### 会话启动检查清单

```
□ 1. 检查 Git Hooks
     ls -la .husky/pre-commit .husky/post-commit
     缺失 → bash scripts/session-start-check.sh

□ 2. 检查定时任务（PM2）
     npx pm2 list | grep memory-maintenance

□ 3. 检查服务状态
     curl -s http://localhost:5000/api/health

□ 4. 加载项目上下文
     调用 /api/project-memory/context

□ 5. 输出项目状态概览
     项目信息、分区表架构、TODO、红线
```

### 加载内容

```
项目记忆加载
├── 项目概览
├── 分区表架构
├── 红线规则
├── TODO 列表
└── 高优先级信息
```

---

## 四、自动化脚本体系

### 构建部署类

| 脚本 | 功能 |
|------|------|
| `build.sh` | 标准构建 |
| `build-prod.sh` | 生产环境构建 |
| `build-verify.sh` | 构建验证 |
| `deploy-production.sh` | 生产环境部署 |
| `deploy-quick.sh` | 快速部署 |
| `start.sh` | 启动服务 |

### 自动发布类

| 脚本 | 功能 |
|------|------|
| `auto-push.sh` | 自动推送代码 |
| `publish-all.sh` | 完整发布流程 |
| `release.ts` | 版本发布 |
| `push-quick.sh` | 快速推送 |

### 检查验证类

| 脚本 | 功能 |
|------|------|
| `pre-build-check.sh` | 构建前检查 |
| `post-build-check.sh` | 构建后检查 |
| `build-verify.sh` | 构建验证 |
| `test.sh` | 运行测试 |
| `test-api.sh` | API 测试 |
| `session-start-check.sh` | 会话启动检查 |

### 记忆同步类

| 脚本 | 功能 |
|------|------|
| `auto-memory.ts` | 自动记录记忆 |
| `memory-manager.ts` | 记忆管理 |
| `sync-memory.ts` | 记忆同步 |
| `backup-memory.ts` | 记忆备份 |

### 知识库类

| 脚本 | 功能 |
|------|------|
| `kb-smart-import.ts` | 智能导入知识库 |
| `import-docs-to-kb.ts` | 文档导入知识库 |
| `kb-manager.ts` | 知识库管理 |
| `knowledge-import.ts` | 知识导入 |

### 错误学习类

| 脚本 | 功能 |
|------|------|
| `learn-error.ts` | 错误模式学习 |
| `bug-record.js` | BUG 记录 |
| `bug-auto.js` | BUG 自动处理 |

### 红线检测类

| 脚本 | 功能 |
|------|------|
| `redline-check.ts` | 红线规则检测 |
| `precheck.ts` | 预检查 |

---

## 五、四大进化机制

### 1. 开发前预检

**实现**：project-memory-loader + session-start-check.sh

**效果**：自动加载项目上下文，避免重复犯错

```
新会话开始
    ↓
加载项目记忆
    ├── 项目概览
    ├── 红线规则
    └── 高优先级信息
    ↓
检查环境状态
    ├── Git Hooks
    ├── 定时任务
    └── 服务状态
    ↓
输出项目状态概览
```

---

### 2. 错误自动学习

**实现**：post-commit 检测 `fix:` 提交 → bug:record-fix

**触发条件**：提交信息以 `fix:` 或 `Fix:` 开头

**效果**：记录错误模式到知识库，下次自动识别

```bash
# fix 提交自动触发
git commit -m "fix: 修复分区表查询缺少 company_id"
    ↓
post-commit 检测到 fix: 前缀
    ↓
pnpm bug:record-fix --commit-hash xxx
    ↓
记录错误模式到知识库
```

---

### 3. 红线检测

**实现**：pre-commit → pnpm redline:check

**触发条件**：每次 `git commit` 前

**效果**：阻止违规代码提交

```
git commit
    ↓
红线检测 (redline-check.ts)
    ├── 检查分区表查询是否带 company_id
    ├── 检查是否使用硬编码颜色
    ├── 检查是否修改红线文件
    └── 其他规则...
    ↓
失败 → 阻止提交，输出错误信息
成功 → 继续提交流程
```

---

### 4. 决策追溯

**实现**：post-commit 检测 `decision:` 提交 → decision:record

**触发条件**：提交信息以 `decision:` 或 `Decision:` 开头

**效果**：记录关键决策原因，支持历史回溯

```bash
# decision 提交自动触发
git commit -m "decision: 使用 Drizzle ORM 替代原生 SQL"
    ↓
post-commit 检测到 decision: 前缀
    ↓
pnpm decision:record --title "xxx" --commit-hash xxx
    ↓
记录决策到知识库
```

---

## 六、自动化流程图

```
┌─────────────────────────────────────────────────────────────┐
│                      git commit                              │
│                         ↓                                    │
│                   pre-commit hook                            │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ &#128737;️ 红线检测 → &#128221; lint-staged → &#128269; 类型检查 → &#129514; 测试   │ │
│  └────────────────────────────────────────────────────────┘ │
│                         ↓ (全部通过)                         │
│                    commit 完成                               │
│                         ↓                                    │
│                   post-commit hook                           │
│  ┌────────────────────────────────────────────────────────┐ │
│  │ &#129504; 自动记忆 → &#128218; 知识库同步 → &#128203; 待发布 → &#128228; 自动推送   │ │
│  │ &#128295; 错误学习 (fix:) → &#128221; 决策追溯 (decision:)            │ │
│  └────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```

---

## 七、关键自动化命令

### 日常开发

```bash
# 类型检查
pnpm type-check

# 代码格式化
pnpm format

# 运行测试
pnpm test

# 构建验证
pnpm build:verify
```

### 红线与记忆

```bash
# 红线检测
pnpm redline:check

# 记忆同步
pnpm memory:sync

# 记忆备份
pnpm memory:backup
```

### 知识库

```bash
# 智能导入知识库
pnpm kb:import

# 搜索知识库
pnpm kb:search "关键词"
```

### BUG 与决策

```bash
# BUG 记录
pnpm bug:record-fix --commit-hash xxx --message "xxx"

# 决策记录
pnpm decision:record --title "xxx" --commit-hash xxx
```

---

## 八、配置文件索引

| 配置文件 | 位置 | 说明 |
|---------|------|------|
| Git Hooks | `.husky/pre-commit` | 提交前检查 |
| Git Hooks | `.husky/post-commit` | 提交后自动化 |
| CI/CD | `.github/workflows/doc-quality-check.yml` | 文档质量检查 |
| 记忆加载器 | `docs/skills/project-memory-loader/SKILL.md` | 项目记忆加载（替代原 AI-SYSTEM-PROMPT） |
| 自动化脚本 | `scripts/*.sh`, `scripts/*.ts` | 各类自动化脚本 |

---

## &#128279; 相关文档

- [AI进化机制](./AI进化机制.md) - 四大进化机制详解
- [AI执行规则](./AI执行规则.md) - 三条红线、快速检查表
- [项目记忆](../12-项目记忆/) - 记忆系统使用指南