mcpField
C
capture-desktop

capture-desktop

github.com/gasseraneAgent 工作流3604 次安装6 天前更新
代码仓库

关于 capture-desktop

capture-desktop 是一项 Agent 技能，用于将粘贴或文件提供的 Desktop 会话内容分流到本地记录、交付物和项目资料源。由于 claude.ai 没有 API，流程从用户提供内容开始，并包含确认、同步与提交步骤。

主要功能

  1. 01暂存原文并去重
  2. 02将内容归入四类
  3. 03确认决策与资料源编辑
  4. 04检查同步并提交更改

适用场景

  1. 01归档已完成的 Desktop 会话
  2. 02将会话交付物存入工作文件夹
  3. 03提出记忆或 wiki 更新
  4. 04捕获后同步规范资料修改

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gasserane/personal-skills --skill capture-desktop

安装后在 Claude Code 中输入/capture-desktop确认已加载。

详细介绍

捕获桌面会话

scripts/check_desktop_sync.py 的设备端镜像。该脚本负责设备到云端的同步。本技能负责云端到设备的捕获。claude.ai 没有 API，因此捕获通过粘贴完成：Ane 粘贴已完成的 Desktop 会话，本技能会将其中的内容分流到磁盘上的相应位置。

步骤 1 — 获取内容

请 Ane 粘贴 Desktop 对话，或者在她提供文件路径时直接使用。如果粘贴内容很长，请先将其写入临时文件，以免内容被截断。

步骤 2 — 暂存转录文本

运行辅助脚本，暂存逐字记录、去重后的转录文本：

python scripts/capture_desktop.py stage --input <tempfile> --title "<short title>"
  • 退出码 0：输出转录文本路径。继续。
  • 退出码 3：[DUP] already captured — 此会话之前已捕获。告知 Ane 并停止，除非她确认仍要重新分流。

转录文本仅保存在本地（已加入 gitignore，由 OneDrive 备份）。暂存的转录文本就是“完整日志”存储区，无需再对该存储区进行其他操作。

步骤 3 — 分类内容

阅读暂存的转录文本，将其中实质性内容分到以下四类：

  1. 交付成果 — Ane 制作的文档、分析、表格和草稿。
  2. 决策／规则／经验 — 已定案的决策、框架方面的选择、关于系统应如何运作的指导，以及对你行为的反馈。成功经验和纠正意见都要记录：如果转录文本表明 Ane 赞许、重复采用或确定采用某种做法，那么这就是值得记录为 feedback 记忆的成功经验（需包含 Why: 和 How to apply:），这样 /improve-system 就能总结已确认的成功经验，而不只是纠正意见。
  3. 项目知识变更 — 应纳入规范来源（mel_wiki/ 页面、~/.claude/CLAUDE.md）的编辑。
  4. 完整日志 — 已在步骤 2 中暂存。无需操作。

如果某一类为空，请如实说明。不要为填充分类而编造内容。

步骤 4 — 分流各类内容

交付成果（自动归档）。 在工作文件夹下提出一个路径，使用 Write 工具保存，并在摘要中注明该路径。如果目标文件已存在，请遵循 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

决策／规则／经验（逐项确认）。 对每一项，提出目标位置——记忆目录中的记忆文件、wiki 条目或反馈记忆——并展示将要写入的确切内容。写入前须征得 Ane 同意。若目标文件已存在，请遵循 mel_wiki/wiki/concepts/edit-preservation-protocol.md。

项目知识变更（逐项确认）。 对每一项，提出对规范来源的确切修改，并征得 Ane 同意。使用 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/ 编辑——转录文本已加入 gitignore）。按名称暂存，绝不要运行 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

评论

支持 Markdown