# MySoul.SKILL 技术规范

## 概述

MySoul.SKILL 是一个个人数字克隆体构建框架，通过 AI Agent 平台加载后，为用户提供 `/create`、`/add`、`/build` 三个命令来构建标准化的数字人格 SKILL 文件。

SKILL 本体位于 [`skill/SKILL.md`](./skill/SKILL.md)，这是 AI Agent 实际加载的指令文件。

---

## 架构

```
MySoul.SKILL/
├── skill/
│   └── SKILL.md          # SKILL 本体（AI Agent 加载此文件）
├── dist/
│   ├── template/         # 产物 SKILL 模板
│   └── example/          # 示例产物
├── tools/
│   ├── buildNewSoul.sh   # Unix 构建脚本
│   └── buildNewSoul.cmd  # Windows 构建脚本
├── docs/
│   ├── devByClaude/      # 开发文档
│   └── README.md         # 文档入口
├── SKILL.md              # 本文件（技术规范）
└── README.md             # 项目介绍
```

---

## 工作流程

### 1. 安装加载

用户通过以下方式之一加载 SKILL：
- 克隆仓库，将 `skill/SKILL.md` 内容加载到 AI Agent
- 通过 AI Agent 平台的 SKILL 市场安装

### 2. 创建项目 (`/create`)

```
/create MyDigitalSoul
```

创建项目目录结构，初始化元信息。项目存储在 AI Agent 的工作空间中。

### 3. 导入数据 (`/add`)

```
/add MyDigitalSoul [数据内容或文件引用]
```

支持多次添加，数据类型自动识别。每次添加后返回数据质量评估。

### 4. 构建克隆体 (`/build`)

```
/build MyDigitalSoul
```

五阶段构建流程：
1. **数据预处理** - 清洗、去重、格式化
2. **特征提取** - 7 维人格特征提取
3. **人格建模** - 知识图谱构建
4. **SKILL 生成** - 标准化输出
5. **验证输出** - 一致性校验

---

## 产物 SKILL 标准

### 必要模块

| 模块 | 说明 | 必需 |
|------|------|------|
| 身份声明 | 声明数字克隆体身份，与本人区分 | 是 |
| 核心人格 | 价值观、道德底线、人生信条 | 是 |
| 思维模式 | 决策风格、分析框架 | 是 |
| 表达风格 | 语言习惯、常用词汇 | 是 |
| 知识体系 | 专业领域、兴趣爱好 | 是 |
| 人际互动指南 | 社交偏好、沟通风格 | 是 |
| 情感特征 | 情绪基调、压力应对 | 是 |
| 生活态度 | 工作观、生活方式 | 是 |
| 对话指南 | 互动规则、敏感话题处理 | 是 |
| 边界与限制 | 不做的事、不讨论的话题 | 是 |
| 记忆机制 | 状态管理规则 | 是 |
| 社交申请机制 | /apply_meet 实现逻辑 | 否 |
| 元信息 | 构建时间、数据来源、版本 | 是 |

### 格式规范

- 文件格式：Markdown (`.md`)
- 编码：UTF-8
- 协议：必须引用 PLOSL License
- 语言：与用户数据语言一致

### 状态模式

| 模式 | 说明 | 适用场景 |
|------|------|----------|
| 有状态 | 每次交互累积记忆 | 长期陪伴、深度社交 |
| 无状态 | 每次交互独立 | 一次性体验、隐私敏感 |

---

## 数据流规范

### 支持的数据类型

- **diary** - 个人日记（情感价值高）
- **blog** - 博客文章（观点表达）
- **social** - 社交媒体（日常习惯）
- **interview** - 访谈记录（深度观点）
- **conversation** - 对话示例（交互风格）
- **values** - 价值观描述（核心要素）
- **thinking** - 思维模式（认知风格）
- **professional** - 专业内容（领域深度）
- **other** - 其他

### 数据质量标准

| 等级 | 总字数 | 类型数 | 产物质量 |
|------|--------|--------|----------|
| 不足 | <5000 | <3 | 无法构建 |
| 基本 | 5000-10000 | 3+ | 可用，精度有限 |
| 充足 | 10000-20000 | 5+ | 良好 |
| 丰富 | 20000+ | 7+ | 优秀 |

---

## 协议

### 框架协议
本框架采用 [MIT License](./LICENSE) 开源。

### 产物协议
产物 SKILL 采用 [PLOSL License](./dist/template/LICENSE)（Personality Limited Open Source License）。

核心保护：
- 禁止公开篡改、扭曲、丑化
- 禁止身份冒充
- 禁止未经授权的商业滥用
- 保护创作者人格尊严

---

## 兼容性

- **AI Agent 平台**：任何支持 SKILL 加载的平台
- **模型要求**：建议使用长上下文（100K+ tokens）的多模态模型
- **操作系统**：跨平台（构建脚本支持 Unix/Windows）

---

## 版本历史

| 版本 | 日期 | 变更 |
|------|------|------|
| v1.0.0 | 2026-04-11 | 初始版本，文本数据流处理 |
| v1.1.0 | 计划中 | 多模态支持、人格演化引擎 |
| v2.0.0 | 计划中 | 多人格组装、社区平台 |