用途：在 joelclaw 中让 Inngest 负责编排、Pi 负责模型与智能体执行时，提供实现、评审与调试规范。核心边界是 Inngest 管持久性（发事件、等待事件、写 claim-check 文件、记录终态），Pi CLI 视为外部执行者而非进程内库；仅在有界模型调用且不需要 Pi 会话/工具时才直接用 pi-ai。
主要能力与用法：
- 直接 pi-ai：在 step.run 内用 @earendil-works/pi-ai 的 complete/getModel 配合 @earendil-works/pi-coding-agent 的 AuthStorage、ModelRegistry 取凭据，适合短小确定性的分类、抽取修复、摘要等，不涉及 Pi 工具或会话。
- 分离式 Pi CLI + 事件结果：收到 pi/workflow.requested 后，短 step.run 写 pi-request.json 并 spawn 分离子进程；包装器以过滤环境调用 pi -p @pi-prompt.md，子进程写 pi-result.json 与产物，再发 pi/workflow.result.ready；父函数用 step.waitForEvent（按 data.workflowId 匹配，超时 4m）等待，并发出 context.completed、needs_human 或 failed 终态事件。长会话用 spawn 而非 execFile。
- 服务账号认证：服务以 joelclaw 用户运行，设置 PI_CODING_AGENT_DIR=/Users/joelclaw/.pi/agent，auth.json 权限 0600，禁止打印令牌；可用仓库脚本 scripts/setup-pi-service-auth.sh --dry-run/--apply/--test 迁移 openai-codex OAuth 凭据。
适用场景：链接摄取上下文、需要 Pi 工具/技能/会话日志或进程隔离的长任务、事件驱动工作流。
限制：该技能为 joelclaw 专用；不要向 Pi 子进程传入 INNGEST_EVENT_KEY、webhook 密钥等；不要跨账号软链认证文件；每条路径必须有终态事件与超时失败回执；资料未提供其他平台或通用化说明。