技能介绍

解决什么问题

在本地跑 Pi coding-agent 这类编码代理时，常见风险是：代理直接读写宿主文件系统、并发会话互相干扰、执行轨迹散落在聊天记录里难以复核。该技能面向需要把 agent 放进受控环境的工程师，重点处理三件事：沙盒边界、LLM provider 凭证配置，以及把会话产物整理成可审查的记录。

工作原理

技能以 Pi coding-agent CLI 为执行入口，围绕四个能力组织：

显式沙盒运行：可选 Docker、OpenShell 或 Gondolin 作为隔离边界，让代理的文件访问、命令执行和副作用尽量落在受控范围内。
Provider 配置：运行前确认 LLM provider 凭证已配置好，避免 agent 在缺少鉴权时进入不可复现状态。
可审查的会话产物：把关键执行上下文固化下来，便于事后 review 某次改动到底由哪些步骤产生。
运行前置条件检查：需要目标仓库、Pi CLI 与凭证到位；沙盒层按需选择，而不是默认必须全部安装。

典型流程是：准备 target repository，确认 CLI 与凭证，选择隔离方式，启动 agent 工作流，最后回收并检查会话产物。

适用边界与注意点

适合本地探索、代码修改验证、需要复现 agent 执行路径的开发场景。它不替代代码评审或 CI 门禁；敏感仓库仍应先在隔离环境中试跑。当前资料没有提取到可自动安装或使用的命令，接入前建议先阅读上游仓库：https://github.com/1991513ccie-png/skills 。官方文档见 https://pi.dev/docs/latest 。