Pi Agent 这项技能用于需要操作 Pi 或基于 Pi 构建时，提供对应参考。Pi 是一个极简的终端编程工具（harness），可通过 TypeScript 扩展、技能、提示模板、主题、包、自定义模型/提供商、SDK 集成、RPC 模式和 JSON 事件流以及 TUI 组件进行扩展。
主要用途：判断用户意图后指向对应参考文档，覆盖安装与认证、日常 CLI 用法/命令/模式/参数、提供商认证与 API 密钥、自定义模型与本地模型、扩展开发、自定义提供商、Node/TypeScript SDK 嵌入、RPC 集成、JSONL 事件消费、TUI 组件、包管理、子代理编排、MCP 适配、交互式访谈、Web 访问、技能编写、提示模板与主题、会话与压缩，以及键盘、终端、安全与容器化等主题。
关键用法约定：Node/TypeScript 应用优先用 SDK，单会话用 createAgentSession()，需要新建/恢复/分叉/克隆/导入会话时用 createAgentSessionRuntime()；非 Node 客户端或需要进程隔离、语言无关 JSONL 协议时优先 RPC 模式，无状态子进程可用 pi --mode rpc --no-session；一次性命令行管道用 JSON 模式 pi --mode json "prompt"；Pi 原生行为用扩展，跨机器或项目共享用包。常用命令包括 npm install -g --ignore-scripts @earendil-works/pi-coding-agent、pi、pi -p "..."、pi --provider anthropic --model claude-sonnet-4-5 等。
安全限制：Pi 默认本地运行且不沙箱化，扩展、包、技能、shell 命令和项目内 .pi 资源均以 Pi 进程权限作为代码运行；不可信仓库或无人工干预的自动化应使用 Docker、OpenShell、Gondolin、VM 或远程沙箱隔离。不要在项目文件中存放密钥，应使用环境变量、~/.pi/agent/auth.json、/login 的 OAuth 或 models.json 中基于命令的密钥查询。参考内容对应 https://pi.dev/docs/latest 及其文档页，精确 API 行为应以引用页和 node_modules 下已安装的 TypeScript 定义为准。