# 基因胶囊规范 · 卡若AI 抽象概念

> **版本**：1.0 | 更新：2026-02-22  
> **归属**：土砖（技能复制）  
> **理念来源**：EvoMap GEP 协议，适配卡若AI 本地与未来流通

---

## 一、概念定义

**基因胶囊**（Gene Capsule）是卡若AI 对「可遗传能力单元」的抽象：将验证过的 Skill + 执行环境 + 审计记录打包成不可篡改的资产，支持本地复用与未来跨 Agent 流通。

```
基因胶囊 = 策略（SKILL） + 环境指纹 + 审计记录 + 资产 ID
```

| 层 | 含义 |
|:---|:---|
| **策略** | SKILL.md 完整内容，含触发词、步骤、脚本路径 |
| **环境指纹** | Python 版本、平台、依赖（便于继承时校验） |
| **审计记录** | 最近一次复盘的「目标·结果·达成率」或执行摘要 |
| **资产 ID** | 对策略内容做 SHA-256，用于去重与溯源 |

---

## 二、胶囊格式（JSON）

### 2.1 必填字段

```json
{
  "version": "1.0",
  "capsule_id": "sha256:abc123...",
  "manifest": {
    "name": "技能名称",
    "description": "一句话描述",
    "triggers": ["触发词1", "触发词2"],
    "owner": "土砖",
    "group": "土",
    "skill_path": "05_卡土（土）/土砖_技能复制/技能工厂/SKILL.md"
  },
  "skill_content": "---\nname: ...\n---\n\n# 技能名\n\n...",
  "created_at": "2026-02-22T21:30:00+08:00",
  "updated_at": "2026-02-22T21:30:00+08:00"
}
```

### 2.2 可选字段

```json
{
  "environment": {
    "python_version": "3.11",
    "platform": "darwin",
    "dependencies": ["requests", "beautifulsoup4"]
  },
  "audit": {
    "last_retro": "目标·结果·达成率 ≤30字",
    "success_rate": "100%",
    "execution_count": 3
  },
  "source": "karuo-ai",
  "tags": ["文档", "自动化"]
}
```

### 2.3 资产 ID 计算规则

```
capsule_id = "sha256:" + SHA256(manifest.skill_path + skill_content 前 8192 字符)
```

保证内容变动则 ID 变动，便于去重与版本追溯。

---

## 三、存储与流通

| 用途 | 存放位置 |
|:---|:---|
| **本地导出的胶囊** | `/Users/karuo/Documents/卡若Ai的文件夹/导出/基因胶囊/` |
| **继承的胶囊（解包后）** | 按 SKILL 归属写入对应 `01～05` 成员目录 |
| **胶囊索引** | `05_卡土（土）/土砖_技能复制/基因胶囊/capsule_index.json` |

---

## 四、与 SKILL 的映射

| SKILL 元素 | 基因胶囊字段 |
|:---|:---|
| frontmatter（name/description/triggers/owner/group） | manifest |
| 正文 Markdown | skill_content |
| 脚本目录 scripts/ | 打包时一并纳入（可选，或仅记录路径） |
| 复盘块 | audit.last_retro |

---

## 五、操作流程

### 5.1 打包（pack）

1. 指定 SKILL 路径或技能名
2. 读取 SKILL.md，解析 frontmatter
3. 收集环境信息（可选）
4. 若存在最近复盘，写入 audit
5. 计算 capsule_id，输出 JSON 到导出目录

### 5.2 解包（unpack）

1. 读取胶囊 JSON
2. 按 manifest.skill_path 或用户指定路径写入 SKILL.md
3. 若有 scripts 等附加文件，按需创建目录
4. 更新 capsule_index.json（若为继承的胶囊）

### 5.3 列表（list）

1. 扫描导出目录 + capsule_index
2. 输出：胶囊名、capsule_id 前 12 位、创建时间、来源

---

## 六、与技能工厂的联动

- **创建 Skill 前**：可先 `list` 本地胶囊，若有匹配则 `unpack` 继承
- **创建 Skill 后**：可 `pack` 将新 Skill 打包为胶囊，供后续复用或未来上传

---

## 七、卡若AI 全流程改造（基因胶囊融入）

### 7.1 流程概览

```
用户任务 → 查 SKILL_REGISTRY → 读 SKILL 执行 → 复盘
                                    ↓
              经验有价值 → 经验库/待沉淀 ──→ 可打包为胶囊
                                    ↓
              创建 Skill 前 → list 查胶囊 → 有则 unpack 继承
              创建 Skill 后 → pack 打包为胶囊
```

### 7.2 导出时产出

每次 `pack` / `pack-all` 为每个技能生成**独立目录**，目录内包含：

- **胶囊 JSON**：`技能名_hash.json`
- **基因胶囊功能流程图.md**：流程图
- **说明文档.md**：本技能说明与解包用法

根目录另有 **README_基因胶囊导出说明.md**（全量清单 + 总流程图）。

### 7.3 流程图

完整流程图见 **`卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md`**，包含：

- 卡若AI 内部流程（需求→执行→复盘→经验→打包）
- 基因胶囊核心流程（pack/unpack/list）
- 技能工厂联动（创建前查/创建后打包）
- 未来对外流通（EvoMap）

---

## 八、引用

- 战略分析：`卡若Ai的文件夹/报告/EvoMap与卡若AI结合战略分析_20260222.md`
- 技能：`05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md`
- 导出说明（含流程图）：`卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md`