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 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我重构这个用户模块的接口代码，单会话Token上限设为100k”，它会自动加载agent-halter的预算规则，实时统计本次会话的Token消耗与运行时长。若运行中触发预设阈值，它会自动暂停任务并同步当前进度，避免无意义的资源消耗。
介绍
日常使用AI编码代理处理开发任务时，常出现会话无限制消耗Token、超出预设成本预算仍持续运行的情况，既可能造成不必要的费用超支，也可能因长会话上下文漂移导致生成内容偏离需求，浪费开发时间与算力资源。 它作为轻量npm包可快速集成到现有AI编码代理工作流，配置好单会话Token上限、运行时长阈值等预算规则后，代理运行过程中会实时统计消耗数据，触发阈值时自动暂停或终止会话，无需人工全程盯守。 适合经常使用AI编码工具辅助开发的个人开发者、中小开发团队，尤其是有明确AI工具成本管控需求、需要批量执行AI编码任务的技术从业者。 使用前建议根据自身日常任务的平均消耗水平合理设置预算阈值，避免阈值过低导致正常开发任务被意外中断，也可搭配会话日志功能排查触发终止的具体原因，优化后续任务配置。
核心特点
区别于通用Token消耗统计工具仅做数据提醒，它专门面向AI编码代理场景提供会话级预算管控，触发阈值后可自动执行暂停/终止动作，无需人工介入。
注意事项
仅支持Node.js生态下可集成npm包的AI编码代理，无法直接适配非Node环境的AI编码工具。
常见问题
agent-halter支持统计哪些消耗维度？
支持统计单会话的Token消耗量、运行时长两类核心消耗维度。
触发预算阈值后必须终止会话吗？
不是，支持自定义触发动作，可选择暂停会话、终止或仅发送提醒。
给 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（查看排版版本）