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

凭据（第0级审计结论 + 4 级解析）

第0级审计结论：git token 无法由 sessionToken 自举。 经实测（2026-09）：

• Gogs 网页 session（cookie i_like_gogs）仅对网页 UI 有效，Gogs API 层不识别；
• Gogs API 无"sessionToken → git token"签发端点（token 创建本身要求 Basic Auth 或已有 token）。

因此 git token 需要一次性初始化（一条命令，之后永久使用）：

# 一次性创建 git token（用网页登录密码，非 sessionToken）
curl -u "<你的用户名>:<你的密码>" -X POST \
  https://git.fmode.cn/api/v1/users/<你的用户名>/tokens \
  -H "Content-Type: application/json" -d '{"name":"agent-clone"}'
# → 响应里的 sha1 即 git token，写入 ~/.fmode/config.json 的 gitToken 字段

初始化后，运行器按以下 4 级链解析（第1级起与 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 只写"哪个密钥存在哪"。 token 缺失时运行器明确报错并给出初始化命令，不再使用任何硬编码凭据。

License

MIT