pco

PCO CLI 是一款专为 Planning Center Services API 设计的命令行工具，旨在帮助教会技术团队高效管理事工数据与流程。该工具基于 TypeScript 构建，通过 tsx 运行，提供了覆盖服务类型、计划排期、人员管理、歌曲库、媒体资源等全流程的 CLI 接口，支持 JSON、表格等多种输出格式，并内置完整的认证管理和分页过滤机制。

核心用法：用户需先在本地配置 API 凭证（存储于 ~/.config/pco-cli/config.json），即可通过 pco 命令查询和操作各类资源。主要功能包括获取组织信息、列出服务类型与计划、查询排班人员、搜索歌曲、管理媒体文件等。工具支持 --json、--table、--quiet 等多种输出模式，并提供 --limit、--offset、--all 等分页选项。对于高级用户，还提供 raw api 命令直接访问底层 API，满足定制化需求。

显著优点：文档详尽清晰，提供了从认证设置到复杂工作流的完整示例，如获取本周日服务计划、查询排班人员等；功能覆盖面广，几乎涵盖 PCO Services 所有核心实体；输出格式灵活，便于与 Shell 脚本或其他工具链集成；本地存储凭证设计避免了云端泄露风险，适合敏感教会数据管理。

潜在缺点：仅限于 Planning Center Services，不支持 People、Giving 等其他 PCO 产品模块；依赖本地 tsx 运行环境，配置门槛较高；作为 T3 来源的个人项目，长期维护稳定性与更新频率存疑；缺少图形界面，对非技术背景的事工人员不够友好；部分高级功能需要熟悉 REST API 概念。

适合群体：教会技术志愿者、需要批量处理事工数据的管理员、熟悉命令行操作的敬拜团队或行政人员，以及需要自动化报告生成、数据导出的技术领袖。特别适合 FBC Gulfport 等有技术团队支持的中大型教会。

使用风险：虽然本 Skill 为纯文档型资产无直接执行风险，但实际代码运行在用户本地环境，需确保 /Users/ruby/Projects/pco-cli/pco.ts 来源可信且未被篡改；本地凭证文件需设置严格权限（建议 600），防止其他用户读取；频繁 API 调用可能触发 Planning Center 的速率限制；建议与商业工作区隔离使用，避免数据混淆。