用途:该技能为 OpenProject 提供 API v3 集成,通过单一命令行工具 op.py 完成项目管理相关操作,覆盖工作包、时间跟踪、项目、通知和用户等模块。
主要能力:系统类命令可检查连接与配置状态(status)、初始化项目配置(init <project_id>)、查看完整配置(config)。工作包命令支持列出、获取、创建、更新、删除工作包,添加评论、查看活动与关系、创建或删除关系、获取表单 schema,并可按状态、类型、负责人、父级、项目等过滤。时间跟踪支持记录、列出、查询今日、获取、更新、删除时间条目及列出活动类型。项目命令支持列出、获取、创建、更新、删除项目,以及列出版本和类别。通知命令支持列出、计数、标记已读/未读及全部已读。用户命令支持列出、获取及查看当前用户。另有 members、types、statuses、priorities 等基于配置缓存的查询命令。
使用方式:进入技能目录后执行 uv sync 安装依赖,在 .env 中配置 OPENPROJECT_URL 与 OPENPROJECT_API_KEY(API 密钥来自 OpenProject 的 My Account → Access Tokens)。首次使用执行 uv run python op.py init 13 初始化项目配置,随后可用 uv run python op.py status 检查状态,再执行具体命令,例如 uv run python op.py wp list --status open。所有命令输出 JSON。名称解析依赖配置缓存,需通过 init 刷新;自定义字段因项目/类型而异,可用 config 查看。op.py 会自动加载 .env。
适用场景:适合在命令行或自动化流程中批量管理 OpenProject 的工作包、工时与项目数据。
限制:资料未提供收费、价格、平台兼容性及效果等信息;复杂操作可改用 Python 包直接调用,但需注意 list_* 返回生成器、时间小时数为 ISO 8601 时长、get_schema 需同时提供 project_id 和 type_id 等细节。