PingCode — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

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

开发与 DevOps

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.1.0

统计：⭐ 1 · 234 · 1 current installs · 1 all-time installs

⭐ 1

安装量（当前） 1

🛡 VirusTotal ：良性 · OpenClaw ：良性

Package：anytao/pingcode-skills

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：良性

OpenClaw 评估

The skill's code, documentation, and requested environment variables align with its stated purpose (PingCode API integration); nothing requests unrelated credentials or installs arbitrary code, though there are minor implementation/documentation notes to review before use.

目的

Name/description, SKILL.md, metadata.json and the included Python scripts all implement PingCode API actions (list projects, work items, update items, generate reports). The two required env vars (PINGCODE_CLIENT_ID, PINGCODE_CLIENT_SECRET) are appropriate for client-credentials access to PingCode.

说明范围

SKILL.md instructs running the included Python scripts and setting only the two environment variables — that matches the scripts. Minor inconsistencies: SKILL.md references a create_workitem.py (marked '待实现') but that file is not present in the package; references/api_docs.md lists slightly different endpoint paths than some scripts (e.g., /v1/agile/workitems vs /v1/project/work_items). The scripts do not perform pagination beyond a single page and return large page_size defaults — functional limitations but not malicious.

安装机制

No install spec or external downloads — this is instruction-and-source-file-only. All Python code is included in the package; nothing is fetched from third-party URLs or executed from unknown archives.

证书

Only PINGCODE_CLIENT_ID and PINGCODE_CLIENT_SECRET are required. Those are the expected credentials for the client-credentials grant used by the scripts. No other secrets, unrelated service keys, or system config paths are requested.

持久

always:false and user-invocable:true (default) — no forced or persistent platform-level presence. disable-model-invocation is false (normal); combined with the limited env vars and no install steps this does not raise extra privilege concerns.

综合结论

This package appears to be what it claims: a PingCode API client implemented as local Python scripts that use client credentials. Before installing/using: 1) Verify the PingCode app you create grants only the minimum scopes needed (avoid wide enterprise scopes if possible). 2) Keep PINGCODE_CLIENT_ID and PINGCODE_CLIENT_SECRET in a secure place (environment variables or a secrets manager), and do not paste them into chat. 3) Review the include…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「PingCode」。简介：PingCode 研发管理平台 API 集成。支持查询工作项、生成周报、管理项目进度等。使用场景：研发管理自动化、团队协作、数据分析。。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/anytao/pingcode-skills/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: pingcode
description: PingCode 研发管理平台 API 集成。支持查询工作项、生成周报、管理项目进度等。使用场景：研发管理自动化、团队协作、数据分析。
metadata:
  openclaw:
    requires:
      env:
        - PINGCODE_CLIENT_ID
        - PINGCODE_CLIENT_SECRET
---

# PingCode Skill

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

## 前置条件

1. 在 PingCode 企业后台创建应用，获取 `Client ID` 和 `Client Secret`
2. 配置应用的数据访问范围
3. **设置环境变量**（不要直接修改脚本）：
   ```bash
   export PINGCODE_CLIENT_ID="your_client_id"
   export PINGCODE_CLIENT_SECRET="your_client_secret"
   ```

## 功能脚本

### 获取我的工作项

```bash
python3 scripts/get_my_tasks.py
```

输出示例：
```
📋 你的工作项列表 (共 15 条，显示前 20 条)

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

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

### 获取项目列表

```bash
# 列出所有项目
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] 产品官网重构
   类型: 软件开发 | 状态: 进行中 | 负责人: 张三
   描述: 官网前端重构项目...
```

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

```bash
# 通过项目名称查询
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
```

### 生成项目周报

```bash
# 生成周报并输出到控制台
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
```

输出示例：
```markdown
# 📊 项目周报
生成时间：2024-03-01 14:30

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

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

### 更新工作项

```bash
# 分配负责人
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 "进行中"
```

### 创建工作项（待实现）

```bash
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` |

## 注意事项

1. **凭证安全**：使用环境变量 `PINGCODE_CLIENT_ID` 和 `PINGCODE_CLIENT_SECRET`，不要硬编码到脚本中
2. **频率限制**：每分钟最多 200 次请求
3. **Token 有效期**：30 天
4. **分页**：默认每页 30 条，最大 100 条