YouTrack项目管理

技能简介

通过REST API与YouTrack项目管理系统交互，支持读取项目和工单、创建任务、从工时数据生成客户发票，以及管理知识库文章。

业务背景

让项目数据自动流转于业务环节，减少手工导出核对的工作量。通过API直连YouTrack，实现工单状态同步、工时自动汇总及发票生成，确保交付进度与客户计费的数据一致性，降低跨系统操作差错。

落地案例：咨询团队月末需向客户结算，项目经理配置永久令牌后，技能按项目ID拉取当月全部工单及关联工时，自动生成含明细的发票文本。财务复核金额无误后直接发送，替代了过去逐条复制粘贴的繁琐流程。

能做什么

• 查询项目列表和工单详情
• 创建或更新工单
• 根据工时记录生成客户发票
• 管理知识库文章

使用说明

1. 获取永久令牌

登录YouTrack后，依次进入管理 > 访问管理 > 用户，找到当前用户并生成永久API令牌。

2. 配置环境变量

export YOUTRACK_TOKEN=your-permanent-token-here

3. 安装依赖

将代码仓库克隆到本地，确保Python 3环境可用，安装所需依赖包（如requests）。

4. 基础操作

列出所有项目：

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-projects

查询指定项目工单：

python3 scripts/youtrack_api.py --url https://your-instance.youtrack.cloud --list-issues "project: MyProject"

生成月度发票：

python3 scripts/invoice_generator.py --url https://your-instance.youtrack.cloud --project MyProject --month "January 2026" --from-date "2026-01-01" --rate 100

输入与输出

见下方输入与输出表格。

风险提示

• 永久令牌需妥善保管，避免泄露导致未授权访问
• 发票金额依赖工时记录准确性，建议核对后再发送客户
• API调用频率受实例限制，大量数据操作建议分批处理

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/digisal/youtrack-digisal/SKILL.md
来源类型：GitHub仓库