@xl0/pi-lovely-dev-tools

Pi代理的交互式调试与上下文分析工具集

开发流程 调试Agent行为分析Token消耗监控AI响应排查Bug根因 通用 ★ 45 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@xl0/pi-lovely-dev-tools。
它的用途是:Pi代理的交互式调试与上下文分析工具集
完整的 Skill 内容见:https://321skill.com/skills/xl0-pi-lovely-dev-tools/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我查看当前上下文的Token使用情况',它会自动执行`/show-context`命令,展示系统提示、上下文文件、技能、消息、思考、工具调用等各部分的Token分解,以及文件覆盖地图。你也可以说:'手动运行read工具读取README.md文件',它会调用`/tool read README.md`并显示结果。

介绍

这个Skill解决了AI代理调试过程中信息不透明、难以定位问题的痛点。在实际开发中,开发者经常需要了解系统提示词的实际渲染内容、当前上下文的Token占用情况、以及每次LLM调用的详细统计,但默认情况下这些信息往往被隐藏或难以获取。

使用方式很简单,你只需要在Pi环境中安装该Skill,然后通过四个核心命令进行操作:/tool可以手动运行任意工具并查看结果(不发送给LLM),/show-sysprompt显示渲染后的系统提示和工具Schema,/show-context展示当前上下文的Token分解(包括系统提示、上下文文件、技能、消息、思考、工具调用等)以及文件覆盖地图,/llm-stats以表格形式展示当前分支每次LLM调用的详细信息(模型、Token用量、缓存命中、停止原因、工具调用等)。所有命令都支持流式输出和Esc中止。

它非常适合需要深入调试AI代理行为的智能体开发者、运维工程师和全栈开发者。尤其是那些已经使用Pi框架构建复杂代理应用、需要频繁排查模型行为异常、优化Token消耗或分析上下文压缩效果的团队或个人。对于希望理解AI代理内部运行机制、提升调试效率的开发者来说,这是一个必备工具。

建议在开发阶段频繁使用/show-context/llm-stats来监控上下文状态和调用成本,避免Token浪费。需要注意的是,它主要依赖Pi框架的底层API,因此仅适用于Pi环境;手动运行工具时会绕过工具策略钩子,生产环境中需谨慎使用。此外,/show-context的Token估算基于模型分词器,可能与实际计费略有差异。

常见问题

如何安装这个Skill?

在Pi终端中执行 `pi install npm:@xl0/pi-lovely-dev-tools` 即可安装。

如何卸载?

使用 `pi uninstall @xl0/pi-lovely-dev-tools` 命令卸载。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/xl0-pi-lovely-dev-tools/raw/index.md 读取 @xl0/pi-lovely-dev-tools 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。