用途
Jira Projects Skill 用于管理 Jira 项目，提供列出项目、获取项目配置、检索问题类型以及管理项目组件和版本的能力。该技能面向需要通过 API 与 Jira 项目数据进行交互的自动化场景或智能体。
主要能力
- 列出所有项目：支持按状态（LIVE、ARCHIVED、DELETED）筛选，支持 expand 参数和分页（maxResults、startAt）。返回项目列表，包含 id、key、name、projectTypeKey、simplified、style、avatarUrls、description、lead 等字段。
- 获取项目详情：根据项目 key 或 ID 获取项目信息，支持 expand 参数以包含额外字段。
- 获取项目问题类型：返回项目可用的问题类型列表，包含 id、name、description、iconUrl、subtask、hierarchyLevel 等字段。
- 获取项目组件：返回项目组件列表，包含 id、name、description、lead、project、projectId 等字段。
- 获取项目版本：支持按状态（UNRELEASED、RELEASED、ARCHIVED）筛选，支持 expand 参数。返回版本列表，包含 id、name、description、archived、released、releaseDate、startDate、overdue 等字段。
使用方式
前置条件
- 已认证的 JiraClient（参见 jira-auth 技能）
- 项目浏览权限
实现模式
技能提供 TypeScript 函数示例，包括 listProjects、getProject、getProjectIssueTypes、getProjectComponents、getProjectVersions。这些函数封装了对 Jira REST API v3 的请求，使用 JiraClient 的 request 方法。
API 端点
- 列出项目：GET /projects
- 获取项目：GET /projects/{projectIdOrKey}
- 获取问题类型：GET /projects/{projectIdOrKey}/issuetypes
- 获取组件：GET /projects/{projectIdOrKey}/components
- 获取版本：GET /projects/{projectIdOrKey}/versions
Expand 选项
可用的 expand 参数包括：description（项目描述）、lead（项目负责人详情）、issueTypes（可用问题类型）、url（项目 URL）、permissions（当前用户权限）、projectKeys（所有项目 key）。
curl 示例
技能提供了列出项目、获取项目详情、获取问题类型的 curl 示例，使用 Basic 认证，请求头包含 Authorization 和 Accept: application/json。
适用场景
- 需要列出 Jira 中所有可用项目的自动化任务。
- 获取特定项目的配置信息（如问题类型、组件、版本）。
- 在项目管理或同步工具中检索项目元数据。
- 需要根据项目状态或版本状态进行筛选的场景。
限制
- 需要有效的 Jira 认证和项目浏览权限，否则无法访问。
- 返回结果可能受 Jira 实例的权限配置影响。
- 分页处理需要调用方自行实现，否则可能只获取部分数据。
- 使用项目名称而非 key/ID 会导致错误。
- 未处理已归档项目可能导致意外结果。
- 技能本身不包含创建、更新或删除项目的功能描述，仅涵盖列出、获取详情、获取问题类型、获取组件和版本。
- 具体收费、价格、平台或效果信息暂未提供。