pi-langfuse
为Pi编程助手集成Langfuse的观测与追踪能力。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-langfuse。 它的用途是：为Pi编程助手集成Langfuse的观测与追踪能力。 完整的 Skill 内容见：https://321skill.com/skills/pi-langfuse/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我用React写一个登录表单，并启用Langfuse追踪。” 它会正常生成代码，同时将本次任务拆解、API调用和代码生成的所有步骤，自动记录到你配置的Langfuse项目中，便于你后续分析每个环节的耗时与效果。
介绍
pi-langfuse是一个专为Pi编码智能体设计的扩展，它解决了开发者在复杂代码生成与调试过程中缺乏透明度和可观测性的问题。通过将Langfuse的追踪、日志和评估功能无缝集成到Pi的工作流中，开发者可以清晰地洞察AI生成代码的决策过程、提示词效果以及最终输出质量。
使用方式非常直接，开发者只需在Pi智能体的环境中安装此npm包并进行简单配置，即可自动开始记录与Pi交互的完整会话链。这包括用户请求、AI思考过程、工具调用以及生成的代码片段，所有数据都会被发送到用户自己的Langfuse实例进行存储和分析。
这个Skill主要适合使用Pi智能体进行软件开发的工程师、技术负责人以及对AI辅助编程过程有审计、优化或分析需求的研究者。他们可以利用这些追踪数据来调试提示词、评估不同模型版本的表现，或为团队协作提供可复现的开发记录。
在使用建议上，请注意确保你的Langfuse服务端配置正确且网络可达，以避免数据丢失。建议在生产环境集成前，先在测试环境中验证数据采集的完整性和隐私安全性。此外，定期审查采集的数据量，以避免产生过高的存储成本。
核心特点
这是首个官方适配Pi编码智能体的Langfuse扩展，能原生、无侵入地捕获Pi特有的内部工作流（如工具调用链），而非仅记录简单的输入输出。它直接通过npm安装，与Pi的架构深度集成，配置比通用SDK更简单。
注意事项
该Skill仅适用于Pi编码智能体生态，不适用于其他AI助手或通用Node.js应用。
常见问题
pi-langfuse能追踪哪些数据？
能追踪完整的会话链，包括用户查询、AI内部思考、工具调用详情和最终代码输出。
需要自己部署Langfuse吗？
是的，需要你有可访问的Langfuse实例（云服务或自托管）来接收和查看数据。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-langfuse/raw/index.md 读取 pi-langfuse 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-langfuse/raw/index.md（查看排版版本）