pi-llm-debugging

将LLM请求数据保存到项目目录,便于调试

安装使用

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

帮我安装这个 AI Skill:pi-llm-debugging。
它的用途是:将LLM请求数据保存到项目目录,便于调试
完整的 Skill 内容见:https://321skill.com/skills/pi-llm-debugging/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

“帮我写一个Python函数来计算斐波那契数列。”,它会正常响应你的请求,同时将这次请求的完整提示词、模型参数以及返回的代码,以JSON等格式保存到你项目下的`.pi`文件夹中。之后,你可以随时查看这些文件来分析AI的“思考”过程,优化你的提问方式。

介绍

这个Skill解决了开发者在调试基于大型语言模型(LLM)的项目时,难以追踪和分析AI服务提供商实际请求与响应数据的痛点。它通过在项目根目录下自动创建并维护一个名为.pi的文件夹,将每次调用LLM(如Claude、GPT等)的请求载荷(payload)和响应数据以文件形式保存下来,为开发者提供了第一手的调试依据。

使用方式非常简单直接。开发者只需在项目中安装并启用此Skill,之后所有通过项目框架(如Pieces for Developers)发起的LLM请求,其详细的请求和响应数据都会被自动捕获并存储。开发者无需修改现有代码或手动添加日志语句,即可获得完整的交互记录。

它非常适合正在开发或维护集成LLM功能的应用程序的软件工程师、AI应用开发者以及技术负责人。无论是调试复杂的AI提示工程(Prompt Engineering)问题,还是分析模型输出不一致的原因,或是单纯为了审计和复现AI交互过程,这个工具都能提供关键支持。

建议在开发、测试和预发布环境中积极使用此Skill,以便快速定位问题。但请注意,保存的请求数据可能包含提示词、API密钥(取决于配置)等敏感信息,因此在生产环境中应谨慎评估其安全风险,或确保.pi文件夹被妥善排除在版本控制和部署范围之外。

核心特点

与通用的网络请求日志工具不同,它专为LLM交互设计,能结构化地保存请求载荷(包括提示词、参数等)和响应,并直接关联到具体项目(.pi文件夹),实现了按项目隔离的、开箱即用的调试数据管理。

注意事项

不适合用于生产环境或对性能和数据安全有极高要求的场景,因为它会持续写入磁盘并可能记录敏感信息。

常见问题

保存的数据在哪里?

保存在项目根目录下的 .pi 文件夹中。

会影响我的代码性能吗?

主要影响是磁盘I/O,在开发调试时影响通常可接受,生产环境建议禁用。

给 AI 助手的安装指引

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

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