# mat-aise-kernel

**Repository Path**: mat-labs/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-24

## 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/           # Trae 规则适配
│   └── workbuddy/
│       ├── rules/           # WorkBuddy 规则适配
│       └── skills-bridge/   # WorkBuddy 技能桥接模板与生成脚本
└── 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/` 复制对应适配层到项目。
适配层包含两部分：**规则适配**（平台特有的规则文件）和**技能桥接**（让平台识别 `.agents/skills/` 下的技能）。

#### 3a. 规则适配

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

# WorkBuddy 平台
cp .agents/platforms/workbuddy/rules/* .workbuddy/rules/
```

#### 3b. 技能桥接（WorkBuddy）

WorkBuddy 原生只识别 `.workbuddy/skills/` 目录下的技能，不自动扫描 `.agents/skills/`。
为保持 `.agents/skills/` 作为跨平台唯一事实源，采用**桥接指针**方案——
在 `.workbuddy/skills/` 下为每个技能创建极简 SKILL.md，内容仅指向 `.agents/skills/` 的真实定义。

**手动创建**（单个技能）：

```bash
# 为 pm 技能创建桥接
mkdir -p .workbuddy/skills/pm
cat > .workbuddy/skills/pm/SKILL.md << 'EOF'
---
name: "pm"
description: "{从 .agents/skills/pm/SKILL.md 复制 description}"
---

## 桥接指针

本文件是 `.agents/skills/pm/SKILL.md` 的桥接指针。

**执行指令**：读取项目根目录下 `.agents/skills/pm/SKILL.md` 的完整内容，
严格按照其中的流程、模式和约束执行。
`.agents/skills/` 是唯一事实源，本文件不含任何执行逻辑。
EOF
```

**批量生成**（推荐）：

```bash
# 使用内核提供的生成脚本，自动扫描 .agents/skills/ 并生成所有桥接文件
bash .agents/platforms/workbuddy/skills-bridge/generate-bridges.sh
```

> 桥接文件不包含任何执行逻辑，仅作为指针。技能新增或 description 变更时，
> 重新运行生成脚本即可同步。

### 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` 命名分支，不污染版本分支