# mat-aise-kernel

**Repository Path**: mat-cloud/mat-aise-kernel

## Basic Information

- **Project Name**: mat-aise-kernel
- **Description**: 基于AI的软件工程体系的能力库、知识库，由mat-aise-starter分发至AI IDE，提供规则、技能、战术手册等核心工程要素。


- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-23
- **Last Updated**: 2026-07-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# mat-aise-kernel — AI 软件工程体系内核

跨项目共享的 AI 辅助软件工程体系基础设施。包含规则、技能、手册三要素，
通过 git submodule 被各业务项目引用，实现工程能力的统一版本管理和跨项目复用。

## 目录结构

```
mat-aise-kernel/
├── rules/           # 工程规则（骨架 — 硬约束）
├── skills/          # 工程技能（肌肉 — 执行能力）
├── playbook/        # 工程手册（记忆 — 做法指引）
├── templates/
│   └── AGENTS-template.md   # AGENTS.md 初始化模板
├── platforms/       # 平台适配层
│   └── trae/
│       └── rules/
└── README.md
```

## 分支策略

| 分支 | 用途 | 说明 |
|------|------|------|
| `master` | 主干基线 | **受保护，禁止直接提交**。仅通过 PR 合入 |
| `feature-0.3.0` | 版本分支 | 基于 `v0.3.0` tag 创建，项目 submodule 跟踪此分支以获取该版本的补丁更新 |
| `proj_xxx` | 项目定制分支 | 各项目 fork 后可创建项目特有分支（如 `proj_uds`、`proj_hr`），基于版本分支进行项目级定制 |

> 内核升级走 PR → 合入 master → 打 tag → 同步到版本分支的流程。项目通过 submodule 跟踪版本分支获取更新，通过项目定制分支保留自身差异化配置。

## 在项目中使用

### 1. 添加子模块（跟踪版本分支）

```bash
git submodule add -b feature-0.3.0 https://gitee.com/mat-cloud/mat-aise-kernel.git .agents
```

### 2. 初始化 AGENTS.md

调用 `pm` 技能执行项目初始化，或手动从模板生成：

```bash
cp .agents/templates/AGENTS-template.md AGENTS.md
```

然后编辑 `AGENTS.md`，将 `{{PROJECT_NAME}}` 和 `{{TECH_STACK}}` 替换为实际项目值。

### 3. 配置平台适配层

根据使用的 AI 编程平台，从 `platforms/` 复制对应适配层到项目：

```bash
# Trae 平台
cp .agents/platforms/trae/rules/* .trae/rules/
```

### 4. 更新内核

```bash
cd .agents
git pull origin feature-0.3.0
cd ..
git add .agents
git commit -m "chore: 更新 AISE 内核 feature-0.3.0"
```

## 贡献指南

内核是共享基础设施，修改流程如下：

1. Fork 本仓库
2. 在 fork 中基于版本分支（如 `feature-0.3.0`）创建特性分支
3. 修改规则/技能/手册
4. 提交 PR 到本仓库对应版本分支
5. 合入后，各项目 `git submodule update` 即可同步

**重要**：修改规则、技能定义（SKILL.md）、手册模板前，
请先在项目端触发 `bootstrap` 技能进行评审。

## 版本策略

- `master` 分支受保护，仅通过 PR 合入
- 每次发布打对应 tag（如 `v0.3.0`），并创建同名版本分支（如 `feature-0.3.0`）供项目跟踪
- 项目的 submodule 可锁定到版本分支获取持续补丁，也可锁定到 tag 完全冻结版本
- 项目特有定制走 `proj_xxx` 命名分支，不污染版本分支