pi-tool-duration
为Pi工具慢速结果添加耗时标记
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tool-duration。 它的用途是：为Pi工具慢速结果添加耗时标记 完整的 Skill 内容见：https://321skill.com/skills/pi-tool-duration/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“查询一下最近的订单数据。”，当后台查询工具因数据量大而耗时较长时，AI会回复：“查询完成，共找到50条记录。这项数据检索操作花费了大约2.3秒。”，让用户明确感知到等待时间。
介绍
该Skill旨在解决AI调用Pi平台工具时，因网络延迟或处理耗时导致用户无法直观感知操作进度的问题。它通过在模型返回的慢速工具结果中，自动附加一个模型可见的持续时间标记，让AI能清晰告知用户某项操作具体花费了多长时间。
使用时，开发者只需将该Skill集成到其基于Pi平台的AI项目中。当AI调用外部工具（如数据查询、API请求）并产生延迟时，该Skill会自动介入，在返回给AI的上下文信息中注入时间戳或耗时描述，使AI能在回复中自然地加入“这项操作花费了约X秒”等说明。
它非常适合那些在Pi平台上构建复杂工作流、需要频繁调用外部工具且重视用户体验的AI应用开发者。对于终端用户而言，这意味着与AI交互时能获得更透明、更友好的进度反馈。
建议在预计耗时较长的工具调用场景中启用此Skill。需要注意的是，它主要处理的是“模型可见”的标记，即信息是提供给AI模型用于组织回复的，并不会直接修改前端显示逻辑。确保你的AI应用能正确解析并利用这些附加的耗时信息。
核心特点
与仅提供前端加载动画或简单超时提示的方案不同，pi-tool-duration 直接在AI模型接收到的工具调用结果中嵌入结构化耗时数据，使AI能主动、自然地在对话中解释延迟，提升了交互的智能性与透明度。
注意事项
不适用于对工具调用结果格式有严格、不可更改要求的场景，因为它会修改返回给模型的数据结构。
常见问题
pi-tool-duration 会影响工具本身的执行速度吗？
不会，它只负责在结果返回后添加标记，不干预工具执行过程。
这个Skill需要在前端做额外开发吗？
通常不需要，它主要服务于AI模型的对话生成，但前端可根据模型返回的耗时信息优化展示。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tool-duration/raw/index.md 读取 pi-tool-duration 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tool-duration/raw/index.md（查看排版版本）