pi-tool-transparency
Pi AI 工具调用透明化扩展，强制声明目的并展示。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-tool-transparency。 它的用途是：Pi AI 工具调用透明化扩展，强制声明目的并展示。 完整的 Skill 内容见：https://321skill.com/skills/pi-tool-transparency/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我查一下今天北京的天气。”，当AI准备调用天气查询工具时，此扩展会弹出并要求你输入目的，你可以输入“获取今日北京气温以决定出行着装”，确认后工具执行，同时这个目的会显示在侧边小组件中，方便你随时了解AI刚才为何进行那次查询。
介绍
这个 Skill 解决了 AI 助手在调用外部工具（如搜索、执行代码）时，用户对操作目的和过程不透明、难以追溯的痛点。它作为一个 Pi 扩展，在每次工具调用前，会强制要求用户或 Agent 明确声明本次调用的目的，并将该目的实时展示在小组件面板中。
使用时，当 AI 需要调用工具（例如搜索网络或运行代码）时，此扩展会中断流程，弹出一个输入框，要求提供本次工具调用的具体目的。用户或配置好的 Agent 需要输入清晰的目的描述（例如：“搜索最新的 React 18 并发功能文档”），确认后工具才会执行，同时该目的会显示在小组件面板以供随时查看。
它非常适合那些注重 AI 操作可解释性、安全审计和团队协作的开发者、技术负责人或研究人员。在需要对 AI 助手的行为进行记录、审查或教学演示的场景下，这个工具尤其有价值。
使用建议是，在配置 Agent 的自动化流程时，提前为其预设清晰、具体的工具调用目的模板，以提升自动化效率。注意事项是，此扩展会增加一次交互步骤，可能略微影响完全自动化流程的流畅度，更适合对透明性有要求的半自动或监督式任务。
核心特点
核心区别在于它强制要求“事前声明”工具调用目的，并将目的持久化展示在独立面板，而不仅仅是事后在聊天记录中查看。这建立了主动的透明化机制，而非被动的日志记录。
注意事项
不适合对交互速度要求极高、追求完全无人值守自动化的场景。
常见问题
这个扩展会影响 AI 的正常响应速度吗？
会引入一次额外的人工或预设目的确认交互，但对工具调用本身的速度无影响。
声明的目的会被保存或导出吗？
目的会实时显示在小组件面板，但通常依赖于当前会话，具体持久化能力需查看该扩展的存储配置。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-tool-transparency/raw/index.md 读取 pi-tool-transparency 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-tool-transparency/raw/index.md（查看排版版本）