pingcode-log-skill

PingCode 每日工作提交 Agent Skill

在 AI 对话中一句话完成：创建子任务 → 转完成状态 → 登记工时

---

功能

• 按需求编号（如 RD-IT-40）自动查找父需求
• AI 整理你的工作描述，生成规范任务标题 + 描述
• 一次性创建所有子任务并走完状态流转（打开 → 进行中 → 已完成）
• 自动登记工时（支持工作类型：研发/测试/文档/设计/部署/产品/调研/其他）
• 从 user_mapping.json 自动识别当前用户，无需每次手动填写

---

快速安装

方式一：一键安装脚本（推荐）

git clone https://github.com/your-org/pingcode-log-skill.git
cd pingcode-log-skill
./install.sh

脚本自动检测当前 AI 平台并安装到对应位置。

方式二：手动安装（指定平台）

平台	安装命令
Claude Code	cp -R pingcode-log-skill ~/.claude/skills/
Codex CLI	cp -R pingcode-log-skill ~/.codex/skills/
OpenCode	cp -R pingcode-log-skill ~/.config/opencode/skills/
Cursor (项目)	cp -R pingcode-log-skill .cursor/rules/
Cursor (用户)	cp -R pingcode-log-skill ~/.cursor/rules/
Windsurf	cp -R pingcode-log-skill .windsurf/skills/
Cline	cp -R pingcode-log-skill .clinerules/
Gemini CLI	cp -R pingcode-log-skill ~/.gemini/skills/
GitHub Copilot	cp -R pingcode-log-skill .github/skills/

---

首次配置

安装后运行配置向导：

python3 ~/.claude/skills/pingcode-log-skill/scripts/setup.py

向导会引导你：

1. 输入 PingCode CLIENT_ID 和 CLIENT_SECRET（从 PingCode 后台 → 应用管理获取）
2. 自动验证凭据是否有效
3. 填写你的姓名和 PingCode 用户 ID

配置完成后会在 skill 目录生成 .env 和 user_mapping.json。

手动配置

复制 .env.example 为 .env 并填写：

cp .env.example .env
# 编辑 .env 填入真实凭据

复制 user_mapping.example.json 为 user_mapping.json 并填写团队成员信息：

cp user_mapping.example.json user_mapping.json

---

依赖

只需一个外部库：

pip install httpx

Python 3.8+ 即可，无需虚拟环境。

---

使用方法

安装并配置完成后，在 AI 对话中输入：

/pingcode-log-skill RD-IT-40

或直接描述：

提交今日工作到 RD-IT-40

AI 会引导你：

1. 确认目标需求信息
2. 描述今日工作内容（也可以说"帮我总结 git 提交"）
3. 预览任务列表 + 确认
4. 自动创建并登记工时

---

文件结构

pingcode-log-skill/
├── SKILL.md                   # Skill 定义（< 500 行）
├── scripts/
│   ├── pingcode_sdk.py        # 独立 PingCode API 客户端
│   └── setup.py               # 首次配置向导
├── install.sh                 # 跨平台安装脚本
├── .env.example               # 凭据模板
├── user_mapping.example.json  # 用户映射模板
└── README.md

---

凭据安全

• .env 已在 .gitignore 中排除，不会被提交到版本库
• user_mapping.json 只包含 PingCode 用户 ID，不含密码
• 凭据仅存储在本地，不上传任何远程服务

---

常见问题

Q: 状态转换失败（code 100379）

A: 正常现象，SDK 会自动走两步：打开 → 进行中 → 已完成。如果仍失败，检查 PingCode 应用是否有 work_items:write 权限。

Q: 工时登记失败

A: 需要 workloads:write 权限，且 report_by 必填。确保 user_mapping.json 中有你的 pingcode_id。

Q: 找不到需求（NOT_FOUND）

A: 检查 .env 中的 PINGCODE_PROJECT_ID 是否正确。该 ID 可在 PingCode 项目 URL 中找到。