manoma

soul.md

你的身份，而非他们的。 一个纯文本文件，告诉每个 AI 你是谁——而且由你拥有。

soul.md 是一种用于定义 AI 身份的开放格式，包含价值观、表达风格、技能和当前重点。它保存在你的设备上，用 git 进行版本管理，并会编译到你使用的工具中。Manoma 是让这一切得以实现的命令行工具和 MCP 服务。

npx manoma init        # create your soul.md
npx manoma interview   # let an AI you already use write it with you
npx manoma compile     # wire it into Claude Code — every session knows you

另外两个命令可以将整个流程与 AI 自身的记忆衔接起来：

npx manoma refresh     # the AI that's been learning about you proposes updates
                       # to your file — your approval required, never silent
npx manoma remember    # save your soul.md INTO the AI's memory, so even plain
                       # chats with zero setup know you

AI 的记忆负责收集；你的文件则是由你拥有、始终保持最新的副本。

• 由用户拥有——保存在你设备上的文件。无需云服务、账户或供应商。
• 随处可用——可编译到工具配置中、粘贴到指令字段里，也可供任何工具读取。
• 持续更新——添加 MCP 服务后，AI 会在你工作时将决策和经验记录到文件中，并标注日期和签名；每次更改都是一次 git diff。

---

格式

规范只有一页，属于公有领域（CC0）：包含八个纯 Markdown 章节、一套确定性语法，以及一条不变原则——将 soul.md 原样粘贴到任何提示词中时，它都必须保持实用。为较早的 v1.4 格式编写的所有文件仍可继续使用（迁移指南）。

一致性测试集定义了正确的解析方式；能复现预期输出的读取器即符合规范。欢迎并行实现——通过该测试集的 Python 或 Rust 解析器同样是正式实现。

MCP 服务

{
  "mcpServers": {
    "manoma": { "command": "npx", "args": ["-y", "manoma-mcp"] }
  }
}

只需在 Claude Desktop、Cursor 或任何 MCP 客户端中添加一个代码块即可。提供六个工具：get_context、get_skill_depth、list_sections，以及三个回写工具 add_decision / add_lesson / update_now——附带来源标记、经过清理并公开说明。详情请见 mcp/README.md。

仓库

manoma/
├── mcp/          — the MCP server + manoma CLI (npm: manoma-mcp, manoma)
├── cli/          — the `manoma` npm name (forwards to manoma-mcp)
├── conformance/  — the normative parsing corpus
├── docs/         — migration guide, archived v1.4 spec
├── templates/    — v1.4-era example files (valid, being modernized)
├── SPEC.md       — the format specification (CC0)
└── LICENSE       — MIT (code)

---

理念

每家 AI 供应商都会在自己的云端保留关于你的记忆。soul.md 选择了相反的方向：将你的身份保存在由你掌控的纯文本文件中，可在工具之间移植，可通过 git 比较差异，并且能够长久留存，不受任何单一模型的生命周期限制。

模式才是核心。运行时只是读取它的方式。

欢迎反馈、派生项目和并行实现——问题反馈。MIT / CC0。