用途:在西班牙语环境下安全管理 Jira Cloud 问题,是 krt-jira-scribe 的 Cloud 版本;Jira Server/Data Center 应使用 krt-jira-scribe,本技能仅用于 *.atlassian.net 云站点。
主要能力:通过 Jira Cloud REST API v3(/rest/api/3)进行平台调用,通过 Jira Software Cloud Agile API(/rest/agile/1.0)处理看板与冲刺;使用 Basic Auth,凭据为 JIRA_CLOUD_EMAIL 与 JIRA_CLOUD_API_TOKEN;描述与评论正文使用 Atlassian Document Format;用户使用 accountId。支持问题/子任务创建、PR 反向链接、状态流转,以及自主变更前的校验脚本。
使用方式:运行时仅用环境变量,项目本地来源为 .krt/env/jira-cloud-scribe.env,包含 JIRA_CLOUD_HOST、JIRA_CLOUD_EMAIL、JIRA_CLOUD_API_TOKEN、JIRA_CLOUD_PROJECT_KEY,可选 JIRA_CLOUD_BOARD_ID。设置项目本地配置可运行:python3 <jira-cloud-scribe-skill-dir>/scripts/setup_jira_env.py --root <consumer-project-root>。检查环境可运行:python3 <jira-cloud-scribe-skill-dir>/scripts/check_jira_env.py --root <consumer-project-root> --strict。未加载 shell 时通过 python3 <jira-cloud-scribe-skill-dir>/scripts/run_with_jira_env.py --root <consumer-project-root> -- <command ...> 执行命令。开始前需加载 references/safety.md 与 references/jira-cloud-api.md。
适用场景:在 Jira Cloud 中创建或复用问题与子任务、添加 PR 反向链接、确认并执行状态流转,且要求西班牙语摘要、描述与评论。
限制:Jira Cloud 为共享外部系统,未经明确确认不得创建问题、子任务、PR 反向链接、评论或流转;不得询问凭据,不得打印 JIRA_CLOUD_API_TOKEN;缺失变量或本地环境文件时应报错终止;JQL 关键字保持英文;流转名称需从 API 获取,不可假设英文名;自定义字段 ID 不可猜测。其余细节暂未提供。