SuperAPI AI 工具集

fetching-jira-ticket

办公与效率

查看项目

更新于 10-15 20:05

技能介绍

用途:作为 Jira 检索协调器,从 Jira URL 派生工单身份,调度 ticket-retriever 子代理读取 Jira 数据,写出并验证 docs/<TICKET_KEY>.md,只保留结构化摘要并报告交接状态,保持协调器上下文精简。

主要能力:从 Atlassian 子域派生工作区,从路径末段派生 TICKET_KEY,从键前缀派生项目;将完整 JIRA_URL 传给检索器;根据结构化摘要分支处理:FETCH: PASS 且 Validation: PASS 报告成功并继续;FETCH: PARTIAL 且 Validation: PASS 带可见警告报告,仅当下游能容忍部分上下文时继续;Validation: FAIL 停止并报告契约失败;FETCH: FAIL 停止并报告失败类别与原因;FETCH: ERROR 停止并报告意外失败。状态配对不一致时加载 fetch-contract 并按错误处理。

使用方式:提供必填输入 JIRA_URL,调度 ticket-retriever,并传入 FETCH_CONTRACT_PATH、RETRIEVAL_PLAYBOOK_PATH、SNAPSHOT_TEMPLATE_PATH、EXTERNAL_SOURCES_PATH 等引用路径。检索器最多写出一个本地工作流快照 docs/<TICKET_KEY>.md,并保持原位、不暂存以便工作流可恢复。仅在需要精确摘要顺序、计数语义、标题顺序或最终报告措辞时加载 ./references/fetch-contract.md。

适用场景:需要 Jira 工单只读、经验证的 Markdown 快照供下游工作流阶段使用时。

限制:该技能独立运行,多为本地文件执行;external-sources.md 中的公开 URL 仅为可选的即时来源,无网络访问时仍可本地执行。当摘要报告 BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED 或 Validation: FAIL 时停止并呈现结构化失败;仅当失败可由用户处理(如 URL 格式错误或缺少认证)时才请求用户输入。资料未提供具体价格、平台覆盖范围、Jira 版本支持、重试策略或性能指标。