Pi 编码代理：极简终端工作流 培训

Pi 简介

• Pi 是什么及其极简与控制理念
• 与 Claude Code、Codex CLI 和 Cursor 的比较
• 四个内置工具：读取、写入、编辑和 bash
• 何时选择 Pi 而非更重的代理

安装与设置

• 通过 npm 和包管理器安装 Pi
• 配置 15 多个支持提供商的 API 密钥
• 设置工作目录和上下文文件
• 在本地和 Docker 环境中运行 Pi

核心终端工作流

• 从简单提示生成代码
• 精确读取和编辑文件
• 在代理内安全执行 bash 命令
• 管理会话状态和上下文重置

构建自定义技能

• 了解 TypeScript 技能 API
• 编写自定义的读取、写入和编辑操作
• 为专用工作流挂钩 bash 执行
• 在隔离环境中测试和调试技能

提示模板与主题

• 为不同语言和框架调整系统提示
• 创建可重用的提示模板以保持团队一致性
• 将主题打包为可共享的模块

使用 npm 包扩展 Pi

• 将技能打包为 pi 包
• 发布到 npm 和 Git
• 安装社区贡献的包
• 管理依赖版本和兼容性

提供商的灵活性

• 在 Anthropic、OpenAI、Google 和其他后端之间切换
• 根据任务优化成本、速度和质量
• 为敏感代码运行完全本地模型

实际用例

• 自动化测试和测试生成工作流
• 使用自定义技能链重构遗留代码
• 文档生成与维护
• 以最小代理开销集成 CI

安全与控制

• 理解 300 字系统提示的边界
• 手动批准写入操作
• 为不受信任的环境沙盒化 bash 执行
• 审计所有代理操作的日志

总结与下一步

• 回顾极简、控制和可扩展性原则
• 社区资源与贡献指南
• 面向经验丰富的 Pi 用户的高级主题