karuo-ai/运营中枢/参考资料/基因胶囊规范.md

基因胶囊规范 · 卡若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 必填字段

{
  "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 可选字段

{
  "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的文件夹/报告/EvoMap与卡若AI结合战略分析_20260222.md
• 技能：05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md