@cad0p/pi-bash-timeout
为内置bash工具增加120秒超时保护。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@cad0p/pi-bash-timeout。 它的用途是：为内置bash工具增加120秒超时保护。 完整的 Skill 内容见：https://321skill.com/skills/cad0p-pi-bash-timeout/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请用bash列出当前目录下所有文件并计算大小。”，它会通过此Skill执行命令，如果命令因目录内容过多而运行超过两分钟，则会自动停止并告知你命令已超时，而不会让对话陷入等待。
介绍
这个Skill主要解决了在使用AI Agent内置的bash工具时，可能因命令执行时间过长而导致AI对话卡死或无响应的问题。它通过包装原有的bash工具，为其设置了一个默认120秒的执行超时限制，从而防止长时间运行的命令阻塞整个会话。
使用方式非常简单直接。安装此Skill后，当你在AI对话中调用bash命令时，它会自动介入并接管执行过程。如果命令运行超过120秒，进程将被自动终止，并返回超时提示，确保你的AI助手能继续响应后续请求。
这个Skill非常适合那些需要在AI辅助下执行bash命令，但又担心命令可能陷入死循环、等待时间过长或消耗过多资源的开发者、运维人员和高级用户。它尤其适用于在探索性编程、系统调试或自动化脚本测试等场景中使用AI助手。
建议在需要对命令执行时间有明确预期的场景下使用。请注意，超时后命令进程会被强制终止，因此不适用于执行不可中断的关键性任务（如数据库写入）。你可以根据具体命令的预期耗时，在调用时考虑是否需要调整超时阈值或使用原生bash工具。
核心特点
核心区别在于它并非替换或重写原有的bash工具，而是以“包装器”形式工作，完全保留了原工具的输出渲染器和执行逻辑，仅增加了超时控制层，因此兼容性更好，行为更可预测。
注意事项
不适合用于执行必须完成、不能中途中断的关键性后台任务或数据写入操作。
常见问题
超时时间可以自定义吗？
目前版本默认固定为120秒，暂不支持自定义。
会影响其他非bash的AI功能吗？
不会，它只包装特定的bash工具，不影响其他功能。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/cad0p-pi-bash-timeout/raw/index.md 读取 @cad0p/pi-bash-timeout 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/cad0p-pi-bash-timeout/raw/index.md（查看排版版本）