PingCode_数据分析 skill-PHP中文网

PingCode

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

PingCode 研发管理平台 API 集成。支持查询工作项、生成周报、管理项目进度等。使用场景：研发管理自动化、团队协作、数据分析。

PingCode Skill

功能概述

PingCode Skill是一项面向实际任务的技能，主要用于通过 PingCode Open API 操作研发管理平台数据；在 PingCode 企业后台创建应用，获取 Client ID 和 Client Secret；

核心要点

配置应用的数据访问范围；
设置环境变量（不要直接修改脚本）：；
获取我的工作项；

使用与执行

输出示例：；获取项目列表；获取指定项目的全部工作项；生成项目周报；更新工作项；创建工作项（待实现）；API 参考。

结果检查与注意事项

它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。

PingCode Skill

通过 PingCode Open API 操作研发管理平台数据。

前置条件

在 PingCode 企业后台创建应用，获取 Client ID 和 Client Secret
配置应用的数据访问范围

设置环境变量（不要直接修改脚本）：

export PINGCODE_CLIENT_ID="your_client_id"
export PINGCODE_CLIENT_SECRET="your_client_secret"

功能脚本

获取我的工作项

python3 scripts/get_my_tasks.py

输出示例：

📋 你的工作项列表 (共 15 条，显示前 20 条)

⬜ [5e05d844] 优化登录页面性能
   项目: Web端重构 | 状态: 待处理 | 优先级: 高
   负责人: 张三

🔄 [5e05d845] API 接口文档更新
   项目: 开放平台 | 状态: 进行中 | 优先级: 中
   负责人: 李四

获取项目列表

# 列出所有项目
python3 scripts/get_projects.py

# 以 JSON 格式输出
python3 scripts/get_projects.py --json

# 限制返回数量
python3 scripts/get_projects.py --limit 50

输出示例：

📁 项目列表 (共 3 个)

1. 🟢 [5fb277c1] 敏捷示例项目
   类型: 软件开发 | 状态: 进行中 | 负责人: anytao
   描述: 示例项目用于演示敏捷开发流程...

2. 🟢 [5fb277c2] 产品官网重构
   类型: 软件开发 | 状态: 进行中 | 负责人: 张三
   描述: 官网前端重构项目...

获取指定项目的全部工作项

# 通过项目名称查询
python3 scripts/get_project_workitems.py --project_name "敏捷示例"

# 通过项目 ID 查询
python3 scripts/get_project_workitems.py --project_id 62ded365

# 以 JSON 格式输出
python3 scripts/get_project_workitems.py --project_name "敏捷示例" --json

输出示例：

📋 项目工作项 - 敏捷示例 (共 82 条)

⬜ [5fb277c1] 申请售后
   类型: 需求 | 状态: 待处理 | 优先级: 普通
   负责人: anytao

⬜ [5fb277c1] 支付宝支付
   类型: 需求 | 状态: 待处理 | 优先级: 普通
   负责人: anytao

生成项目周报

# 生成周报并输出到控制台
python3 scripts/generate_weekly_report.py

# 指定项目和名称
python3 scripts/generate_weekly_report.py --project_id xxx --project_name "PingCode 重构"

# 输出到文件
python3 scripts/generate_weekly_report.py --output /tmp/weekly_report.md

输出示例：

# 📊 项目周报
生成时间：2024-03-01 14:30

## 📈 数据概览
- 工作项总数：45
- 本周完成：12 (26.7%)
- 进行中：15
- 待处理：18
- 延期风险：3

## ⚠️ 延期风险
发现 3 个工作项已延期，建议优先处理：
- 优化登录性能 (截止：2024-02-28)

更新工作项

# 分配负责人
python3 scripts/update_workitem.py --workitem_id 5fb277c1 --assignee anytao

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

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

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

创建工作项（待实现）

python3 scripts/create_workitem.py --title "修复登录bug" --type bug --priority high

API 参考

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

常用 API 端点

功能	端点
获取令牌	`GET /v1/auth/token`
获取工作项	`GET /v1/project/work_items`
创建工作项	`POST /v1/project/work_items`
获取项目	`GET /v1/agile/projects`
获取迭代	`GET /v1/agile/iterations`