PingCode Skill

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

前置条件

1. 在 PingCode 企业后台创建应用，获取 Client ID 和 Client Secret
2. 配置应用的数据访问范围（需要勾选各模块权限）
3. 设置环境变量：

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

1️⃣ 项目管理

获取项目列表

python3 scripts/query_projects.py                                  # 所有项目
python3 scripts/query_projects.py --name "合规"                     # 按名称搜索
python3 scripts/query_projects.py --project_id xxx --detail         # 项目详情

查看迭代 (Sprint)

python3 scripts/query_projects.py --project_id xxx --sprints        # 指定项目的迭代
python3 scripts/query_projects.py --all_projects_sprints --sprints  # 全部活跃迭代

查看发布 (Release)

python3 scripts/query_projects.py --project_id xxx --releases

项目成员

python3 scripts/query_projects.py --project_id xxx --members

2️⃣ 工作项 (Work Items)

获取我的工作项

python3 scripts/get_my_tasks.py

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

python3 scripts/get_project_workitems.py --project_name "项目名称"
python3 scripts/get_project_workitems.py --project_id abc123 --json

工作项高级查询（推荐）

python3 scripts/query_workitems.py --project_name "项目名称"                # 统计
python3 scripts/query_workitems.py --project_name "项目名称" --type bug     # 只看 bug
python3 scripts/query_workitems.py --project_name "项目名称" --unfinished   # 未完成
python3 scripts/query_workitems.py --all_projects --unfinished                # 全部未完成
python3 scripts/query_workitems.py --project_name "项目名称" --assignee "张三"
python3 scripts/query_workitems.py --project_name "项目名称" --recent 7     # 最近7天

更新工作项

python3 scripts/update_workitem.py --workitem_id abc --assignee anytao
python3 scripts/update_workitem.py --workitem_id abc --start_date "2026-03-12" --due_date "2026-03-20"
python3 scripts/update_workitem.py --workitem_id abc --assignee anytao --priority "高"
python3 scripts/update_workitem.py --workitem_id abc --status "进行中"

生成周报

python3 scripts/generate_weekly_report.py
python3 scripts/generate_weekly_report.py --project_id xxx --project_name "项目名称"
python3 scripts/generate_weekly_report.py --output /tmp/weekly_report.md

3️⃣ 测试管理 (Test Hub)

测试库列表

python3 scripts/query_test_library.py                                    # 全部测试库
python3 scripts/query_test_library.py --library_name "项目名称"          # 按名称搜索
python3 scripts/query_test_library.py --library_name "项目名称" --detail # 含用例统计
python3 scripts/query_test_library.py --library_id xxx --detail          # 按 ID 查详情

测试用例查询

python3 scripts/query_test_library.py --library_name "项目名称" --detail

输出示例：

📂 测试模块 (50):
   劳动用工合规: 30
   在职管理: 13
   AI工作台: 12
   首页-AI: 8
   ...

📋 用例状态分布:
   设计: 260

测试执行记录

python3 scripts/query_test_runs.py                                      # 最近执行
python3 scripts/query_test_runs.py --library_name "项目名称"            # 按测试库
python3 scripts/query_test_runs.py --days 7                              # 最近7天
python3 scripts/query_test_runs.py --detail                              # 详细结果

4️⃣ 组织架构

python3 scripts/query_users.py                            # 所有用户
python3 scripts/query_users.py --search "蔡"              # 按姓名搜索
python3 scripts/query_users.py --user_id xxx               # 用户详情（含邮箱/手机/职位）
python3 scripts/query_users.py --departments              # 部门列表
python3 scripts/query_users.py --groups                   # 团队列表
python3 scripts/query_users.py --roles                    # 角色列表
python3 scripts/query_users.py --detail                   # 显示全部用户详细信息

5️⃣ 知识管理 (Wiki)

python3 scripts/query_wiki.py                              # 知识库空间列表
python3 scripts/query_wiki.py --space_id xxx               # 空间下的页面
python3 scripts/query_wiki.py --space_id xxx --search "合规"  # 搜索页面
python3 scripts/query_wiki.py --page_id xxx                # 查看页面详情
python3 scripts/query_wiki.py --page_id xxx --content      # 查看正文内容

6️⃣ 动态 & 评论 & 工时

python3 scripts/query_activities.py --work_item_id xxx               # 查看动态
python3 scripts/query_activities.py --work_item_id xxx --comments   # 评论
python3 scripts/query_activities.py --work_item_id xxx --hours      # 工时
python3 scripts/query_activities.py --work_item_id xxx --followers  # 关注人
python3 scripts/query_activities.py --work_item_id xxx --relations  # 关联项

7️⃣ DevOps 集成

python3 scripts/query_devops.py --repos     # 代码仓库
python3 scripts/query_devops.py --commits  # 提交记录
python3 scripts/query_devops.py --pr       # Pull Request
python3 scripts/query_devops.py --builds   # 构建记录
python3 scripts/query_devops.py --deploys  # 部署记录

8️⃣ 全局看板

python3 scripts/pingcode_dashboard.py                     # 所有项目概览
python3 scripts/pingcode_dashboard.py --project "合规"     # 按项目筛选
python3 scripts/pingcode_dashboard.py --test               # 含测试库统计

脚本清单