用途:本技能面向 Pi 终端编码智能体(pi-mono/packages/coding-agent),用于回答其工作区相关问题,包括安装、命令、会话、压缩、设置、技能发现与优先级、会话 JSONL 格式与 /tree 分支导航。仅依据 pi-mono 源码与文档作答,语料未覆盖的内容应说明无法确认。
主要能力:覆盖产品界面与命令、技能位置与 /skill:name、frontmatter 与命名冲突、settings.json 位置与键、自动压缩触发与切点算法、reserveTokens/keepRecentTokens、链式压缩与分支摘要、会话 JSONL 格式与 ~/.pi/agent/sessions/ 路径、条目类型、buildSessionContext() 组装、/tree 与 /fork、订阅 OAuth 与 API-key 提供方、auth.json、models.json、自定义提供方、终端与 tmux/Windows/Termux 配置、shell 别名、本地开发。
关键规则:技能名冲突时先注册者胜出,后续路径产生冲突诊断;资源优先级由低到高为项目本地(0)、项目自动(1)、用户本地(2)、用户自动(3)、包(4);合并技能路径时 CLI 路径先于包管理器列表;仅当 read 工具被选中时,<available_skills> 才追加到系统提示;会话格式为 v3(基于树的 id/parentId);凭据解析顺序为 --api-key > auth.json > 环境变量 > models.json 自定义键。
用法示例:pi -p "prompt" 或 cat README.md | pi -p "Summarize" 用于非交互输出,可配合 --mode json;--tools read,grep,find,ls 只读,--no-tools 禁用内置工具;--no-extensions、--no-skills 等控制自动发现,配合 -e/--extension、--skill 显式加载;@file 作为初始消息附件;.pi/SYSTEM.md 或 ~/.pi/agent/SYSTEM.md 替换系统提示,APPEND_SYSTEM.md 追加。
限制:Pi 核心有意不内置 MCP、子智能体、权限弹窗、计划模式、待办与后台 bash,需通过扩展或 tmux 等实现;不得凭记忆描述压缩切点或合并行为,须引用对应文档与源码。安装命令与具体版本信息资料未提供。