SuperAPI AI 工具集

capture-desktop

办公与效率

查看项目

更新于 10-15 14:10

技能介绍

用途

capture-desktop 是 scripts/check_desktop_sync.py 的设备侧镜像。后者管理设备到云端的同步,而本技能管理云端到设备的捕获。由于 claude.ai 没有 API,捕获采用粘贴驱动:用户粘贴已完成的 Desktop 会话,技能将其内容路由到磁盘上的正确位置。

主要能力

  • 接收用户粘贴的 Desktop 对话内容,或接受文件路径。
  • 通过辅助脚本暂存逐字、去重的转录文本。
  • 将实质性内容分类为四个桶:交付物、决策/规则/经验教训、项目知识变更、完整日志。
  • 自动归档交付物到工作文件夹下的指定路径。
  • 对决策/规则/经验教训逐项确认后写入记忆文件、wiki 条目或反馈记忆。
  • 对项目知识变更逐项确认后编辑规范源(mel_wiki/ 页面、~/.claude/CLAUDE.md)。
  • 运行同步检查,报告漂移。
  • 提交并推送工作文件夹变更。
  • 输出捕获报告。

使用方式

步骤 1 — 获取内容

请用户粘贴 Desktop 对话,或接受其提供的文件路径。如果粘贴内容较长,先写入临时文件以避免截断。

步骤 2 — 暂存转录文本

运行辅助脚本暂存逐字、去重的转录文本:

python scripts/capture_desktop.py stage --input <tempfile> --title "<short title>"

退出码 0:打印转录路径,继续。

退出码 3:[DUP] 已捕获 — 此会话之前已捕获。告知用户并停止,除非用户确认仍要重新路由。

转录文本仅本地保存(gitignored,由 OneDrive 备份)。暂存的转录文本即“完整日志”桶,该桶无需进一步操作。

步骤 3 — 分类内容

阅读暂存的转录文本,将其实质性内容分入四个桶:

  • 交付物 — 用户产出的文档、分析、表格、草稿。
  • 决策/规则/经验教训 — 已锁定的决策、框架调用、关于系统应如何工作的指导、对行为的反馈。既捕获成功也捕获纠正:转录中显示用户称赞、复用或锁定的方法,是值得作为反馈记忆存入的成功案例(附 Why: 和 How to apply:),以便 /improve-system 趋势确认成功,而不仅是纠正。
  • 项目知识变更 — 属于规范源的编辑(mel_wiki/ 页面、~/.claude/CLAUDE.md)。
  • 完整日志 — 已在步骤 2 暂存,无需操作。

如果某个桶为空,说明为空。不要编造内容填充。

步骤 4 — 路由每个桶

交付物(自动归档)。在工作文件夹下提议路径,用 Write 工具保存,并在摘要中命名。当目标文件存在时,应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

决策/规则/经验教训(逐项确认)。对每一项,提议目标 — 记忆目录下的记忆文件、wiki 条目或反馈记忆 — 并展示将要写入的确切内容。在写入前获得用户的 yes/no。当目标文件存在时,应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

项目知识变更(逐项确认)。对每一项,提议对规范源的确切编辑并获得 yes/no。用 Edit 工具应用变更,范围受限。当目标文件存在时,应用 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

对于 mel_wiki/ 编辑:暂存以供步骤 5 的工作文件夹提交。

对于 ~/.claude/CLAUDE.md 编辑:应用后,通过运行以下命令跨仓库提交:

bash ~/.claude-config-clone/scripts/sync-from-local.sh --auto "capture-desktop: <one-line reason>"

这会将实时 CLAUDE.md 复制到 claude-config 克隆中,进行协调、提交并推送。如果没有任何变更,它会静默退出 0。

步骤 5 — 闭环并提交

如果任何规范源被编辑(wiki 或 CLAUDE.md),运行同步检查,以便 Desktop 项目的重新上传标志触发:

python scripts/check_desktop_sync.py

报告其发现的任何 [DRIFT]。然后提交工作文件夹变更(仅交付物和 mel_wiki/ 编辑 — 转录文本被 gitignored)。按名称暂存,绝不使用 git add -A:

git add <deliverable paths> <mel_wiki paths>
git commit -m "feat(capture): desktop session <slug> — <what landed>"
git push

步骤 6 — 报告

交付简洁摘要:

CAPTURE-DESKTOP — <date>
  Transcript: desktop-captures/<slug>/transcript.md (local)
  Deliverables: <list or none>
  Decisions/rules written: <list or none>
  Canonical edits: <list or none> (CLAUDE.md pushed to claude-config: yes/no)
  Sync check: <in sync / N drift flagged>
  Commit: <short-SHA> pushed / nothing to commit

适用场景

  • 用户在 Claude Desktop 应用中完成会话后,希望将工作捕获到 MEL 文件系统。
  • 需要将 Desktop 会话中的交付物、决策、项目知识变更归档到本地磁盘和规范源。
  • 需要确保设备与云端同步状态一致,并触发重新上传标志。

限制

  • claude.ai 没有 API,捕获必须由用户粘贴内容驱动。
  • 转录文本仅本地保存,不纳入 git 提交。
  • 决策和项目知识变更需逐项获得用户确认后才能写入。
  • 提交时按名称暂存,不使用 git add -A。
  • 其他功能、收费、价格、平台、效果或使用步骤暂未提供。