Symbiotic AI

将一次对话转化为清晰的下一步，以及一个可以持续使用的系统。Symbiotic AI 为任何模型提供了一种持久的方式，使其能够在不同会话间携带你的上下文、承诺和当前方向。

观看教程

系统架构

该系统设计简洁：通过一小套文件，将一次有用的会话转化为持续的上下文。

文件	用途	更新频率
SOUL.md	Agent（智能体）的人格、身份、价值观，以及其思考和对话方式	每月
USER.md	你的个人档案：身份、心理特征、思维模式、使命、精力模式	每月
AGENTS.md	Agent 的运作方式：协议、工具、模式、干预措施	每周
NOW.md	当前状态：任务、队列、日志、活跃项目、截止日期	每日

Agent 在会话开始时读取全部 4 个文件。在你工作时更新 NOW.md。系统使用时间越长会越智能——并非因为 AI 本身的改进，而是因为这些文件积累了关于你的真实上下文。

与众不同之处

它会挑战你。 来自真实对话：

AI: "你发现了一些有价值的东西 → 人们想要它 → 你对这种交换感到厌恶 → 你免费赠送 → 你没有钱 → 重复。这不是理想主义。这是自我惩罚。"

它会记住。 跨会话的持久记忆。模式、引用、历史记录都存储在你的文件中。

它会行动。 编写代码、进行研究、创建文件。不仅仅是提供建议。

它会进化。 经过 100 多次会话后，你的文件将包含关于什么对你有效来之不易的洞察。没有泛泛而谈的建议。你的模式、你的问题、你的胜利。

安装

Hermes Agent（推荐）

安装 Hermes，将此仓库克隆为你的工作区，然后在其中启动 Hermes：

# 1) 安装 Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # 或: source ~/.zshrc

# 2) 克隆你的 Symbiotic 工作区
git clone https://github.com/lout33/symbiotic-ai ~/symbiotic-ai
cd ~/symbiotic-ai

# 3) 可选但推荐：在 Hermes 中全局使用 Symbiotic voice
mkdir -p ~/.hermes
cp SOUL.md ~/.hermes/SOUL.md

# 4) 从工作区内启动 Hermes
hermes

Hermes 的文件放置方式：

• SOUL.md -> 全局 voice（声音）位于 ~/.hermes/SOUL.md
• AGENTS.md、USER.md、NOW.md -> 存放在你的工作区/项目根目录
• 从该工作区运行 hermes，以便 Agent 以你的当前上下文启动

如果你已有 ~/.hermes/SOUL.md，请合并而不是覆盖它。

Claude Code / opencode 快速安装器

curl -fsSL https://raw.githubusercontent.com/lout33/symbiotic-ai/main/install.sh | bash

手动克隆

git clone https://github.com/lout33/symbiotic-ai
cd symbiotic-ai

系统如何进化

1. 第 1-2 周： 填写 SOUL.md（Agent 是谁？）、USER.md（你是谁？）、AGENTS.md（基本规则）、NOW.md（你在做什么？）
2. 第 1 个月： Agent 开始注意到你的模式。NOW.md 日志不断增长。你逐渐了解什么有效。
3. 第 2 个月及以后： 根据需要添加可选文件。里程碑自然累积。
4. 持续进行： 随着你对自己和 Agent 人格的了解加深，SOUL.md 和 USER.md 会不断精炼。

示例

不确定填写后的文件是什么样子？examples/ 文件夹包含 3 个完整的配置示例，展示了系统经过数周真实使用后的样子：

• jamie/ —— 22 岁的计算机科学学生，在课程、实习申请和副业项目之间周旋
• sam/ —— 30 岁的中级开发者，专注于职业发展和面试准备
• morgan/ —— 35 岁的营销经理，将 AI 集成到其工作流程中

每个示例都包含填写了真实数据的全部 4 个文件。从根目录模板开始，将其变成你自己的。

记忆日志

在 NOW.md 中，Agent 维护一个带有日期的模式、引用和洞察日志：

### Jan 10
- Avoided user call. Rescheduled twice. Pattern: building = safe, talking = scary.

### Jan 15
- Had first user call. Quote: 'I've been building what I think they want instead of asking'

### Feb 1
- Pattern confirmed: 3 weeks on feature nobody asked for. This is the 3rd time.

命令

命令	功能
/start-day	晨间启动。设定当天的 MIT（最重要事项）。
/check-day	快速问责检查。
/end-day	晚间回顾。记录胜利和教训。
/reflect	深度反思。浮现模式。创建日志条目。

命令可手动执行或通过 cron 定时调度。详见 commands/README.md。

可选文件

系统与你共同成长。只需创建文件，Agent 就会发现并使用它。

一级可选文件

这些是核心 4 个文件之后首先添加的文件。

文件	用途	何时添加
COMMITMENTS.md	说到 vs 做到的追踪	如果你需要更强的问责、模式检测和"你之前说过"的干预，这是第一个要添加的可选文件
WINS.md	已完成的项目、里程碑、模式突破	当你需要证据证明自己正在取得进展时
IDEAS.md	快速记录想法	当想法来得比你能行动的更快时
LOG_ARCHIVE.md	从 NOW.md 归档的记忆日志	当 NOW.md 变得太长时

其他可选文件

文件	用途	何时添加
JOURNAL.md	更长篇幅的反思	当会话深度不够时

HEARTBEAT：屏幕感知问责

可选功能。你的 AI 监控你的屏幕活动，将其与 NOW.md 中的任务进行对比，并在你偏离时通过 Telegram 提醒你。

[14:30] DOING: VS Code - building landing page components
SHOULD: Ship landing page
Flow state. Keep going.

[15:15] DOING: YouTube - watching programming streams (45 min)
SHOULD: Ship landing page
You know what you should be doing.

由 OpenClaw + what-did-i-do 屏幕追踪器提供支持。设置指南

互操作性

一个目录，多种接口：

框架	配置	最适合
Hermes Agent	将 AGENTS.md、USER.md 和 NOW.md 放入工作区。可选：将 SOUL.md 复制到 ~/.hermes/SOUL.md 以获得稳定的全局 voice（声音）。从工作区根目录运行 hermes。	完整的 Agent 运行时：工具、记忆、网络、代码执行、自动化
OpenClaw	在 ~/.openclaw/openclaw.json 中设置 workspace	HEARTBEAT、Telegram、定时检查
Claude Code	~/.claude/CLAUDE.md（合并 4 个文件）	深度编码会话
opencode	~/.config/opencode/ 或项目根目录	基于终端的会话

内容该放哪里

问题	答案
"这个内容下周会改变吗？"	会 -> NOW.md。不会 -> 它所属的 stable 文件。
"这是关于 agent（智能体）还是 user（用户）？"	agent（智能体）-> SOUL.md。user（用户）-> USER.md。
"这是 protocol（协议）还是 personality（个性）？"	protocol（协议）-> AGENTS.md。personality（个性）-> SOUL.md。
"不确定？"	先放进 NOW.md。之后再移动。

社区

GitHub Discussions -- 提问、分享你的配置、提出想法。

展示你的 Symbiosis： 在 Show and tell 中发布你的配置。你的 SOUL.md 个性设置、对话截图、自定义命令。可以理解为 r/unixporn 的 AI agent（智能体）版本。

想要参与贡献？参见 CONTRIBUTING.md。

理念

Symbiotic（共生）> Assistive（辅助）。Challenge（挑战）> Validate（验证）。Memory（记忆）会不断累积。Ship ugly（先发布，再完善）。

生态系统

项目	功能
OpenClaw	个人 AI 助手运行时。驱动 HEARTBEAT、Telegram、cron。
what-did-i-do	基于 Gemini Vision 的被动屏幕追踪器
writing-style-skill	让 AI 像你一样写作

---

由 @lout33 创建

Symbiotic AI 快速上手指南

Symbiotic AI 是一个让 AI 模型具备持久记忆的系统。通过 4 个核心文件，它将单次对话转化为可延续的上下文，使 AI 能够记住你的身份、承诺、当前状态及思维模式，并随使用时间进化。

环境准备

• 操作系统: Linux / macOS (Windows 建议使用 WSL)
• 依赖工具:
  • git
  • bash / zsh
  • 推荐运行时: Hermes Agent (功能最全)
  • 备选运行时: Claude Code 或 opencode
• 网络要求: 需能够访问 GitHub 及外部资源

安装步骤

方案一：Hermes Agent（推荐）

此方案支持完整的代理运行时，包括工具调用、记忆管理和自动化。

# 1) 安装 Hermes Agent
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc  # 或：source ~/.zshrc

# 2) 克隆 Symbiotic 工作区
git clone https://github.com/lout33/symbiotic-ai ~/symbiotic-ai
cd ~/symbiotic-ai

# 3) 配置全局 Agent 人格 (可选但推荐)
mkdir -p ~/.hermes
cp SOUL.md ~/.hermes/SOUL.md

# 4) 在工作区内启动 Hermes
hermes

方案二：快速安装 (Claude Code / opencode)

适用于已有 Claude Code 或 opencode 环境的用户。

curl -fsSL https://raw.githubusercontent.com/lout33/symbiotic-ai/main/install.sh | bash

方案三：手动克隆

git clone https://github.com/lout33/symbiotic-ai
cd symbiotic-ai

基本使用

1. 核心文件配置

系统依赖根目录下的 4 个 Markdown 文件，Agent 会在会话开始时读取它们：

文件	用途	更新频率
SOUL.md	Agent 的人格、身份、价值观及沟通方式	每月
USER.md	你的档案：身份、心理模式、使命、能量规律	每月
AGENTS.md	操作协议：工具使用、模式、干预规则	每周
NOW.md	当前状态：任务、队列、日志、活跃项目、截止日期	每日

初始化建议：

1. 复制 examples/ 文件夹中的示例（如 examples/jamie/）作为参考。
2. 根据示例填充上述 4 个文件，使其符合你的实际情况。
3. 随着使用，NOW.md 会积累日志，SOUL.md 和 USER.md 会随自我认知深化而迭代。

2. 常用命令

在会话中使用以下命令管理日常流程（支持手动输入或 cron 调度）：

命令	功能
/start-day	晨间启动，设定当日最重要任务 (MIT)
/check-day	快速责任检查
/end-day	晚间复盘，记录胜利与教训
/reflect	深度反思，挖掘模式并创建日记条目

3. 文件管理原则

• 变动内容: 如果内容下周会变 -> 放入 NOW.md。
• 稳定内容: 如果内容长期稳定 -> 放入对应的稳定文件 (SOUL/USER/AGENTS)。
• 不确定: 先放入 NOW.md，后续再迁移。

4. 进阶功能 (可选)

• 记忆归档: 当 NOW.md 过长时，创建 LOG_ARCHIVE.md 归档旧日志。
• 屏幕感知 (HEARTBEAT): 结合 OpenClaw 和屏幕追踪工具，监控屏幕活动并与任务比对，防止分心。详见 guides/heartbeat-setup.md。
• 多框架互操作: 同一目录可被 Hermes、OpenClaw、Claude Code 等多个框架读取，实现上下文共享。