教会服务CLI工具

技能简介

PCO CLI 是 Planning Center Services API 的命令行接口，用于管理教会礼拜服务相关的组织信息、服务类型、计划安排、团队成员、歌曲库等资源。

业务背景

为教会行政同工提供轻量化的服务资源管理入口，替代繁琐的网页后台操作。通过命令行快速查阅礼拜安排、人员排班及诗歌资料，简化周会筹备流程，降低多志愿者协作时的信息同步门槛，确保服事交接顺畅。

落地案例：敬拜负责人每周需确认下周诗班轮值与歌曲编排，通过该工具输入计划ID即可导出完整项目清单，含各岗位同工名单。行政同工可按姓名检索特定人员的历史排班记录，协调代班需求。诗歌领队搜索关键词调取歌曲库资料时，同步查看调性、拍速等编曲细节，提前与乐手沟通预备。

能做什么

• 查询和管理教会组织架构与服务类型
• 查看礼拜计划及详细项目安排
• 检索团队成员排班与人员信息
• 搜索歌曲库及查看编曲信息
• 管理媒体文件、文件夹和系列内容
• 直接调用原始 API 进行自定义操作

使用说明

安装依赖

# 需要 Node.js 环境
npm install -g tsx

# 克隆仓库
git clone https://github.com/rubysworld/pco-cli.git
cd pco-cli

配置认证

# 首次使用需设置凭证（交互式）
tsx pco.ts auth setup

# 验证登录状态
tsx pco.ts auth status

常用命令示例

# 列出所有服务类型
tsx pco.ts service-types list --table

# 获取未来计划
tsx pco.ts plans list --service-type <id> --filter future --limit 1

# 查看本周排班
tsx pco.ts scheduled list --service-type <id> --plan <planId> --table

# 搜索歌曲
tsx pco.ts songs list --search "Amazing Grace"

建议设置别名

alias pco="tsx /path/to/pco-cli/pco.ts"

输入与输出

见下方输入与输出表格。

风险提示

• 仅支持 PCO Services 模块，不包含 People、Giving 等其他应用
• API 凭证存储在本地配置文件，需注意文件权限安全
• 部分操作可能产生实际数据变更，生产环境使用前建议测试
• 依赖外部 API 可用性，网络异常时功能受限

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/rubyrunsstuff/pco/SKILL.md
来源类型：GitHub 仓库