# AI自进化功能模块 - 产品需求文档（PRD）

---

## 1. 概述（Summary）

本文档为Qihu-AIFlow平台「AI自进化」功能模块的产品需求文档。该模块深度整合开源项目xSkill（https://github.com/SkillNerds/xskill）的自进化技能库引擎，让每个用户的AI在对话过程中持续学习、自动提炼技能、灰度验证后优胜劣汰，形成用户专属的AI能力体系。该功能被用户形象地称为「养龙虾」——在平台内培养不断进化的AI。

---

## 2. 联系人（Contacts）

| 姓名 | 角色 | 备注 |
|------|------|------|
| 项目负责人 | Team Lead | 项目整体规划与协调决策 |
| 产品经理 | Product Manager | PRD撰写、需求分析与产品设计 |
| UI设计师 | UI Designer | AI进化驾驶舱UI视觉设计 |
| 开发工程师 | Developer | xSkill后端整合 + 驾驶舱前端开发 |
| 测试工程师 | QA Engineer | 技能进化链路测试、数据隔离验证 |

---

## 3. 背景（Background）

### 3.1 业务背景

当前AI平台的对话能力是「静态」的——用户每次与AI互动，AI以同样的方式响应，不会从历史对话中学习成长。这意味着：
- 用户重复遇到相似问题时，AI每次都从零开始理解和处理
- 用户无法将自己在特定领域的成功经验「固化」为可复用的技能
- 平台的AI能力不会随着使用深度而个性化升级
- 竞品在AI自进化领域尚未形成标准方案，这是差异化突破口

### 3.2 时机分析

- **xSkill框架成熟**：xSkill已在PyPI发布（v0.5.2），提供完整的「轨迹→原子任务→技能聚类→技能生成→灰度验证」流水线
- **技术可行性已验证**：xSkill使用dulwich纯Python实现git版本管理，每个Skill独立仓库，支持baby/main/staging三态分支
- **用户需求明确**：用户希望拥有「越用越聪明」的AI助理，与平台的SaaS+PaaS定位高度契合
- **与现有平台无缝衔接**：自进化引擎在后台默默运行，无需另设AI聊天窗口，前端仅需增加进化驾驶舱看板

### 3.3 技术依托

- **xSkill开源框架**：核心流水线引擎，负责对话轨迹分析、原子任务拆分、技能聚类、技能生成、灰度验证
- **xSkill核心架构**：
  - `XSkill` 顶层门面：持 config + registry + skill_repo，提供 search/serve/score_trajectory_ux
  - `DirectoryWatcher` 流水线监听器：discovered → splitting → split_done → indexed → clustering → done
  - `TaskAgent`：从轨迹拆分AtomTask（用户意图最小单元）
  - `TaskClusterAgent`：将AtomTask智能聚类到已存在或新Skill
  - `SkillEditAgent`：基于candidates buffer生成/更新SKILL.md
  - `AtomCanary`：灰度系统，A/B测试新Skill版本，按UX评分优胜劣汰
  - `SkillRepo`：每个Skill独立git仓库（baby→main→staging分支）管理版本

---

## 4. 目标与关键成果（Objective & Key Results）

### 4.1 产品目标

为Qihu-AIFlow平台每个用户提供**专属的AI自进化引擎**，AI在对话过程中自动学习、提炼技能、持续进化，最终形成用户独一无二的AI能力体系。前端通过「AI进化驾驶舱」直观展示进化过程和成果。

### 4.2 关键成果（OKR）

| 编号 | 关键结果 | 衡量标准 |
|------|----------|----------|
| KR1 | xSkill引擎成功整合至平台后端 | 对话轨迹可自动进入xSkill流水线处理 |
| KR2 | 每个用户拥有独立进化空间 | 技能仓库、向量索引、对话轨迹按user_id完全隔离 |
| KR3 | AI进化驾驶舱看板上线 | 技能图谱/进化时间线/使用统计/能力画像四个面板可用 |
| KR4 | 进化引擎持续运行 | 用户注册后自动启动，全程无感持续进化 |
| KR5 | 技能可手动管理 | 用户可查看、编辑、删除、冻结已生成的Skill |

---

## 5. 市场细分（Market Segments）

### 5.1 目标用户场景

| 用户类型 | 进化需求 | 典型场景 |
|----------|----------|----------|
| **职场个人用户** | AI越用越懂自己的工作流 | 逐步习得用户的报告风格、数据处理习惯、邮件模板偏好 |
| **副业创收个人** | AI掌握自媒体运营技能 | 积累不同类型内容的创作SOP、平台发布规则、SEO技巧 |
| **小微企业商家** | AI理解企业的业务流程 | 学习内部审批流、客户沟通风格、行业术语库 |
| **AI深度使用者** | 培养专属AI能力体系 | 持续优化AI在特定领域（编程/写作/设计）的输出质量 |

### 5.2 用户约束

- 进化过程应对用户透明，不干扰正常对话
- 用户应能随时查看进化成果，但不能感到被「监控」
- 技能数据完全私有，不能跨用户共享或泄露
- 系统默认持续进化，用户无需任何操作即可享受AI成长

---

## 6. 价值主张（Value Propositions）

### 6.1 核心价值

| 用户需求 | 平台方案 |
|----------|----------|
| 希望AI能记住并复用成功经验 | xSkill自动分析对话，提取成功模式固化为Skill |
| 希望直观看到AI的成长 | AI进化驾驶舱：技能树/时间线/统计/能力画像 |
| 不希望额外操作 | 后台全自动运行，系统默认持续进化，用户无需任何设置 |
| 需要控制权 | 技能管理（查看/编辑/删除/冻结），系统自动进化无需手动干预 |
| 数据安全不容妥协 | 每个用户独立xSkill实例和向量空间，完全物理隔离 |

### 6.2 差异化竞争优势

- **「养龙虾」独特体验**：行业首创的AI进化可视化看板，让用户直观感受AI成长
- **xSkill成熟引擎背书**：基于开源xSkill框架，流水线架构经过验证，非从零研发
- **全自动零打扰**：后台默默运行，用户只需聊天，AI自动进化
- **灰度验证机制**：新Skill经过A/B测试才能合入主干，确保进化质量
- **个人专属AI画像**：每位用户拥有独特的技能图谱和能力标签

---

## 7. 解决方案（Solution）

### 7.1 系统架构图

```
┌─────────────────────────────────────────────────────────────────────┐
│                        前台 - 用户侧                                  │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌─────────────────────┐  │
│  │ AI聊天    │  │ 频道     │  │ 知识库   │  │ AI进化驾驶舱 🆕     │  │
│  │          │  │          │  │          │  │                     │  │
│  │ 对话产生 │  │          │  │          │  │ · 技能图谱/树       │  │
│  │ 轨迹数据 │  │          │  │          │  │ · 进化时间线        │  │
│  │    ↓     │  │          │  │          │  │ · 技能使用统计      │  │
│  │ 自动进化 │  │          │  │          │  │ · AI能力画像         │  │
│  │ 持续运行 │  │          │  │          │  │ · 技能库管理        │  │
│  └──────────┘  └──────────┘  └──────────┘  └─────────────────────┘  │
└─────────────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────────────┐
│                      后端 - xSkill进化引擎                           │
│                                                                     │
│  用户对话 ──→ Trajectory（轨迹）.md 文件                              │
│       │                                                             │
│       ▼                                                             │
│  TaskAgent ──→ AtomTask（原子任务）拆分                              │
│       │                                                             │
│       ▼                                                             │
│  Embedding + 向量索引 ──→ index.pkl                                 │
│       │                                                             │
│       ▼                                                             │
│  TaskClusterAgent ──→ 归类到已有Skill / 新建Skill                    │
│       │                                                             │
│       ▼                                                             │
│  Candidates Buffer ──→ weightscore ≥ 10 触发                        │
│       │                                                             │
│       ▼                                                             │
│  SkillEditAgent ──→ 生成/更新 SKILL.md + scripts/references         │
│       │                                                             │
│       ▼                                                             │
│  Git版本管理 baby → main → staging                                  │
│       │                                                             │
│       ▼                                                             │
│  AtomCanary ──→ A/B灰度验证 → promote/reject/timeout_discard        │
│                                                                     │
│  每个用户独立的xSkill实例 + 独立skill仓库 + 独立向量空间              │
└─────────────────────────────────────────────────────────────────────┘
```

### 7.2 核心功能详细说明

---

#### 功能一：默认全局持续进化

| 功能点 | 详细描述 |
|--------|----------|
| **设计理念** | 系统默认全局开启自进化，用户注册后立即启动，无需手动操作。进化引擎在后台持续运行，用户AI越用越聪明 |
| **启动时机** | 用户完成注册后，进化引擎自动初始化（创建独立skill仓库、初始化xSkill watcher线程），全程无需用户干预 |
| **持续运行** | 用户的每次AI对话结束时，对话记录自动提交至本用户的xSkill流水线进行分析，7x24持续进化 |
| **隐私保障** | AI进化驾驶舱首页展示：「进化数据仅属于你，完全私有，不会与任何人分享」。所有进化数据物理隔离存储 |
| **不可关闭** | 进化是平台核心能力，不可手动关闭。用户可在驾驶舱中管理（查看/编辑/删除/冻结）已生成的技能，但不能停止进化引擎本身 |

#### 功能二：对话自动分析（xSkill流水线整合）

| 功能点 | 详细描述 |
|--------|----------|
| **触发时机** | 每次AI对话会话结束时自动触发；或当对话累计达到一定轮数（如10轮）时增量触发 |
| **轨迹标准化** | 将平台AI聊天记录标准化为xSkill兼容的`.md`轨迹格式，包含`## User`/`## Assistant`轮次标记 |
| **流水线处理** | 轨迹进入xSkill `DirectoryWatcher`流水线：discovered → splitting → split_done → indexed → clustering → done |
| **原子任务拆分** | `TaskAgent`按用户意图切换点将对话拆分为多个`AtomTask`（每个AtomTask包含1-10轮对话） |
| **向量索引** | 对每个AtomTask的summary/intent做embedding，存入用户独立的`index.pkl`向量索引 |
| **技能聚类** | `TaskClusterAgent`遍历新AtomTask，通过向量相似度搜索定位已有Skill，将原子任务归类到最匹配的Skill的候选缓冲区（candidates buffer） |
| **资源控制** | 每个用户的xSkill watcher线程独立运行，使用用户专属的LLM API密钥进行分析调用 |
| **失败重试** | 单次原子任务聚类失败不阻塞整条轨迹，失败原子任务在下一轮watcher扫描时自动重试（最多3次） |

#### 功能三：技能库管理

| 功能点 | 详细描述 |
|--------|----------|
| **技能列表** | 在AI进化驾驶舱中展示用户所有已生成的Skill列表，支持按名称/标签/创建时间搜索和排序 |
| **技能详情** | 点击Skill名称查看完整SKILL.md内容，包括：名称、描述、使用触发条件、执行步骤、版本号、来源对话追溯 |
| **手动编辑** | 用户可直接编辑SKILL.md正文（包含frontmatter和body），保存后进入git版本管理 |
| **技能删除** | 用户可删除不需要的Skill。删除后对应git仓库标记为删除，可在一定时间内恢复 |
| **技能冻结/解冻** | 用户可冻结某个Skill（设置为只读），冻结后xSkill不会再更新该Skill。解冻后恢复自动进化 |
| **技能回滚** | 用户可查看Skill的git版本历史（SKILL.md的diff），并回滚到任意历史版本 |
| **对话溯源** | 每个Skill展示"来源对话"列表，点击可跳转到原始对话记录（如有保存） |

#### 功能四：AI进化驾驶舱（核心前端看板）

这是用户与AI自进化功能交互的核心界面，包含4个子面板：

##### 面板A：技能图谱/技能树

| 功能点 | 详细描述 |
|--------|----------|
| **技能树展示** | 以树形/网状图谱展示用户已掌握的所有AI技能，按技能分类自动分组 |
| **技能状态标识** | 用不同颜色/图标标识技能状态：`baby`（萌芽中，粉色）、`main`（已成熟，绿色）、`staging`（灰度测试中，橙色）、`frozen`（已冻结，灰色） |
| **技能节点信息** | 鼠标悬停显示：技能名称、简短描述、使用次数、最后更新时间 |
| **交互操作** | 点击节点进入技能详情页 |
| **增长动画** | 新技能生成时，技能树上有「萌芽」动画效果（符合「养龙虾」理念） |

##### 面板B：进化时间线

| 功能点 | 详细描述 |
|--------|----------|
| **时间线展示** | 以时间轴形式展示AI的技能进化历程，按时间倒序排列 |
| **里程碑事件** | 记录关键进化节点：新技能诞生、技能重大更新（权重分≥8）、灰度验证通过/拒绝、技能冻结等 |
| **事件卡片** | 每个里程碑显示：时间、事件类型（图标）、技能名称、简短描述（从哪些对话中学到了什么） |
| **筛选能力** | 支持按时间范围、事件类型、技能分类筛选时间线 |
| **导出能力** | 支持将进化时间线导出为图片或PDF分享 |

##### 面板C：技能使用统计

| 功能点 | 详细描述 |
|--------|----------|
| **Top技能排行** | 按使用频率展示TOP N技能，显示每个技能的使用次数和最近一次触发时间 |
| **技能调用趋势** | 折线图展示每日/每周技能调用总量变化趋势 |
| **技能贡献分布** | 饼图展示不同类别技能的使用占比 |
| **最活跃技能** | 标出最近7天内最频繁被调用的前3个技能 |
| **零使用技能提醒** | 自动标识超过30天未使用的技能，建议用户审视或清理 |
| **交互联动** | 点击统计图表中的任意项可跳转到对应技能详情 |

##### 面板D：用户专属AI能力画像

| 功能点 | 详细描述 |
|--------|----------|
| **能力雷达图** | 以六维/八维雷达图展示用户AI的能力分布（如：文字创作、数据分析、代码能力、知识问答、流程自动化、创意生成等维度） |
| **能力标签** | 基于已生成Skill自动打标，展示用户AI的能力关键词标签云 |
| **进化等级** | 根据技能数量、使用频率、技能成熟度等指标计算「AI进化等级」（如Lv.1 ~ Lv.10），直观展示成长阶段 |
| **成长建议** | 基于当前技能缺口，智能推荐「使用这些对话场景来培养新技能」 |
| **画像分享** | 支持将AI能力画像（不含私密数据）生成为分享卡片，可在社交媒体展示 |

#### 功能五：与现有AI聊天模块的无缝衔接

| 功能点 | 详细描述 |
|--------|----------|
| **静默运行** | xSkill进化引擎在后台独立运行，完全不改变/不影响现有的AI聊天交互体验 |
| **不另设聊天窗口** | 自进化功能复用现有的AI聊天模块，不需要额外的聊天界面 |
| **Skill加载提示** | 当某次对话中AI调用了自进化生成的Skill时，在消息下方显示小标签：「🚀 使用了你的专属技能：XXX」 |
| **对话结束钩子** | 每次对话会话正常结束或用户切换话题时，将完整对话轨迹异步提交至进化引擎 |
| **批量处理** | 支持在低负载时段（如凌晨）批量处理白天的对话轨迹，避免影响高峰体验 |

#### 功能六：数据隔离（用户级别）

| 功能点 | 详细描述 |
|--------|----------|
| **Skill仓库隔离** | 每个用户在服务器上有独立的skill根目录：`{data_dir}/users/{user_id}/skills/`，不同用户仓库物理隔离 |
| **向量空间隔离** | 每个用户拥有独立的向量索引文件：`{data_dir}/users/{user_id}/index.pkl`，完全独立embedding |
| **对话轨迹隔离** | 每个用户的对话轨迹存储在独立目录：`{data_dir}/users/{user_id}/trajectories/` |
| **xSkill实例隔离** | 每个用户拥有独立的`XSkill`实例（独立config + registry + skill_repo），后端按user_id路由 |
| **Watcher线程隔离** | 每个用户拥有独立的`DirectoryWatcher`线程，注册后自动启动，处理各自目录的轨迹 |
| **权限验证** | 所有xSkill API调用前验证user_id，确保A用户无法访问B用户的Skill/trajectory/atom数据 |

---

### 7.3 数据库设计概要

#### 7.3.1 新增关系型数据库表

**用户进化配置表：**

| 表名 | 说明 | 核心字段 |
|------|------|----------|
| `user_evolution_config` | 用户进化配置表 | id, user_id, skill_dir_path, trajectory_dir_path, watcher_status(运行中/已停止/错误), created_at, updated_at |

**技能管理表（MySQL中记录Skill元数据）：**

| 表名 | 说明 | 核心字段 |
|------|------|----------|
| `user_skills` | 用户技能表 | id, user_id, skill_name, description, tags(json), state(baby/main/staging/frozen), use_count, version, git_commit_sha, skill_md_path, created_at, updated_at |
| `skill_evolution_events` | 技能进化事件表 | id, user_id, skill_name, event_type(created/promoted/rejected/frozen/unfrozen/edited/deleted), description, version_before, version_after, created_at |
| `skill_trajectory_links` | 技能-轨迹关联表 | id, skill_name, user_id, trajectory_id, atom_id, weightscore, created_at |

**对话轨迹表：**

| 表名 | 说明 | 核心字段 |
|------|------|----------|
| `evolution_trajectories` | 进化轨迹表 | id, user_id, conversation_id, file_path, status(discovered/splitting/split_done/indexed/clustering/done/error/filtered), atom_count, token_used, created_at, processed_at |

#### 7.3.2 文件系统存储（每用户独立）

```
{data_dir}/users/{user_id}/
├── config.yaml                  # xSkill配置文件（用户专属LLM配置等）
├── skills/                      # Skill git仓库根目录
│   ├── fix_python_bug/          # 示例Skill：修复Python bug
│   │   ├── .git/                # 独立git仓库
│   │   ├── SKILL.md             # 技能定义文件
│   │   ├── .candidates.yml      # 候选原子任务缓冲区
│   │   ├── .ux_scores.jsonl     # UX评分记录
│   │   ├── scripts/             # 可执行脚本
│   │   └── references/          # 参考资料
│   └── write_blog_post/         # 示例Skill：写博客文章
│       └── ...
├── trajectories/                # 对话轨迹文件
│   ├── traj_0001/
│   │   ├── traj_0001.md         # 标准化轨迹文件
│   │   └── tasks/               # 原子任务文件
│   │       ├── atom_traj_0001_0001.json
│   │       └── atom_traj_0001_0002.json
│   ├── index.pkl                # 向量索引文件
│   └── evolve.db                # xSkill SQLite状态数据库
└── evolution.log                # 进化引擎日志
```

---

### 7.4 xSkill整合方案

#### 7.4.1 整合策略

采用**封装模式**整合xSkill开源框架——将xSkill作为后端Python库引用，通过用户级别的wrapper封装为平台服务：

```
平台后端服务（FastAPI）
    └── EvolutionService（进化服务层）
        ├── 用户级别的 xSkill 实例管理
        │   └── dict[user_id, XSkill]  + dict[user_id, DirectoryWatcher]
        ├── 对话轨迹提交API
        │   └── POST /app/evolution/trajectory/submit
        ├── 技能查询API
        │   └── GET /app/evolution/skills
        │   └── GET /app/evolution/skills/{name}
        │   └── PUT /app/evolution/skills/{name}
        │   └── DELETE /app/evolution/skills/{name}
        ├── 驾驶舱数据API
        │   └── GET /app/evolution/dashboard/skill-tree
        │   └── GET /app/evolution/dashboard/timeline
        │   └── GET /app/evolution/dashboard/statistics
        │   └── GET /app/evolution/dashboard/profile
        └── 进化事件API
            └── GET /app/evolution/events
```

#### 7.4.2 关键API接口

| 接口 | 方法 | 说明 |
|------|------|------|
| `/app/evolution/trajectory/submit` | POST | 提交对话轨迹到进化流水线 |
| `/app/evolution/skills` | GET | 获取用户所有技能列表 |
| `/app/evolution/skills/{name}` | GET/PUT/DELETE | 技能详情/编辑/删除 |
| `/app/evolution/skills/{name}/freeze` | POST | 冻结技能 |
| `/app/evolution/skills/{name}/unfreeze` | POST | 解冻技能 |
| `/app/evolution/skills/{name}/rollback/{version}` | POST | 回滚到指定版本 |
| `/app/evolution/skills/{name}/history` | GET | 技能版本历史（git log） |
| `/app/evolution/skills/{name}/trajectories` | GET | 技能来源轨迹列表 |
| `/app/evolution/dashboard/skill-tree` | GET | 技能图谱数据 |
| `/app/evolution/dashboard/timeline` | GET | 进化时间线数据 |
| `/app/evolution/dashboard/statistics` | GET | 技能使用统计 |
| `/app/evolution/dashboard/profile` | GET | AI能力画像数据 |
| `/app/evolution/events` | GET | 进化事件列表 |

#### 7.4.3 用户级别xSkill实例管理

```python
# 伪代码示意
class EvolutionService:
    _instances: dict[str, XSkillInstance] = {}

    def get_or_create_instance(user_id: str) -> XSkillInstance:
        """获取或创建用户专属的xSkill实例"""
        if user_id not in self._instances:
            config = self._load_user_config(user_id)
            instance = XSkillInstance(
                xskill=XSkill(config_path=config.config_path),
                watcher=DirectoryWatcher(...),
                user_id=user_id,
            )
            instance.watcher.start()  # 注册即启动，默认持续进化
            self._instances[user_id] = instance
        return self._instances[user_id]
```

---

### 7.5 关键假设与约束

| 编号 | 假设/约束 | 风险等级 |
|------|-----------|----------|
| A1 | xSkill v0.5.2框架可通过pip安装并稳定运行 | 低 |
| A2 | 每个用户独立运行xSkill watcher不会导致服务器资源耗尽 | 中 |
| A3 | 对话轨迹标准化格式与xSkill兼容 | 低 |
| A4 | 用户对「后台分析对话」接受度良好 | 低 |
| C1 | 进化引擎不得修改现有AI聊天模块的行为 | 强约束 |
| C2 | 每个用户的数据完全物理隔离 | 强约束 |
| C3 | 进化引擎持续运行，不可手动停止 | 强约束 |
| C4 | xSkill使用用户LLM调用额度进行技能分析（不额外收费） | 设计决策 |
| C5 | 前端驾驶舱通过API获取数据，不做实时WebSocket推送 | 设计决策 |

---

## 8. 版本规划

### 8.1 当前版本交付范围

一次性交付全部功能：

| 交付物 | 内容说明 |
|--------|----------|
| **默认全局持续进化** | 注册即启动进化引擎，全程无需用户干预 |
| **对话自动分析** | xSkill流水线整合：轨迹标准化 → AtomTask拆分 → 向量索引 → 聚类 → Skill生成/更新 |
| **技能库管理** | 技能列表、详情、编辑、删除、冻结/解冻、回滚、对话溯源 |
| **AI进化驾驶舱** | 4个子面板：技能图谱、进化时间线、技能使用统计、AI能力画像 |
| **数据隔离** | 每用户独立xSkill实例、独立skill仓库、独立向量空间、独立轨迹目录 |
| **与AI聊天衔接** | 对话结束钩子、Skill加载提示标签、静默运行不干扰 |

### 8.2 后续迭代方向

| 方向 | 说明 |
|------|------|
| **技能发现与共享** | 用户可选择将优秀Skill匿名贡献到平台Skill集市（需用户主动操作，非自动） |
| **团队进化空间** | 团队共享技能进化（与预留的「AI团队协作空间」联动） |
| **进化加速** | 用户可消耗更多Token加速进化（如：更频繁的流水线扫描间隔） |
| **多模型进化** | 支持不同模型独立进化不同技能体系 |

---

## 附录A：xSkill核心流水线详解

### 流水线状态转换

```
discovered ──→ splitting ──→ split_done ──→ indexed ──→ clustering ──→ done
                                    ↑                         │
                                    └── error ←── retry ──────┘
```

### Skill三级分支状态机

```
baby ──→ main ──→ staging ──→ (promoted → 合并到main)
                  │
                  └── (rejected → 丢弃staging)
                  │
                  └── (timeout → 14天未验证 → 丢弃staging)
```

### AtomTask UX评分分档表

| 分数 | 含义 |
|------|------|
| 10 | 一次到位：用户提需求 → agent一步给出正确产出 → 用户接受无澄清 |
| 9 | 接近一次到位：仅一处细节澄清 |
| 8 | 正确完成但绕了1个小弯 |
| 7 | 正确完成，2-3次澄清/修正；无明显不耐烦 |
| 6 | 完成度边界（"这就行吧"） |
| 5 | 核心需求达成但遗漏明显细节 |
| 4 | 多次错误后才接近正确，用户≥2次否定词 |
| 3 | 任务勉强完成但用户明显失望 |
| 2 | 任务未完成 / 反复blocker / 用户放弃 |
| 1 | 完全失败或副作用 |

---

## 附录B：功能需求清单

### 前台功能清单（共5大功能模块，25个功能点）

| 序号 | 模块 | 功能点 |
|------|------|--------|
| 1 | 技能库管理 | 技能列表展示（搜索/排序/筛选） |
| 2 | 技能库管理 | 技能详情查看（SKILL.md完整内容） |
| 3 | 技能库管理 | 手动编辑Skill |
| 4 | 技能库管理 | 删除Skill |
| 5 | 技能库管理 | 冻结/解冻Skill |
| 6 | 技能库管理 | 版本历史查看（git log） |
| 7 | 技能库管理 | 回滚到历史版本 |
| 8 | 技能库管理 | 来源对话追溯 |
| 9 | 进化驾驶舱-A | 技能图谱/技能树展示 |
| 10 | 进化驾驶舱-A | 技能状态标识（baby/main/staging/frozen） |
| 11 | 进化驾驶舱-A | 新技能萌芽动画 |
| 12 | 进化驾驶舱-B | 进化时间线展示 |
| 13 | 进化驾驶舱-B | 里程碑事件卡片 |
| 14 | 进化驾驶舱-B | 时间线与事件筛选 |
| 15 | 进化驾驶舱-B | 进化时间线导出 |
| 16 | 进化驾驶舱-C | 技能使用排行 |
| 17 | 进化驾驶舱-C | 技能调用趋势图 |
| 18 | 进化驾驶舱-C | 技能贡献分布图 |
| 19 | 进化驾驶舱-C | 零使用技能提醒 |
| 20 | 进化驾驶舱-D | 能力雷达图 |
| 21 | 进化驾驶舱-D | 能力标签云 |
| 22 | 进化驾驶舱-D | AI进化等级 |
| 23 | 进化驾驶舱-D | 成长建议 |
| 24 | 进化驾驶舱-D | 画像分享卡片 |
| 25 | 聊天衔接 | Skill加载提示标签 |

### 后端功能清单（共5大功能模块，17个功能点）

| 序号 | 模块 | 功能点 |
|------|------|--------|
| 1 | xSkill引擎整合 | 用户级别xSkill实例管理 |
| 2 | xSkill引擎整合 | DirectoryWatcher线程管理 |
| 3 | xSkill引擎整合 | 对话轨迹标准化转换 |
| 4 | xSkill引擎整合 | AtomTask拆分与存储 |
| 5 | xSkill引擎整合 | 向量索引构建 |
| 6 | xSkill引擎整合 | Skill聚类与生成 |
| 7 | xSkill引擎整合 | 灰度A/B测试 |
| 8 | xSkill引擎整合 | git版本管理 |
| 9 | xSkill引擎整合 | 用户Skill仓库初始化 |
| 10 | 技能管理API | 技能CRUD |
| 11 | 技能管理API | 版本回滚 |
| 12 | 驾驶舱数据API | 技能树/时间线/统计/画像数据 |
| 13 | 数据隔离 | 每用户独立skill_dir |
| 14 | 数据隔离 | 每用户独立trajectory_dir |
| 15 | 数据隔离 | 每用户独立向量索引 |
| 16 | 数据隔离 | API调用user_id强制验证 |
| 17 | 对话轨迹钩子 | 对话结束自动提交轨迹 |

---

> **文档状态**：已定稿  
> **创建日期**：2026-05-26  
> **文档版本**：v1.0  
> **基于框架**：xSkill v0.5.2 (https://github.com/SkillNerds/xskill)