yida-export-conversation

name: yida-export-conversation description: 导出 AI 对话记录，生成结构化的 Markdown 文档。支持 Claude Code 自动检测，其他环境通过 --input 手动指定。不适用于：导出宜搭表单数据（应使用 yida-data-management），或导出应用配置（应使用 openyida export-app 命令）。

导出 AI 对话记录

严格禁止 (NEVER DO)

• 不要在非 Claude Code 环境下省略 --input 参数（其他环境无法自动检测对话文件）

严格要求 (MUST DO)

• 导出前确认当前环境（openyida env），Claude Code 环境可自动检测，其他环境需 --input 手动指定
• 导出前必须确认输出路径有写权限，避免导出失败
• 导出完成后必须告知用户文件路径和文件大小，方便用户确认
• 遇到对话文件格式不支持时，必须明确告知用户支持的格式（.jsonl）
• 本技能不读写 memory：对话记录导出为本地 Markdown 文件，不依赖跨会话的 memory 状态

适用场景

用户需要"导出对话记录"、"保存 AI 对话"、"生成开发文档"时使用。 无需登录宜搭，为纯本地操作。

触发条件

正向触发：

• "导出对话记录"、"保存 AI 对话"
• "生成开发文档"、"导出本次对话"
• "把对话记录存下来"

不适用场景（不要触发）：

• 导出宜搭表单数据 → yida-data-management
• 需要实时同步对话内容 → 本技能为一次性导出，不支持实时同步
• 非 Claude Code 环境且未提供 --input 参数 → 提示用户手动指定对话文件

将 AI 对话记录导出为结构化的 Markdown 文档，方便分享和存档。

命令

openyida export-conversation [options]

支持的 AI 工具环境

输出格式

生成的 Markdown 文档包含以下内容：

1. 概要信息

   • 应用名称
   • AI 工具环境
   • 导出时间
   • 对话轮次
   • 工具调用次数

2. 关键步骤摘要

   • 从工具调用中自动提取的操作步骤

3. 完整对话记录

   • 用户消息
   • AI 回复
   • 工具调用及执行结果

使用示例

# 导出最近一次对话（自动检测环境）
openyida export-conversation

# 导出到指定文件
openyida export-conversation --output ./my-conversation.md

# 从指定文件导入对话记录
openyida export-conversation --input ./conversation.jsonl

# 列出可用的对话记录
openyida export-conversation --list

前置条件

• 无需登录宜搭（对话导出是本地操作）
• Node.js ≥ 18

注意事项

1. 目前 MVP 版本主要支持 Claude Code 的对话记录自动检测
2. 其他 AI 工具环境请使用 --input 手动指定对话文件
3. 后续版本将支持发布到宜搭社区和钉钉群

异常处理

Agent 错误处理策略

当 Agent 执行本技能遇到错误时，必须遵循以下默认行为：