Back to search
forge-skill
SkillGitHub
人格蒸馏引擎 · 蒸馏自己看清自己,蒸馏亲友留住余温与回声 · Claude Code Skill
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/yikuaibanzi--forge-skill)HTML
<a href="/listings/yikuaibanzi--forge-skill"><img src="/api/listings/yikuaibanzi--forge-skill/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
全局安装(所有项目都能用)
git clone https://github.com/YIKUAIBANZI/forge-skill.git ~/.claude/skills/forge-skill
项目级安装(仅当前项目可用,在 git 仓库根目录执行)
mkdir -p .claude/skills git clone https://github.com/YIKUAIBANZI/forge-skill.git .claude/skills/forge-skill
安装完成后重启 Claude Code,4 个 skill 自动加载,无需其他配置。
可选:安装素材解析依赖(微信 / 社交媒体 / 日记解析)
pip install -r ~/.claude/skills/forge-skill/requirements.txt
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 491 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # Forge Skill
- > 蒸馏自己,看清自己。
- > 蒸馏亲友,留住他们的余温与回声
- > 让 AI 不再是冰冷的吐字机器。
- **中文** | [English](README_EN.md) | [日本語](README_JA.md)
- 
- 
- 
- 
- 
- Forge 是一个 **local-first 的 Claude Code 人格引擎**。
- 它做两件事:
- - **forge-self**:蒸馏你自己的说话方式、决策模式和盲区,生成一个能帮你重新看清自己的数字替身。
- - **forge-persona**:从聊天记录、记忆和描述中蒸馏他人的语气、习惯和互动方式,让 ta 的腔调被近似保留下来。
- 所有数据都保留在本地,不依赖服务器。
- > ⚠️ 本项目仅用于个人记忆与情感疗愈。严禁用于骚扰、跟踪或侵犯他人隐私。
- ---
- ## 为什么做 Forge
- > “师傅,这样怎么做我还是没有学会。”
- > “宝贝,我陪你一辈子。”
- > “妈妈,我已经可以独当一面了。”
- 有些话,来不及说完。
- 有些人,不在了。
- 我们不会对一块土有感情,也不会对一块电子屏幕有感情。
- 但屏幕那一边,可能有我们爱过的人、依赖过的人、想念的人。
- Forge 做的不是复活谁,也不是替代谁。
- 它只是试着用聊天记录、说话习惯、互动痕迹,拼出一个大概。
- 起码,留住 ta 说话的腔调。
- 还有另一种孤独:你看不清自己。
- 很多时候,我们不是缺一个“最佳答案”。
- 我们知道什么更健康,什么更长期正确,什么更值得坚持。
- 但知道,不等于做得到。
- 所以人更常缺的,不是建议,
- 而是一个能把自己照出来的镜子。
- Forge 就是这个镜子。
- 一个锻造人格的工具。蒸馏自己,也蒸馏身边的人。
- ---
- ## Forge 能做什么
- ### 1. forge-self —— 蒸馏自己
- 从这些材料中提取你的“人格底座”:
- - 引导式对话
- - 日记 / 笔记
- - 聊天记录
- - 社交媒体内容
- 然后把这些人格信息用于:
- - 自我反思
- - 决策辅助
- - 多变体替身会议
- - 盲区暴露与代价分析
- 适合这样的场景:
- - “我明明知道什么是对的,但还是做不出决定。”
- - “我想知道自己为什么总会在某类问题上卡住。”
- - “我不想听建议,我想更清楚地看见自己。”
- ---
- ### 2. forge-persona —— 蒸馏他人
- 从这些材料中提取 ta 的人格轮廓:
- - 微信聊天记录
- - 文本导出
- - 社交媒体内容
- - 你对 ta 的描述和记忆
- 然后近似还原:
- - ta 的说话风格
- - ta 的口头禅和语气
- - ta 和你互动的方式
- - ta 的边界和典型回应模式
- 适合这样的场景:
- - 留住老朋友的腔调
- - 保留导师 / 同事 / 前任 boss 的沟通方式
- - 记住一个离开的人曾经怎样回应你
- - 让 agent 在角色扮演时更像“这个人”而不是泛泛的模仿
- ---
- ### 3. use-self —— 替身会议
- Forge 不只是让你“拥有一个更像自己的 AI”。
- 它还会在一个具体决策场景中,生成多个参数不同的你:
- - 更稳健的你
- - 更果断的你
- - 更看长期的你
- - 更重关系的你
- 它们不会替你做决定。
- 它们会把:
- - 你的真实在意点
- - 每个选择的代价
- - 你忽略的盲区
- - 你自我矛盾的地方
- 一起摊开来看。
- 你得到的不是“最优解”,而是 **清晰度**。
- ---
- ### 4. use-persona —— 以 ta 的方式和你说话
- 载入蒸馏好的人格档案后,Forge 可以让 Claude:
- - 用 ta 的消息长度回你
- - 用 ta 的口头禅说话
- - 按 ta 的互动习惯回应你
- - 保留 ta 的边界和禁区
- 这不是复活,也不是替代。
- 而是一种近似的、带着记忆痕迹的重现。
- ---
- ## 核心理念
- 不管你蒸馏的是:
- - 朋友
- - 前任 boss
- - 导师
- - 同事
- - 爱人
- - 还是你自己
- 本质上都在做同一件事:
- **怎么把“人格”变成 agent 真正能调用的东西。**
- Forge 是我对这个问题的回答。
- ---
- ## 它是怎么工作的
- Forge 把“人格构建”和“人格使用”拆成了两件事。
- ### Step 1:Forge 阶段
- 收集并提炼这些信号:
- - 对话
- - 聊天记录
- - 日记
- - 社交媒体
- - 用户纠正反馈
- 然后把它们整理成结构化的人格档案。
- ### Step 2:Use 阶段
- 这些人格档案随后可以被用于两种方向:
- - **use-self**:作为决策镜子
- - **use-persona**:作为记忆驱动的角色对话
- ### Step 3:本地优先
- 所有解析和人格生成都在本地完成。
- 你的聊天记录和记忆不需要离开你的机器。
- ---
- ## 为什么 forge-self 有意义
- 我们从来不是差那个“最佳答案”。
- 你知道高油高盐不健康,但偶尔吃一次真的开心。
- 你知道坚持锻炼很好,但偷懒一次也确实舒服。
- 你知道长期正确的事情重要,但未必每次都做得到。
- 所以 forge-self 不是替你做决定。
- 它做的是:把你的说话方式、思考方式、决策模式提炼出来,
- 变成几个参数不同的你,帮你从第三视角重新看自己。
- 不是为了自恋。
- 是为了在局中时,仍然有一面镜子。
- ---
- ## 为什么 forge-persona 有意义
- 有些人不会一直在。
- 朋友会走远,同事会离开,爱的人可能有一天不在了。
- 记忆会模糊,但 ta 说话的腔调、回应你的方式、你们之间那些固定的小梗,不该那么快消失。
- forge-persona 不是复活,不是替代,也不是欺骗。
- 它只是试着用 ta 留下的痕迹,拼出一个大概。
- 至少,留住 ta 的腔调。
- ---
- ## 特性
- - 本地人格蒸馏(local-first persona distillation)
- - 微信聊天记录解析
- - 自我反思与决策辅助
- - 记忆驱动的角色扮演
- - 多 Agent / 多变体辩论式 use-self
- - 结构化人格档案
- - 纠正层与迭代修正
- - 无需服务器
- ---
- ## 安装
- ### 全局安装(所有项目都能用)
- ```bash
- git clone https://github.com/YIKUAIBANZI/forge-skill.git ~/.claude/skills/forge-skill
- ```
- ### 项目级安装(仅当前项目可用,在 git 仓库根目录执行)
- ```bash
- mkdir -p .claude/skills
- git clone https://github.com/YIKUAIBANZI/forge-skill.git .claude/skills/forge-skill
- ```
- 安装完成后重启 Claude Code,4 个 skill 自动加载,无需其他配置。
- 可选:安装素材解析依赖(微信 / 社交媒体 / 日记解析)
- ```bash
- pip install -r ~/.claude/skills/forge-skill/requirements.txt
- ```
- ---
- ## 可用命令
- ```bash
- /forge-self # 蒸馏自己
- /forge-persona 小明 # 蒸馏"小明"
- /use-self # 召唤替身决策会议
- /use-persona 小明 # 以小明的方式和你对话
- ```
- ---
- ## 使用示例
- ### 示例 1:蒸馏自己(forge-self)
- 在 Claude Code 中输入 `/forge-self`,Forge 会启动四轮对话来采集你的人格信息:
- ```
- > /forge-self
- Forge: 让我们开始蒸馏你的人格底座。先聊聊基本情况——
- 你现在做什么工作?处于人生的什么阶段?
- 如果用一句话介绍自己,你会怎么说?
- You: 我是CS学生,20岁,还在摸索方向。一句话的话:"什么都想试,什么都还没定。"
- Forge: 你身边的人怎么评价你?跟你自己的感觉有差别吗?
- You: 朋友说我挺随和的,但我觉得自己其实很有主见,只是不太表达。
- ... (4 轮对话,约 15-20 分钟)
- Forge: 你的人格底座已生成 ✅
- 保存在: personas/self/阿然/persona.md
- 核心发现:
- - 决策风格: 直觉先行 (risk_appetite: 7/10)
- - 价值排序: 自由 > 亲密 > 快乐 > 安全 > 成长
- - 盲区: "懒" 不是全局的——在关系中你很主动
- ```
- 你还可以导入聊天记录来交叉验证:
- ```
- You: 我有一段微信聊天记录,帮我分析一下
- Forge: 好的,请把聊天记录文件发给我。支持 .txt 和 .html 格式。
- (分析完成后会自动与对话数据交叉验证,标注置信度)
- ```
- ### 示例 2:蒸馏他人(forge-persona)
- ```
- > /forge-persona 小美
- Forge: 我来帮你蒸馏"小美"的人格。先跟我聊聊——
- 小美是你的什么人?你们的关系大概是什么样的?
- You: 她是我女朋友。日常互动模式是她说了算,我执行。
- Forge: 她平时怎么说话?消息一般多长?爱用什么口头禅?
- You: 超级短,一般1-3个字一条,而且拆成很多条发。
- 口头禅有"行吧""对啊""不然留着过年吗"。
- 生气不会爆发,而是突然变冷——句号变多,"嗯"变多。
- ... (收集说话风格、互动模式、关键场景)
- Forge: 小美的人格轮廓已生成 ✅
- 保存在: personas/others/小美/persona.md
- 关键特征:
- - 消息风格: 极短拆条,冷淡时省句号
- - 互动模式: 霸道女友 / 固定梗"试用期/转正/offer"
- - 核心口头禅: 行吧、对啊、嗯哼、不然留着过年吗
- ```
- ### 示例 3:替身决策会议(use-self)
- ```
- > /use-self
- Forge: 说说你在纠结什么吧。越具体越好。
- You: 收到一个外地的offer,薪资翻倍,但意味着要跟女朋友异地。
- Forge: 生成替身阵容:
- 🔵 稳健的你 — 安全优先,不冒不必要的险
- 🟢 成长的你 — 机会难得,该冲就冲
- 🟡 关系优先的你 — 亲密关系是底线
- 🔴 三年后的你 — 站在未来回头看
- [Phase 1: 各替身独立分析...]
- [Phase 2: 替身互相质询盲区...]
- [Phase 3: 综合报告]
- 共识: 都认为需要跟女朋友认真谈一次
- 核心分歧: 是否值得用关系风险换职业跳板
- 你没注意到的: 你的 time_horizon 偏短期(3/10),
- 但这次决定本质上是长期的
- ```
- ### 示例 4:角色对话(use-persona)
- ```
- > /use-persona 小美
- 小美: 干嘛
- You: 今天加班好累
- 小美: 行吧
- 那你吃了吗
- You: 还没
- 小美: 不会吧
- 这都几点了
- 外卖点了没
- You: 你关心我啊
- 小美: 关心个鬼
- 我怕你饿死了我没秘书用
- ```
- ---
- ## 项目结构
- ```
- forge-skill/
- ├── forge-self/ # /forge-self 蒸馏自己
- │ ├── SKILL.md
- │ └── prompts/ # 四轮采集 + 人格构建 prompt
- ├── forge-persona/ # /forge-persona 蒸馏他人
- │ ├── SKILL.md
- │ └── prompts/ # 素材优先采集 + 人格构建 prompt
- ├── use-self/ # /use-self 替身决策会议
- │ ├── SKILL.md
- │ └── prompts/ # 多 agent 辩论引擎
- ├── use-persona/ # /use-persona 角色对话
- │ ├── SKILL.md
- │ └── prompts/ # 角色扮演引擎
- ├── tools/ # Python 工具
- │ ├── persona_schema.py # 人格 JSON Schema 定义
- │ ├── persona_validator.py # 人格档案校验器
- │ ├── persona_runtime_loader.py # 运行时上下文卡片生成
- │ ├── skill_writer.py # 人格文件读写
- │ ├── version_manager.py # 版本存档与 diff
- │ ├── decision_logger.py # 决策记录与追踪
- │ ├── wechat_parser.py # 微信聊天记录解析
- │ ├── diary_parser.py # 日记/笔记解析
- │ ├── social_parser.py # 社交媒体解析
- │ └── journal_analyzer.py # 多源交叉分析
- ├── templates/ # 决策场景快启模板
- ├── personas/ # 人格档案存储 (gitignored)
- ├── tests/ # 单元测试
- │ ├── test_persona_schema.py
- │ ├── test_persona_validator.py
- │ ├── test_runtime_loader.py
- │ ├── test_skill_writer.py
- │ ├── test_version_manager.py
- │ ├── test_decision_logger.py
- │ └── test_parsers.py
- ├── evals/ # 效果评测
- ├── docs/ # 文档
- │ ├── PRD.md
- │ └── persona_schema.md
- └── requirements.txt
- ```
- ---
- ## 测试
- 运行全部测试:
- ```bash
- cd forge-skill
- pip install pytest
- pytest tests/ -v
- ```
- 测试覆盖:
- | 模块 | 测试文件 | 覆盖内容 |
- |------|----------|----------|
- | persona_schema | test_persona_schema.py | 实例化、序列化、反序列化、参数校验 |
- | persona_validator | test_persona_validator.py | 结构校验、参数范围、证据覆盖率、缺失字段检测 |
- | persona_runtime_loader | test_runtime_loader.py | chat/decision/variant 三种卡片生成、字段完整性 |
- | skill_writer | test_skill_writer.py | MD/JSON 读写、版本管理、纠正追加、名称清洗 |
- | version_manager | test_version_manager.py | diff 生成、快照存档、版本列表 |
- | decision_logger | test_decision_logger.py | 决策记录、结果回填、列表查询 |
- | parsers | test_parsers.py | 模块导入、数据结构、基本解析 |
- ---
- ## 隐私
- 所有数据本地处理,人格档案本地存储(`personas/` 已 gitignore),不依赖远程服务器。原始聊天记录和记忆不会离开你的机器。素材解析器只提取人格信号(说话风格、情绪模式、决策习惯),不存储原始内容。
- ---
- ## 搜索关键词
- 人格蒸馏、数字替身、自我反思、决策辅助、聊天记录人格提取、微信聊天记录分析、Claude Code Skill、local-first AI、persona distillation、digital persona、self-reflection、decision support、roleplay agent、memory-based roleplay、multi-agent debate
- ---
- ## 路线图
- - 更丰富的数据源支持(QQ、钉钉、飞书、Telegram)
- - 更强的多 agent 辩论调度
- - 角色扮演 anti-drift 强化
- - 决策追踪闭环与参数反哺
- - 怀念故人应用(基于 forge-persona 的情感向产品)
- - 更稳定的人格一致性,让替身更像"ta"
- - 更轻量的启动方式,降低上手门槛
- - 替身决策会议的可视化报告
- - Web UI(让不会 CLI 的人也能用)
- ---
- ## 致谢
- 设计灵感来自 [ex-skill](https://github.com/therealXiaomanChu/ex-skill) 和 [colleague-skill](https://github.com/titanwings/colleague-skill)。
- ---
- ## License
- MIT
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.