agent-halter
为AI编码代理设置会话预算，控制时间和对话轮次。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-halter。 它的用途是：为AI编码代理设置会话预算，控制时间和对话轮次。 完整的 Skill 内容见：https://321skill.com/skills/agent-halter/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
`/timebox 30m turns:10`，它会为你设置一个30分钟或10轮对话的预算（以先到者为准）。在会话过程中，状态栏会实时更新剩余时间，当预算消耗到80%时，你会收到一次警告通知，后续每次AI响应前都会附加预算提醒。预算耗尽时，AI代理将停止响应，并可以自动执行你预设的Shell命令（例如使用`lmk`工具弹出桌面通知）。
介绍
这个Skill解决了AI编码代理会话可能无限延长、消耗过多时间和Token的问题。在实际开发中，开发者经常需要与AI代理进行多轮对话来完成复杂任务，但缺乏有效的会话时长和轮次控制机制，可能导致成本不可控或对话效率低下。
使用方式很简单，你只需要在pi-coding-agent会话中使用/timebox命令，即可设置时间预算（如15分钟）或对话轮次预算（如5轮）。之后，系统会在状态栏实时显示剩余预算，并在预算耗尽前发出软性提醒，在预算耗尽时自动停止代理响应，同时可触发自定义的Shell命令（如发送桌面通知）。
它非常适合需要精确控制AI代理会话成本的团队或个人。尤其是那些在项目开发、代码审查或自动化测试中频繁使用AI编码代理，并希望优化Token消耗、管理项目进度的开发者和项目经理。
建议在启动长时间或高复杂度的AI辅助编码任务时统一使用此工具。需要注意的是，它主要作为pi-coding-agent的扩展，其软性提醒功能可能被某些AI模型忽略，且目前主要适配pi-coding-agent，对其他AI代理（如Claude Code）的适配仍在计划中。
常见问题
如何查看当前的预算剩余情况？
在会话中输入 `/timebox status` 命令即可查看剩余时间和轮次。
预算耗尽后还能继续对话吗？
可以。预算耗尽只会阻止AI代理的下一轮响应，用户仍可继续输入命令或设置新的预算。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-halter/raw/index.md 读取 agent-halter 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-halter/raw/index.md（查看排版版本）