PingCode 研发管理平台 API 集成。支持查询工作项、生成周报、管理项目进度等。使用场景:研发管理自动化、团队协作、数据分析。
PingCode Skill是一项面向实际任务的技能,主要用于通过 PingCode Open API 操作研发管理平台数据;在 PingCode 企业后台创建应用,获取 Client ID 和 Client Secret;
输出示例:;获取项目列表;获取指定项目的全部工作项;生成项目周报;更新工作项;创建工作项(待实现);API 参考。
它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
通过 PingCode Open API 操作研发管理平台数据。
Client ID 和 Client Secretexport 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
详见 references/api_docs.md 或访问 https://open.pingcode.com/
| 功能 | 端点 |
|---|---|
| 获取令牌 | GET /v1/auth/token |
| 获取工作项 | GET /v1/project/work_items |
| 创建工作项 | POST /v1/project/work_items |
| 获取项目 | GET /v1/agile/projects |
| 获取迭代 | GET /v1/agile/iterations |
PINGCODE_CLIENT_ID 和 PINGCODE_CLIENT_SECRET,不要硬编码到脚本中相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.5万人学习
最新文章