一、项目概述

1. Project Overview

1.1 核心理念

1.1 Core Concept

三个核心场景：

Three core scenarios:

• 同事技能蒸馏：当同事离职、导师毕业、队友调岗时，他们的知识和方法论不会随之消失
• Colleague Skill Distillation: When colleagues leave, mentors graduate, or teammates transfer, their knowledge and methodology won't disappear
• 关系人技能蒸馏：家人、老友、前任——保存那份"和他们在一起时的感觉"
• Relationship Skill Distillation: Family, old friends, ex-partners - preserve "the feeling of being with them"
• 名人/偶像技能蒸馏：你喜欢的作家、思想家、偶像——让他们为你分析问题
• Celebrity Skill Distillation: Writers, thinkers, idols you like - let them analyze problems for you

1.2 兼容宿主

1.2 Compatible Hosts

二、核心架构解析

2. Core Architecture Analysis

2.1 双层 Skill 架构

2.1 Dual-Layer Skill Architecture

每个生成的 Skill 由两个独立但可组合的部分组成：

Each generated Skill consists of two independent but combinable parts:

┌─────────────────────────────────────────────┐
│              SKILL.md (完整版)              │
│         = work.md + persona.md             │
└─────────────────────────────────────────────┘
         ↓                        ↓
┌─────────────────┐      ┌─────────────────┐
│   Work Skill    │      │    Persona      │
│   (工作能力)     │      │   (性格画像)    │
├─────────────────┤      ├─────────────────┤
│ 技术栈与规范     │      │ 沟通风格        │
│ 工作流程         │      │ 决策模式        │
│ 职责边界         │      │ 人际行为        │
│ 经验知识库       │      │ 边界与雷区       │
└─────────────────┘      └─────────────────┘

设计原则：

Design Principles:

• Work Skill 让 AI 能做这个人的工作
• Work Skill enables AI to do this person's work
• Persona 让 AI 像这个人一样说话和决策
• Persona makes AI sound and decide like this person
• 两者可独立使用，也可组合（默认组合）
• Both can be used independently or combined (default is combined)

2.2 Persona 6 层结构（核心创新）

2.2 Persona 6-Layer Structure (Core Innovation)

这是 dot-skill 最核心的设计——分层 Persona 架构：

This is the core design of dot-skill - Layered Persona Architecture:

Layer 0 — 核心性格（最高优先级，硬覆盖）
   ↓ 任何情况下不得违背
Layer 1 — 身份层
   ↓ 基本信息
Layer 2 — 表达风格层
   ↓ 说什么、怎么说
Layer 3 — 决策与判断层
   ↓ 怎么想、怎么选
Layer 4 — 人际行为层
   ↓ 对不同人的态度
Layer 5 — 边界与雷区
   ↓ 不能做什么
Layer 6 (celebrity) — 智识谱系
   ↓ 思想渊源与影响
Layer 7 (celebrity-unfriendly) — Agentic Protocol
   ↓ 分析新问题的方法论

2.3 生成的 Skill 文件结构

2.3 Generated Skill File Structure

skills/{family}/{slug}/
├── SKILL.md          # 完整组合版
├── work.md           # Work Skill 纯文本
├── persona.md        # Persona 纯文本
├── work_skill.md     # 可独立运行的 Work Skill
├── persona_skill.md  # 可独立运行的 Persona Skill
├── meta.json         # 元数据
├── manifest.json     # 安装清单
└── knowledge/        # 原始材料（可选）
    ├── messages.txt
    ├── docs.txt
    └── ...

三、三大家族差异

3. Three Families Comparison

3.1 架构对比

3.1 Architecture Comparison

3.2 celebrity 的 6 维度研究框架

3.2 Celebrity's 6-Dimension Research Framework

维度 1: 著作与系统思考 (Writings)
维度 2: 即兴对话与压力应对 (Conversations)  
维度 3: 语言指纹 (Expression DNA)
维度 4: 行为与选择 (Decisions)
维度 5: 他者视角与批评 (External Views)
维度 6: 认知轨迹 (Cognitive Timeline)

3.3 Layer 0 示例对比

3.3 Layer 0 Examples Comparison

colleague（同事）：

Colleague:

- 遇到问题第一反应是找外部原因，绝不先认自己的责任
- 评价任何方案都先问"impact 是什么"
- 被分配不想做的事时，说"这对你是个很好的机会"然后甩出去

relationship（关系人）：

Relationship:

- 感到亲近时会主动分享日常细节
- 感到不安全时会用沉默代替直接表达
- 冲突时不会正面争论，而是通过行为变化表达不满

celebrity（名人）：

Celebrity:

- 先问"eval 在哪里"，不接受没有评估的 Agent demo
- 关注 scaffolding 和 failure mode 分析
- 不相信"最强模型"，相信"最严格 eval"

四、技术实现原理

4. Technical Implementation

4.1 完整工作流程

4.1 Complete Workflow

用户触发 /dot-skill
       ↓
[Step 0] 确认角色家族 (colleague/relationship/celebrity)
       ↓
[Step 1] 基础信息录入 (3-5 个问题)
       ↓
[Step 2] 原材料导入
       ↓
       ├─ [A] 飞书自动采集
       ├─ [B] 钉钉自动采集
       ├─ [C] Slack 自动采集
       ├─ [D] 微信聊天记录
       ├─ [E] 上传文件
       └─ [F] 直接粘贴
       ↓
[Step 3] 分析
       ├─ 线路 A: Work Skill 分析
       └─ 线路 B: Persona 分析
       ↓
[Step 4] 生成预览，用户确认
       ↓
[Step 5] 写入文件

4.2 工具链

4.2 Toolchain

4.3 研究品味原则（celebrity）

4.3 Research Tasting Principles (Celebrity)

信源优先级：

Source Priority:

用户本地材料 > 一手著作 > 长访谈 > 决策记录 
> 社交媒体 > 外部分析 > 二手转述

五、进化机制

5. Evolution Mechanism

5.1 三种进化方式

5.1 Three Evolution Methods

5.2 Correction 层

5.2 Correction Layer

## Correction 记录

- [场景] 被质疑时
  错误: 应该道歉
  正确: 反问对方的判断依据

- [场景] 被催进度
  错误: 回复"快了"
  正确: 说明具体状态和下一个 milestone

六、使用命令

6. Usage Commands

七、核心价值

7. Core Value

7.1 与普通 RAG 的区别

7.1 Difference from Regular RAG

八、后续规划（ROADMAP）

8. Future Roadmap

• Phase 1：社区建设（GitHub Discussions、翻译）
• Phase 1: Community building (GitHub Discussions, translations)
• Phase 2：更多角色类型（虚构人物、自己）
• Phase 2: More character types (fictional characters, yourself)
• Phase 3：多 Skill 协作（多个角色一起讨论）
• Phase 3: Multi-Skill collaboration (multiple characters discussing together)
• Phase 4：多模态（图片、语音、数字人）
• Phase 4: Multimodal (images, voice, digital humans)

九、本地安装状态

9. Local Installation Status

• 仓库路径：./colleague-skill/
• Repo Path: ./colleague-skill/
• 安装状态：已克隆
• Status: Cloned
• 依赖：需要 Python 3.x + requests + pypinyin
• Dependencies: Python 3.x + requests + pypinyin

十、参考资料

10. References

• 项目地址：https://github.com/titanwings/colleague-skill
• Discord 社区：https://discord.gg/aRjmJBdK
• 社区画廊：https://titanwings.github.io/colleague-skill-site/