用途：setup 是 fradser/dotclaude 中的配置类技能，供人工为 pi 编程代理设定提供方、模型、端点地址与 API 密钥，使 /pi:delegate（委派编码任务）与 /pi:review（只读审查代码）共享同一配置，无需每次重复传参。该技能为人工专用，不应被自动调用，仅当用户显式执行 /pi:setup 时运行。
前置检查：先执行 command -v pi >/dev/null 2>&1 判断是否已安装 pi；若未安装，引导用户执行 npm install -g @earendil-works/pi-coding-agent，或使用独立安装脚本 curl -fsSL https://pi.dev/install.sh | sh，未安装则停止。
配置层级：两个子技能按同一优先级读取设置——CLI 传参、项目级 .claude/pi.local.json（被 gitignore）、项目共享 .claude/pi.json（提交入库）、全局 ~/.claude/pi.local.json、pi 自身默认值。setup 写入的是全局 ~/.claude/pi.local.json。
配置格式：使用命名端点结构，字段均可选，值支持 $VAR 与 ${VAR} 环境变量引用并在读取时解析。每个端点含 provider（必填，如 openai、anthropic、google）、baseUrl（可选，自定义 OpenAI 兼容端点，运行时写入 ~/.pi/agent/models.json）、apiKey（可选）、models（模型 ID 数组）；顶层有 defaultEndpoint、defaultModel、thinking、withPackages（默认 false）。旧的扁平字段 provider/model/baseUrl/apiKey 仍作为回退被 delegate 技能支持，但新配置建议使用端点格式。
用法与标志：--endpoint 端点键名（默认 local-proxy）、--provider、--model、--base-url、--api-key；也支持交互式提问。$ARGUMENTS 恰为 --list-models 时读取并展示当前生效配置后停止；含 --test 时执行连通性探测。设置流程为：检测当前状态、从 CLI 标志或交互收集配置、写入配置、自动以 --test 验证、输出摘要。
测试注意：pi 没有 --base-url 标志，自定义端点需先写入 ~/.pi/agent/models.json，再以 PI_CODING_AGENT_DIR 指定代理目录并加 --thinking low --no-session --no-context-files --approve --no-extensions --no-skills，且需 </dev/null 强制非交互以免挂起；--model 为空时不应传该标志。
常见配置示例：OpenAI 兼容自定义端点（provider 为 openai 加 baseUrl）、Anthropic 直连（--provider anthropic --model claude-sonnet-4-20250514）、Google Gemini 直连（--provider google --model gemini-3.6-flash-high）。安装方式、命令与配置字段均按资料保留。
限制：仅限人工显式调用；未提供 pi 的收费、价格、性能或效果信息；安装与配置之外的运行细节、平台支持范围及异常处理策略资料暂未提供。