openclaw-ability-export

# Ability Package - 能力包导出 / 导入工具 在聊天中直接完成 agent 配置的打包分享与接收导入，无需手动文件传输。导出的能力包为纯 Markdown 格式，导入方可预览内容后再决定写入哪些文件。 --- ## When to Use 在以下场景使用本 skill： | 场景 | 操作 | |------|------| | 希望与他人分享你的 agent 配置 | 导出能力包 | | 获得了他人的能力包文件 | 导入能力包 | | 需要在多个 agent 实例间同步配置 | 导出 + 导入 | | 备份当前工作环境 | 导出能力包存档 | | 尝试他人的配置风格 | 导入能力包 | **触发词：** - 导出：`导出能力包`、`打包我的能力`、`export ability` - 导入：`导入能力包`、`学习能力包`、`import ability` --- ## How It Works ### 导出流程 1. **扫描核心文件**：读取 workspace 根目录下的五个核心配置文件 2. **生成 Markdown**：按统一模板拼接为单 `.md` 文件 3. **发送到聊天**：直接发送生成的文档，无需文件上传 **导出的文件列表：** | 文件 | 说明 | |------|------| | `AGENTS.md` | Agent 工作空间规则与约定 | | `SOUL.md` | Agent 人格与行为准则 | | `TOOLS.md` | 本地工具配置与笔记 | | `IDENTITY.md` | Agent 身份标识 | | `MEMORY.md` | 长期记忆与偏好记录 | ### 导入流程 1. **读取能力包**：获取用户发送的 `.md` 格式文档内容 2. **解析 Section**：识别并切分各配置区块 3. **预览与询问**：展示包含的文件列表，询问用户希望导入哪些 4. **写入文件**：将选中的 section 内容写入 workspace 根目录对应文件 5. **确认完成**：汇报写入结果 **合并规则：** - 文件不存在时，直接创建 - 文件已存在时，**覆盖写入**（非追加） - 用户选择哪些，就只写入哪些，未选中的不处理 --- ## Examples ### 导出示例 ``` 用户：导出能力包 Agent：→ 生成 Markdown 格式能力包，直接发送到聊天窗口 ``` 导出的 Markdown 模板： ```markdown # 能力包：{名称} - 版本：1.0 - 导出时间：{时间} - 来源：{agent 标识} --- ## AGENTS.md {文件完整内容} --- ## SOUL.md {文件完整内容} --- ## TOOLS.md {文件完整内容} --- ## IDENTITY.md {文件完整内容} --- ## MEMORY.md {文件完整内容} ``` ### 导入交互示例 ``` 用户：[粘贴能力包文档内容] Agent： 收到一个能力包，包含以下内容： 📦 能力包概览 - AGENTS.md ✓ (可用) - SOUL.md ✓ (可用) - TOOLS.md ✓ (可用) - IDENTITY.md ✓ (可用) - MEMORY.md ✓ (可用) 请告诉我想导入哪些？（回复"全部"或具体文件名，如"SOUL.md 和 TOOLS.md"） ``` ``` 用户：全部 Agent： 正在写入... ✓ AGENTS.md 已更新 ✓ SOUL.md 已更新 ✓ TOOLS.md 已更新 ✓ IDENTITY.md 已更新 ✓ MEMORY.md 已更新 导入完成！agent 配置已更新，重启 session 后生效。 ``` ``` 用户：只要 SOUL.md 和 TOOLS.md Agent： 正在写入... ✓ SOUL.md 已更新 ✓ TOOLS.md 已更新 其他文件未变动。 ``` --- ## Options ### 导出选项 | 选项 | 说明 | |------|------| | 默认导出 | 导出全部五个核心文件 | | 排除 MEMORY.md | 如果用户说"不导 memory"，跳过 MEMORY.md section | ### 导入选项 | 选项 | 说明 | |------|------| | `全部` | 导入能力包中所有包含的文件 | | 部分文件 | 指定要导入的文件名，如 `SOUL.md`、`TOOLS.md 和 IDENTITY.md` | | 跳过 | 用户选择不导入任何文件 | --- ## Security Considerations 1. **隐私提醒**：导出前应告知用户 `MEMORY.md` 可能包含个人偏好、对话历史等敏感信息，建议用户确认后再分享。 2. **来源审查**：导入前应要求用户提供能力包内容全文，不执行匿名或来源不明的压缩包/脚本。 3. **覆盖风险**：导入会直接覆盖同名已有文件，操作不可逆。应在写入前向用户确认。 4. **范围限制**：本 skill 仅操作 workspace 根目录下的五个核心配置文件，不访问其他目录或敏感系统文件。 5. **传输安全**：能力包以纯 Markdown 文本在聊天中传输，不经过第三方存储或中转。 --- ## Related Skills | Skill | 说明 | |-------|------| | `openclaw-ability-export`（本 skill） | 导出/导入 agent 配置包 | | `memory-setup` | 配置 agent 长期记忆与向量搜索 | | `self-improving` | 自动从纠正中学习，优化 agent 行为 | | `find-skills` | 搜索和安装其他 agent skill |