4.7 KiB
4.7 KiB
基因胶囊规范 · 卡若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）
- 指定 SKILL 路径或技能名
- 读取 SKILL.md，解析 frontmatter
- 收集环境信息（可选）
- 若存在最近复盘，写入 audit
- 计算 capsule_id，输出 JSON 到导出目录
5.2 解包（unpack）
- 读取胶囊 JSON
- 按 manifest.skill_path 或用户指定路径写入 SKILL.md
- 若有 scripts 等附加文件，按需创建目录
- 更新 capsule_index.json（若为继承的胶囊）
5.3 列表（list）
- 扫描导出目录 + capsule_index
- 输出：胶囊名、capsule_id 前 12 位、创建时间、来源
六、与技能工厂的联动
- 创建 Skill 前：可先
list本地胶囊，若有匹配则unpack继承 - 创建 Skill 后：可
pack将新 Skill 打包为胶囊，供后续复用或未来上传
七、卡若AI 全流程改造（基因胶囊融入）
7.1 流程概览
用户任务 → 查 SKILL_REGISTRY → 读 SKILL 执行 → 复盘
↓
经验有价值 → 经验库/待沉淀 ──→ 可打包为胶囊
↓
创建 Skill 前 → list 查胶囊 → 有则 unpack 继承
创建 Skill 后 → pack 打包为胶囊
7.2 导出时产出
每次 pack 执行时自动生成：
- 胶囊 JSON：
导出/基因胶囊/技能名_sha256前8位.json - 说明文档：
导出/基因胶囊/README_基因胶囊导出说明.md（含完整功能流程图）
7.3 流程图
完整流程图见 卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md，包含：
- 卡若AI 内部流程（需求→执行→复盘→经验→打包）
- 基因胶囊核心流程（pack/unpack/list）
- 技能工厂联动（创建前查/创建后打包）
- 未来对外流通（EvoMap）
八、引用
- 战略分析：
卡若Ai的文件夹/报告/EvoMap与卡若AI结合战略分析_20260222.md - 技能：
05_卡土（土）/土砖_技能复制/基因胶囊/SKILL.md - 导出说明（含流程图）：
卡若Ai的文件夹/导出/基因胶囊/README_基因胶囊导出说明.md