Skip to content
Back to search

forge-skill

人格蒸馏引擎 · 蒸馏自己看清自己,蒸馏亲友留住余温与回声 · 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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/yikuaibanzi--forge-skill/badge.svg)](/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)

  1. # Forge Skill
  2. > 蒸馏自己,看清自己。
  3. > 蒸馏亲友,留住他们的余温与回声
  4. > 让 AI 不再是冰冷的吐字机器。
  5. **中文** | [English](README_EN.md) | [日本語](README_JA.md)
  6. ![License](https://img.shields.io/badge/License-MIT-yellow.svg)
  7. ![Claude Code](https://img.shields.io/badge/Claude_Code-Skill-purple.svg)
  8. ![forge-self](https://img.shields.io/badge/forge--self-蒸馏自己-blue.svg)
  9. ![forge-persona](https://img.shields.io/badge/forge--persona-蒸馏他人-orange.svg)
  10. ![Privacy](https://img.shields.io/badge/数据-本地处理-green.svg)
  11. Forge 是一个 **local-first 的 Claude Code 人格引擎**。
  12. 它做两件事:
  13. - **forge-self**:蒸馏你自己的说话方式、决策模式和盲区,生成一个能帮你重新看清自己的数字替身。
  14. - **forge-persona**:从聊天记录、记忆和描述中蒸馏他人的语气、习惯和互动方式,让 ta 的腔调被近似保留下来。
  15. 所有数据都保留在本地,不依赖服务器。
  16. > ⚠️ 本项目仅用于个人记忆与情感疗愈。严禁用于骚扰、跟踪或侵犯他人隐私。
  17. ---
  18. ## 为什么做 Forge
  19. > “师傅,这样怎么做我还是没有学会。”
  20. > “宝贝,我陪你一辈子。”
  21. > “妈妈,我已经可以独当一面了。”
  22. 有些话,来不及说完。
  23. 有些人,不在了。
  24. 我们不会对一块土有感情,也不会对一块电子屏幕有感情。
  25. 但屏幕那一边,可能有我们爱过的人、依赖过的人、想念的人。
  26. Forge 做的不是复活谁,也不是替代谁。
  27. 它只是试着用聊天记录、说话习惯、互动痕迹,拼出一个大概。
  28. 起码,留住 ta 说话的腔调。
  29. 还有另一种孤独:你看不清自己。
  30. 很多时候,我们不是缺一个“最佳答案”。
  31. 我们知道什么更健康,什么更长期正确,什么更值得坚持。
  32. 但知道,不等于做得到。
  33. 所以人更常缺的,不是建议,
  34. 而是一个能把自己照出来的镜子。
  35. Forge 就是这个镜子。
  36. 一个锻造人格的工具。蒸馏自己,也蒸馏身边的人。
  37. ---
  38. ## Forge 能做什么
  39. ### 1. forge-self —— 蒸馏自己
  40. 从这些材料中提取你的“人格底座”:
  41. - 引导式对话
  42. - 日记 / 笔记
  43. - 聊天记录
  44. - 社交媒体内容
  45. 然后把这些人格信息用于:
  46. - 自我反思
  47. - 决策辅助
  48. - 多变体替身会议
  49. - 盲区暴露与代价分析
  50. 适合这样的场景:
  51. - “我明明知道什么是对的,但还是做不出决定。”
  52. - “我想知道自己为什么总会在某类问题上卡住。”
  53. - “我不想听建议,我想更清楚地看见自己。”
  54. ---
  55. ### 2. forge-persona —— 蒸馏他人
  56. 从这些材料中提取 ta 的人格轮廓:
  57. - 微信聊天记录
  58. - 文本导出
  59. - 社交媒体内容
  60. - 你对 ta 的描述和记忆
  61. 然后近似还原:
  62. - ta 的说话风格
  63. - ta 的口头禅和语气
  64. - ta 和你互动的方式
  65. - ta 的边界和典型回应模式
  66. 适合这样的场景:
  67. - 留住老朋友的腔调
  68. - 保留导师 / 同事 / 前任 boss 的沟通方式
  69. - 记住一个离开的人曾经怎样回应你
  70. - 让 agent 在角色扮演时更像“这个人”而不是泛泛的模仿
  71. ---
  72. ### 3. use-self —— 替身会议
  73. Forge 不只是让你“拥有一个更像自己的 AI”。
  74. 它还会在一个具体决策场景中,生成多个参数不同的你:
  75. - 更稳健的你
  76. - 更果断的你
  77. - 更看长期的你
  78. - 更重关系的你
  79. 它们不会替你做决定。
  80. 它们会把:
  81. - 你的真实在意点
  82. - 每个选择的代价
  83. - 你忽略的盲区
  84. - 你自我矛盾的地方
  85. 一起摊开来看。
  86. 你得到的不是“最优解”,而是 **清晰度**。
  87. ---
  88. ### 4. use-persona —— 以 ta 的方式和你说话
  89. 载入蒸馏好的人格档案后,Forge 可以让 Claude:
  90. - 用 ta 的消息长度回你
  91. - 用 ta 的口头禅说话
  92. - 按 ta 的互动习惯回应你
  93. - 保留 ta 的边界和禁区
  94. 这不是复活,也不是替代。
  95. 而是一种近似的、带着记忆痕迹的重现。
  96. ---
  97. ## 核心理念
  98. 不管你蒸馏的是:
  99. - 朋友
  100. - 前任 boss
  101. - 导师
  102. - 同事
  103. - 爱人
  104. - 还是你自己
  105. 本质上都在做同一件事:
  106. **怎么把“人格”变成 agent 真正能调用的东西。**
  107. Forge 是我对这个问题的回答。
  108. ---
  109. ## 它是怎么工作的
  110. Forge 把“人格构建”和“人格使用”拆成了两件事。
  111. ### Step 1:Forge 阶段
  112. 收集并提炼这些信号:
  113. - 对话
  114. - 聊天记录
  115. - 日记
  116. - 社交媒体
  117. - 用户纠正反馈
  118. 然后把它们整理成结构化的人格档案。
  119. ### Step 2:Use 阶段
  120. 这些人格档案随后可以被用于两种方向:
  121. - **use-self**:作为决策镜子
  122. - **use-persona**:作为记忆驱动的角色对话
  123. ### Step 3:本地优先
  124. 所有解析和人格生成都在本地完成。
  125. 你的聊天记录和记忆不需要离开你的机器。
  126. ---
  127. ## 为什么 forge-self 有意义
  128. 我们从来不是差那个“最佳答案”。
  129. 你知道高油高盐不健康,但偶尔吃一次真的开心。
  130. 你知道坚持锻炼很好,但偷懒一次也确实舒服。
  131. 你知道长期正确的事情重要,但未必每次都做得到。
  132. 所以 forge-self 不是替你做决定。
  133. 它做的是:把你的说话方式、思考方式、决策模式提炼出来,
  134. 变成几个参数不同的你,帮你从第三视角重新看自己。
  135. 不是为了自恋。
  136. 是为了在局中时,仍然有一面镜子。
  137. ---
  138. ## 为什么 forge-persona 有意义
  139. 有些人不会一直在。
  140. 朋友会走远,同事会离开,爱的人可能有一天不在了。
  141. 记忆会模糊,但 ta 说话的腔调、回应你的方式、你们之间那些固定的小梗,不该那么快消失。
  142. forge-persona 不是复活,不是替代,也不是欺骗。
  143. 它只是试着用 ta 留下的痕迹,拼出一个大概。
  144. 至少,留住 ta 的腔调。
  145. ---
  146. ## 特性
  147. - 本地人格蒸馏(local-first persona distillation)
  148. - 微信聊天记录解析
  149. - 自我反思与决策辅助
  150. - 记忆驱动的角色扮演
  151. - 多 Agent / 多变体辩论式 use-self
  152. - 结构化人格档案
  153. - 纠正层与迭代修正
  154. - 无需服务器
  155. ---
  156. ## 安装
  157. ### 全局安装(所有项目都能用)
  158. ```bash
  159. git clone https://github.com/YIKUAIBANZI/forge-skill.git ~/.claude/skills/forge-skill
  160. ```
  161. ### 项目级安装(仅当前项目可用,在 git 仓库根目录执行)
  162. ```bash
  163. mkdir -p .claude/skills
  164. git clone https://github.com/YIKUAIBANZI/forge-skill.git .claude/skills/forge-skill
  165. ```
  166. 安装完成后重启 Claude Code,4 个 skill 自动加载,无需其他配置。
  167. 可选:安装素材解析依赖(微信 / 社交媒体 / 日记解析)
  168. ```bash
  169. pip install -r ~/.claude/skills/forge-skill/requirements.txt
  170. ```
  171. ---
  172. ## 可用命令
  173. ```bash
  174. /forge-self # 蒸馏自己
  175. /forge-persona 小明 # 蒸馏"小明"
  176. /use-self # 召唤替身决策会议
  177. /use-persona 小明 # 以小明的方式和你对话
  178. ```
  179. ---
  180. ## 使用示例
  181. ### 示例 1:蒸馏自己(forge-self)
  182. 在 Claude Code 中输入 `/forge-self`,Forge 会启动四轮对话来采集你的人格信息:
  183. ```
  184. > /forge-self
  185. Forge: 让我们开始蒸馏你的人格底座。先聊聊基本情况——
  186. 你现在做什么工作?处于人生的什么阶段?
  187. 如果用一句话介绍自己,你会怎么说?
  188. You: 我是CS学生,20岁,还在摸索方向。一句话的话:"什么都想试,什么都还没定。"
  189. Forge: 你身边的人怎么评价你?跟你自己的感觉有差别吗?
  190. You: 朋友说我挺随和的,但我觉得自己其实很有主见,只是不太表达。
  191. ... (4 轮对话,约 15-20 分钟)
  192. Forge: 你的人格底座已生成 ✅
  193. 保存在: personas/self/阿然/persona.md
  194. 核心发现:
  195. - 决策风格: 直觉先行 (risk_appetite: 7/10)
  196. - 价值排序: 自由 > 亲密 > 快乐 > 安全 > 成长
  197. - 盲区: "懒" 不是全局的——在关系中你很主动
  198. ```
  199. 你还可以导入聊天记录来交叉验证:
  200. ```
  201. You: 我有一段微信聊天记录,帮我分析一下
  202. Forge: 好的,请把聊天记录文件发给我。支持 .txt 和 .html 格式。
  203. (分析完成后会自动与对话数据交叉验证,标注置信度)
  204. ```
  205. ### 示例 2:蒸馏他人(forge-persona)
  206. ```
  207. > /forge-persona 小美
  208. Forge: 我来帮你蒸馏"小美"的人格。先跟我聊聊——
  209. 小美是你的什么人?你们的关系大概是什么样的?
  210. You: 她是我女朋友。日常互动模式是她说了算,我执行。
  211. Forge: 她平时怎么说话?消息一般多长?爱用什么口头禅?
  212. You: 超级短,一般1-3个字一条,而且拆成很多条发。
  213. 口头禅有"行吧""对啊""不然留着过年吗"。
  214. 生气不会爆发,而是突然变冷——句号变多,"嗯"变多。
  215. ... (收集说话风格、互动模式、关键场景)
  216. Forge: 小美的人格轮廓已生成 ✅
  217. 保存在: personas/others/小美/persona.md
  218. 关键特征:
  219. - 消息风格: 极短拆条,冷淡时省句号
  220. - 互动模式: 霸道女友 / 固定梗"试用期/转正/offer"
  221. - 核心口头禅: 行吧、对啊、嗯哼、不然留着过年吗
  222. ```
  223. ### 示例 3:替身决策会议(use-self)
  224. ```
  225. > /use-self
  226. Forge: 说说你在纠结什么吧。越具体越好。
  227. You: 收到一个外地的offer,薪资翻倍,但意味着要跟女朋友异地。
  228. Forge: 生成替身阵容:
  229. 🔵 稳健的你 — 安全优先,不冒不必要的险
  230. 🟢 成长的你 — 机会难得,该冲就冲
  231. 🟡 关系优先的你 — 亲密关系是底线
  232. 🔴 三年后的你 — 站在未来回头看
  233. [Phase 1: 各替身独立分析...]
  234. [Phase 2: 替身互相质询盲区...]
  235. [Phase 3: 综合报告]
  236. 共识: 都认为需要跟女朋友认真谈一次
  237. 核心分歧: 是否值得用关系风险换职业跳板
  238. 你没注意到的: 你的 time_horizon 偏短期(3/10),
  239. 但这次决定本质上是长期的
  240. ```
  241. ### 示例 4:角色对话(use-persona)
  242. ```
  243. > /use-persona 小美
  244. 小美: 干嘛
  245. You: 今天加班好累
  246. 小美: 行吧
  247. 那你吃了吗
  248. You: 还没
  249. 小美: 不会吧
  250. 这都几点了
  251. 外卖点了没
  252. You: 你关心我啊
  253. 小美: 关心个鬼
  254. 我怕你饿死了我没秘书用
  255. ```
  256. ---
  257. ## 项目结构
  258. ```
  259. forge-skill/
  260. ├── forge-self/ # /forge-self 蒸馏自己
  261. │ ├── SKILL.md
  262. │ └── prompts/ # 四轮采集 + 人格构建 prompt
  263. ├── forge-persona/ # /forge-persona 蒸馏他人
  264. │ ├── SKILL.md
  265. │ └── prompts/ # 素材优先采集 + 人格构建 prompt
  266. ├── use-self/ # /use-self 替身决策会议
  267. │ ├── SKILL.md
  268. │ └── prompts/ # 多 agent 辩论引擎
  269. ├── use-persona/ # /use-persona 角色对话
  270. │ ├── SKILL.md
  271. │ └── prompts/ # 角色扮演引擎
  272. ├── tools/ # Python 工具
  273. │ ├── persona_schema.py # 人格 JSON Schema 定义
  274. │ ├── persona_validator.py # 人格档案校验器
  275. │ ├── persona_runtime_loader.py # 运行时上下文卡片生成
  276. │ ├── skill_writer.py # 人格文件读写
  277. │ ├── version_manager.py # 版本存档与 diff
  278. │ ├── decision_logger.py # 决策记录与追踪
  279. │ ├── wechat_parser.py # 微信聊天记录解析
  280. │ ├── diary_parser.py # 日记/笔记解析
  281. │ ├── social_parser.py # 社交媒体解析
  282. │ └── journal_analyzer.py # 多源交叉分析
  283. ├── templates/ # 决策场景快启模板
  284. ├── personas/ # 人格档案存储 (gitignored)
  285. ├── tests/ # 单元测试
  286. │ ├── test_persona_schema.py
  287. │ ├── test_persona_validator.py
  288. │ ├── test_runtime_loader.py
  289. │ ├── test_skill_writer.py
  290. │ ├── test_version_manager.py
  291. │ ├── test_decision_logger.py
  292. │ └── test_parsers.py
  293. ├── evals/ # 效果评测
  294. ├── docs/ # 文档
  295. │ ├── PRD.md
  296. │ └── persona_schema.md
  297. └── requirements.txt
  298. ```
  299. ---
  300. ## 测试
  301. 运行全部测试:
  302. ```bash
  303. cd forge-skill
  304. pip install pytest
  305. pytest tests/ -v
  306. ```
  307. 测试覆盖:
  308. | 模块 | 测试文件 | 覆盖内容 |
  309. |------|----------|----------|
  310. | persona_schema | test_persona_schema.py | 实例化、序列化、反序列化、参数校验 |
  311. | persona_validator | test_persona_validator.py | 结构校验、参数范围、证据覆盖率、缺失字段检测 |
  312. | persona_runtime_loader | test_runtime_loader.py | chat/decision/variant 三种卡片生成、字段完整性 |
  313. | skill_writer | test_skill_writer.py | MD/JSON 读写、版本管理、纠正追加、名称清洗 |
  314. | version_manager | test_version_manager.py | diff 生成、快照存档、版本列表 |
  315. | decision_logger | test_decision_logger.py | 决策记录、结果回填、列表查询 |
  316. | parsers | test_parsers.py | 模块导入、数据结构、基本解析 |
  317. ---
  318. ## 隐私
  319. 所有数据本地处理,人格档案本地存储(`personas/` 已 gitignore),不依赖远程服务器。原始聊天记录和记忆不会离开你的机器。素材解析器只提取人格信号(说话风格、情绪模式、决策习惯),不存储原始内容。
  320. ---
  321. ## 搜索关键词
  322. 人格蒸馏、数字替身、自我反思、决策辅助、聊天记录人格提取、微信聊天记录分析、Claude Code Skill、local-first AI、persona distillation、digital persona、self-reflection、decision support、roleplay agent、memory-based roleplay、multi-agent debate
  323. ---
  324. ## 路线图
  325. - 更丰富的数据源支持(QQ、钉钉、飞书、Telegram)
  326. - 更强的多 agent 辩论调度
  327. - 角色扮演 anti-drift 强化
  328. - 决策追踪闭环与参数反哺
  329. - 怀念故人应用(基于 forge-persona 的情感向产品)
  330. - 更稳定的人格一致性,让替身更像"ta"
  331. - 更轻量的启动方式,降低上手门槛
  332. - 替身决策会议的可视化报告
  333. - Web UI(让不会 CLI 的人也能用)
  334. ---
  335. ## 致谢
  336. 设计灵感来自 [ex-skill](https://github.com/therealXiaomanChu/ex-skill) 和 [colleague-skill](https://github.com/titanwings/colleague-skill)。
  337. ---
  338. ## License
  339. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.