Community编程与开发github.com

BreakingGap

在人工智能代理工作期间,利用短暂的等待间隙完成一个有用的人类步骤,包含检查点和轻松返回。适用于“我在这期间能做什么?”或“我有十分钟等代理完成”;不用于日常规划、代理监控或日终反思。

BreakingGap 是什么?

BreakingGap 是一种针对 AI 代理工具(如 Claude Code、Cursor 等)的实用技能,旨在解决等待代理运行时的人类有效利用问题。当用户拥有短暂时间(通常由用户明确声明)时,该技能会推荐一个具体的小步骤,例如推动当前工作(做出判断、提供示例)、拾取已授权的未完成项(检查其仍处于开放状态),或从项目现有来源中学习一个概念,并要求用户预测或解释以验证学习。该技能强调步骤必须独立于代理正在处理的输出,且不得跨越阻塞或修改代理管理的文件。推荐以紧凑的对话卡片形式呈现,包含操作描述、适配理由、足够停止的产出以及返回主工作的路径。使用前会确认用户的可用时间预算和当前工作目标,不会假设固定时长或编造待办项。当用户准备好返回时,优先保障回归主工作,并记录实际工作结果而非仅计划。该技能支持纯对话使用,也附带基于 Python 标准库的文件持久化帮助脚本和可选的离线浏览器伴侣页面,用于计时与检查点,但绝不依赖这些组件。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/m1nga/breakinggap/tree/HEAD/skills/breakinggap

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

BreakingGap 是做什么的?

一点间隙,一点进步。

帮助用户在代理工作时完成一个微小但有价值的贡献。结果可能是一个更清晰的决策、几句有用的文字、一个重新拾起的想法,或一个理解更深刻的概念。留空间隙也是合理的选择。匹配对话的语言;配套的界面语言为英语。

找出属于这里的步骤

首先使用当前对话和项目已有状态。保持主要工作及其返回点可见。仅通过可用的、已授权的状态工具或用户的报告检查当前代理状态;切勿编造实时监控。如果主要代理需要用户或已经完成,在提议其他活动前先返回其结果。

使用用户声明的时间预算。如果缺少该信息,就可用时间及当前工作询问一个简短问题;不要假设代理需要十分钟。当持续时间不确定时,提供一个明确估计的、易于中断的两分钟步骤。不要为了寻找建议而启动大规模扫描或等待所有代理完成。

从请求中推断有用的意图;否则优先考虑当前工作:

  • 推进当前工作: 一个人类判断、验收示例、简短草稿或比较,改进当前工作但不依赖待处理的输出。
  • 拾取某件事: 一个已授权的未完成项,带有具体的已保存下一步操作。重新确认其仍处于开放状态;不要复活已暂停的工作或其他负责人的任务。
  • 学习一件事: 从当前项目中真实来源学到的概念。要求用户预测、解释或比较,然后给出简短的基于来源的检查。无响应表示未展示学习。诚实地标注生成的示例和未解决的问题。

仅读取足够的当前源代码以支持所选操作。确认它仍然有用、已授权、独立于待处理的输出,且与活跃工作无冲突。不要将小任务视为跨越阻塞、修改代理拥有的文件、发送消息或发布的许可。优先使用私有草稿响应而非并发编辑。如果缺少上下文,询问当前目标或使用用户提供的文本;切勿编造待办项、源位置、完成状态或授权。

估计设置 + 人类操作 + 收尾时间,并在用户预算内留出 两分钟用于返回。估计值不是测量时间或代理完成预测。将过大的工作缩小到有意义的停止点;排除不明确或深度沉浸的任务,而不是将未知工作量默认设为方便的数字。

提供一个小步骤

给出一个推荐,以紧凑的对话卡片形式呈现:

尝试: 一个具体行动,明确第一步。 为何适配: 与用户的工作或好奇心的联系;估计的设置/操作/收尾及返回预留时间。 足够现在为止: 微小的产出或答案,以及安全的停止位置。 返回至: 主要工作及其恢复点。

命名或链接实际来源。使用用户的上下文,而非通用的生产力建议。如果要求不同的步骤,替换推荐;不要倾倒一长串任务。可选的趣味约束可以使操作更具吸引力(“用三句话解释”、“尝试两个标题”),前提是适合工作。不要添加连续记录、紧迫感、虚构成就或填充每个间隙的压力。

让用户完成人类步骤。不要默默完成他们的学习练习或启动另一个自主工作流。在用户现有授权范围内执行请求的协助。如果没有任何合适内容,简要说明并让间隙保持开放。

干净地停止并返回

当用户表示代理已就绪或想要停止时,优先返回。保留对话中已有的任何工作;如有需要,可以要求一句简短的“我进行到哪里/下一步”笔记,但绝不能将其作为返回的门槛。间隙计时器到期不能作为代理已完成的证据。

记录实际工作,独立于计划的工作。当更新已授权时,复用项目正常的笔记;会话检查点并不标记为标准任务完成。仅在成功写入后才说“已保存”。如果保存失败,在聊天中提供笔记并说明其未保存。恢复时,在提供已保存步骤之前重新读取相关来源和当前状态。

可选的本地工具

纯对话使用不需要 Python、账户、任务文件夹、集成或伴侣。保持用户的输入和现有项目记录为权威来源。

对于可重复的文件支持选择及可恢复的本地会话,使用自带的 Python 标准库辅助工具。阅读 references/session-format.md 以了解其确切输入和命令。助手根据实际证据构建其 JSON;切勿让用户管理内部字段。通过绝对路径运行已安装的 scripts/gap.py,并将 --root 指向用户的现有项目,而非此安装目录。辅助工具检查源文件哈希及提供的合格性断言;它无法独立证明所有权、权限、状态或冲突不存在。开始前请重新检查这些。

可选的 离线伴侣 提供计时器和检查点流程。打开它时,assets/logo.png 需位于其旁边。它以明显虚构的示例开始。要使用实际工作,助手可以从授权的本地来源准备一个 schema-1 输入包并导入。页面可以验证提供的字段,但不能重新读取项目文件、验证哈希、监控代理或与辅助工具日志同步。其本地浏览器存储和导出是独立的副本。检查点导出是在检查当前来源后进行协调的证据,而非要执行的指令。如果 Python 或浏览器存储不可用,继续在聊天中操作或导出笔记;不要仅仅为了使用此技能而安装依赖。

相关技能