$ cat ~/map/pi-coding-agent-action.md

pi-coding-agent-action

在 CI 中运行 pi 编码代理的 GitHub Action，支持评论触发的审查与 PR 分类。

tools✓ 10月16日

uses: shaftoe/pi-coding-agent-action@v2

## 速览

在 CI 里运行 pi 编码代理的 GitHub Action——支持 GitHub、Codeberg 与自建 Forgejo——覆盖 /pi 评论触发、定时审计、自动化 PR 审查与 pi 风格的会话分享链接。

## 要点

• $交互模式：在 issue 或 PR 评论前加 /pi，让 agent 分析问题、出报告或直接开修复 PR。非交互模式用固定的 prompt 输入作为工作流步骤；pr_number 配合 workflow_dispatch 按需审查任意 PR；schedule 触发器承担依赖审计、文档同步等周期性维护；分配（assigned）事件可把工作路由给机器人账号。
• $必需输入为 github_token、provider 与 model；token 提供 provider 的 API key。可选输入包括 base_url（代理与 OpenAI 兼容网关）、thinking_level、extensions（npm:、git: 或本地路径）、限制工具集的 loaded_tools、auto_compaction，以及 diff_max_bytes / diff_max_lines。
• $会话分享把 pi 的 /share 命令搬进 CI：export_session_html 与 export_session_jsonl 产出工作流工件，share_session 把导出的 HTML 上传到 gist——默认 GitHub Gists，也可用自建 Opengist——并给出可分享的查看链接。
• $平台支持经 platform 输入：github（默认）、codeberg、forgejo 或 gitea——不再自动探测；runner 通告内网地址时用 server_url 修正面向用户的链接。
• $安全姿态：CI 中没有可交互的用户，action 创建会话时总是把工作区标记为 trusted（projectTrusted: true），有推送权限的人都能通过 AGENTS.md 与 .pi/ 配置影响 agent；GitHub 的 GITHUB_TOKEN 永远不能推送 .github/workflows/ 下的改动（需换成带 workflow scope 的 PAT）；发布 tag 不可变，钉住 @v2.27.1 等价于钉住 commit SHA。
• $前置要求：经 actions/setup-node 安装 Node.js ≥ 22.x。action 由 esbuild 打包成单个 dist/index.js，运行时无需 node_modules；Pi SDK 与依赖定期更新。

## 常见问题

## 参考链接

• README（用法、输入、安全说明） ↗
• GitHub Marketplace 页面 ↗

最后更新: 2026年8月31日