PingCode Skill

通过 PingCode Open API 操作研发管理平台数据。支持公有云和自建部署两种实例类型。

快速开始

1. 安装

执行上面的安装命令 或 将整个 pingcode-skills 目录复制到 OpenClaw 的 skills 目录下即可使用。

2. 配置（首次使用必须操作）

可以直接发消息配置

如："帮我把 PingCode 配置改成base_url是http://192.168.1.203/open，client_id 是rWWUwTkXYOOo，client_secret 是hwhjFMRXZChJycKUkppHxxxx"

也可以直接编辑 config.json，填入你的 PingCode 实例地址和凭证：

{
  "base_url": "http://192.168.1.203/open",
  "client_id": "你的Client_ID",
  "client_secret": "你的Client_SECRET",
  "request_timeout": 30
}

常用实例地址：

3. 凭证获取

1. 登录 PingCode 企业后台
2. 进入「应用管理」→「开放 API」
3. 创建应用，获取 Client ID 和 Client Secret
4. 配置应用的数据访问范围

功能脚本

获取项目列表

python scripts/get_projects.py
python scripts/get_projects.py --json           # JSON 格式
python scripts/get_projects.py --limit 50       # 限制数量

获取指定项目的工作项

python scripts/get_project_workitems.py --project_name "openclaw"   # 按名称匹配
python scripts/get_project_workitems.py --project_id 6a0579ba      # 按 ID
python scripts/get_project_workitems.py --project_name "openclaw" --json

获取我的工作项

python scripts/get_my_tasks.py
python scripts/get_my_tasks.py --assignee 张三      # 按负责人筛选
python scripts/get_my_tasks.py --limit 50

生成项目周报

python scripts/generate_weekly_report.py --project_id xxx --project_name "openclaw"
python scripts/generate_weekly_report.py --output /tmp/weekly_report.md

更新工作项

# 分配负责人
python scripts/update_workitem.py --workitem_id 5fb277c1 --assignee_id user123

# 设置开始和截止时间
python scripts/update_workitem.py --workitem_id 5fb277c1 --start_date "2026-03-12" --due_date "2026-03-20"

# 同时更新多个字段
python scripts/update_workitem.py --workitem_id 5fb277c1 --assignee_id user123 --start_date "2026-03-12" --due_date "2026-03-20" --priority "高"

# 更新状态
python scripts/update_workitem.py --workitem_id 5fb277c1 --status "进行中"

API 参考

详见 references/api_docs.md 或访问 https://open.pingcode.com/

常见问题

Q: 切换实例需要修改代码吗？

不需要，只需直接发消息变更配置信息 或手动配置修改 config.json 中的 base_url 、client_id、client_secret即可。