/ 目录 / 演练场 / forge-skill
● 社区 YIKUAIBANZI ⚡ 即开即用

forge-skill

作者 YIKUAIBANZI · YIKUAIBANZI/forge-skill

Local-first personality distillation engine — analyze your own patterns (forge-self) or preserve a loved one's voice (forge-persona) from chat records and journals.

人格蒸馏引擎. A local-first, no-server skill that parses chat records, diaries, and social media to distill communication patterns into two artifacts: self profiles (your own decision patterns and blind spots) and persona profiles (someone else's distinctive voice). Then lets you use-self to consult variant versions of yourself, or use-persona to roleplay with someone's preserved voice. Not resurrection — an echo, local, iterative, and under your control.

为什么要用

核心特性

实时演示

实际使用效果

forge-skill.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "forge-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/YIKUAIBANZI/forge-skill",
        "~/.claude/skills/forge-skill"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "forge-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/YIKUAIBANZI/forge-skill",
        "~/.claude/skills/forge-skill"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "forge-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/YIKUAIBANZI/forge-skill",
        "~/.claude/skills/forge-skill"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "forge-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/YIKUAIBANZI/forge-skill",
        "~/.claude/skills/forge-skill"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "forge-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/YIKUAIBANZI/forge-skill",
        "~/.claude/skills/forge-skill"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "forge-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/YIKUAIBANZI/forge-skill",
          "~/.claude/skills/forge-skill"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add forge-skill -- git clone https://github.com/YIKUAIBANZI/forge-skill ~/.claude/skills/forge-skill

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: forge-skill

Consult variants of yourself before a hard decision

👤 People facing tricky life/career decisions who want structured self-reflection ⏱ ~60 min intermediate

何时使用: A fork-in-the-road decision where you want to hear your own conflicting voices.

前置条件
  • Skill installed — git clone https://github.com/YIKUAIBANZI/forge-skill ~/.claude/skills/forge-skill
  • Raw material: journals / chat export — Collect into a local folder the skill can read
步骤
  1. Build self profile
    Use forge-self on /path/to/my-journals and chats. Distill patterns, decision tendencies, blind spots.✓ 已复制
    → Local profile written with identified patterns
  2. Consult variants
    use-self. Decision: accept the offer or stay. Give me 'cautious me', 'decisive me', 'relationship-focused me' perspectives.✓ 已复制
    → Three distinct voices, not bland averages

结果: A decision you made after hearing your own contradictions.

注意事项
  • Expecting one 'right' answer to pop out — The skill's promise is perspective, not prescription
搭配使用: filesystem

Preserve the voice of a loved one you've lost touch with or lost

👤 People wanting to keep an echo of someone important ⏱ ~120 min intermediate

何时使用: You have old messages/journals and want to keep their voice accessible.

前置条件
  • Chat exports, journals, social posts — Gather into a local folder
步骤
  1. Build persona
    Use forge-persona on this archive of my grandmother's letters. Distill her voice.✓ 已复制
    → Persona file capturing style, vocabulary, quirks
  2. Use the persona
    use-persona — talk to me about my job stress the way she would.✓ 已复制
    → Response that recognizably sounds like her — not generic
  3. Correct iteratively
    That phrase wasn't quite her — here's how she'd actually say it.✓ 已复制
    → Profile updated, next response better

结果: An echo you can sit with, fully under your control.

注意事项
  • Treating it as the person rather than an echo — The skill explicitly warns: this is not resurrection. Hold it as a tool for reflection
搭配使用: filesystem

Audit your own communication patterns over a year

👤 Self-improvement-minded people ⏱ ~60 min beginner

何时使用: Year-end review with a twist.

步骤
  1. Run forge-self on a year's worth
    Run forge-self on my 2025 chat + journal archive. Compare to 2024 if data exists. What changed?✓ 已复制
    → Pattern delta with specifics

结果: Actual data about how your communication evolved.

组合

与其他 MCP 搭配,撬动十倍杠杆

forge-skill + filesystem

Archive sources and profile artifacts in one managed local folder

Organize my journal exports under ~/forge/sources/ and profiles under ~/forge/profiles/.✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
forge-self archive path Build your own digital mirror 0 — local
forge-persona archive path, person name Preserve another's voice 0 — local
use-self question + variant choice Decision reflection 0
use-persona question Voice-preserved conversation 0

成本与限制

运行它的成本

API 配额
None
每次调用 Token 数
Large on initial distillation (journals can be big)
费用
Free
提示
Distill once, reuse many times — the profile is persistent

安全

权限、密钥、影响范围

最小权限: Read on your source folders, write on the profile folder
凭据存储: None — fully local
数据出站: LLM call processes the data — choose a provider whose policy you're comfortable with
切勿授予: Network egress for the profile data — stays on your disk

故障排查

常见错误与修复

Distilled profile feels generic

Supply more source material, especially distinctive pieces

Persona drifts over many turns

Periodically correct; the skill learns from your corrections

替代方案

forge-skill 对比其他方案

替代方案何时用它替代权衡
Writing in a regular journalYou just want reflection, not distillationNo variant consultation

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills