用途:为个人在多个设备和工具(如 Codex、Cursor、Claude Code)之间建立、审计、对账、验证或迁移用户级编码智能体环境。核心判断是:什么最小化的用户级工作流来源,能让人重建并演进既定的智能体能力与工作约定,同时不复制密钥、不透明状态或偶然的机器历史。
主要能力:负责清单分类、可移植工作流来源的形成、三方对账、迁移回执与常规入口验证。不负责项目指令、供应商账号、密钥存储、工具实现、组织策略或个人工作约定的接受。已有可信 dotfiles 或配置管理器时,应复用其作为载体,而非新建框架。
使用方式:命令分派包括 audit、setup、reconcile、migrate、verify,分别读取并遵循对应命令文件;无参数时先做只读审计,不得从“检查或建议”的请求推断出修改用户级文件的权限。未获写入授权时,在清单与建议对账后停止。绝不打印、复制、提交或让模型总结密钥值、认证数据库、会话记录、缓存或机器标识。
核心方法:先恢复意图再处理文件;通过受支持界面盘点安装来源、版本、用户指令、技能/插件、MCP 与钩子声明、权限策略和认证状态,记录路径与存在性并脱敏;对每项分类为期望来源、工具投影、密钥前置、机器本地状态、本地覆盖或未知;选择最小载体;按当前官方文档逐工具规划,优先使用受支持的导入、安装器、设置命令或结构化合并;对账来源演进而非仅文件;应用时不夺取所有权,备份或检查点,按键合并结构化配置;密钥单独再水合,由人工完成交互授权;通过常规入口路径验证,每个工具做一次无害行为或能力探测;返回对账回执,报告已应用、保留、推迟、不支持与失败项。
适用场景:个人跨设备智能体工作流的搭建、演进与迁移;仓库内智能体行为应交给项目 AGENTS.md、CLAUDE.md 或规则;通用 shell/编辑器/包 dotfiles 交给现有配置管理方法;密钥、登录、账号或供应商授权由人工加受支持凭据流程处理;组织级强制策略由管理员与托管配置负责。
限制:不得让某一供应商的隐藏目录成为跨工具事实来源;默认不迁移聊天、会话、记忆、缓存、遥测、索引、UI 布局或设备标识;不把每个设置跨工具翻译;不使生成的工具配置双向权威;不把当前供应商路径或键写死为通用准则;认证、常规入口探测或未解决冲突未完成时不得声称设置完成;安装后不要求特定工具、操作系统、dotfiles 管理器或本仓库。完成标准要求可移植工作流来源与人类所有者明确、每项有状态分类、区分来源与目标漂移、密钥与本地状态留在可移植来源之外、现有目标内容有回滚路径、每个工具通过常规入口验证或明确推迟,且回执说明剩余人工工作。