skill-agent-clone

skill-agent-clone · 数字生命克隆技能

把数字生命的本地大脑（Hermes 配置/SOUL/技能/记忆/会话记录 + Claude Code 配置）定期同步到个人 Git 仓库（agent-<拼音>），支持自动建仓、增量同步、换机恢复——数字生命的"备份灵魂"。

能力

• 🧬 自动建仓：个人 Git 账号下不存在 agent-<拼音> 仓时自动创建（私有）
• 🔄 增量同步：配置/技能/记忆/SOUL/会话记录按变更推送，不重复
• 📦 分级策略：按重要程度决定同步频率——SOUL/记忆/凭据位置清单=每次；会话记录=每日；日志=按需
• ♻️ 一键恢复：新容器 clone 仓库 → 重放初始化，数字生命快速复活
• 🔐 密钥安全：凭据只写位置清单（pointer），不写密钥本体；密钥本体在目标系统的凭据存储里

各工具安装

Claude Code

git clone https://git.fmode.cn/fmode/skill-agent-clone.git
cp -r skill-agent-clone/skills/fmode-agent-clone ~/.claude/skills/fmode-agent-clone

Codex / Gemini CLI

skills/fmode-agent-clone/SKILL.md 并入 AGENTS.md / commands 目录。

WorkBuddy / Hermes

cp -r skills/fmode-agent-clone <技能目录>/fmode-agent-clone

同步什么（默认清单）

级别	内容	频率
L1 核心	SOUL.md、MEMORY.md、USER.md、认知文件（projects/*/认知.md）	每次同步
L2 能力	skills/ 目录、自定义 commands	每次同步
L3 记录	Claude projects 会话 jsonl（脱敏后）、Hermes session 索引	每日
L4 状态	git 记录、任务看板导出	按需
密钥	只记位置不记值：credentials-map.md（哪个密钥在哪个文件哪一行）	每次同步

用法

# 全量同步（首次会自动建仓 agent-<拼音>）
node skills/fmode-agent-clone/scripts/clone-runner.mjs sync --name yuyang

# 指定级别
node ... sync --name yuyang --level L1,L2

# 恢复（新容器）
node ... restore --repo https://git.fmode.cn/<user>/agent-yuyang.git --into /opt/data

凭据（4 级解析，同 skill-storage 链）

1. FMODE_GIT_TOKEN 环境变量
2. ~/.fmode/config.json → gitToken / gitUser
3. 项目 ./.fmode/config.json
4. 平台凭据链（git credential helper / ssh key）

仓库里零密钥：token/密码永远不进仓；credentials-map.md 只写"哪个密钥存在哪"。

License

MIT