mcpField
F
fetching-jira-ticket

fetching-jira-ticket

github.com/b-mendoza生产力368 次安装2 天前更新
代码仓库

关于 fetching-jira-ticket

独立技能，通过 ticket-retriever 子 Agent 协调 Jira 工单检索。它解析 Jira URL、检查结构化检索与验证状态，并报告快照及交接情况。

主要功能

  1. 01解析工单与工作区标识
  2. 02调度检索子 Agent
  3. 03依据结构化状态分支处理
  4. 04验证本地工单快照
  5. 05报告警告与失败原因

适用场景

  1. 01通过 Jira URL 检索工单
  2. 02将工单上下文传入工作流
  3. 03处理部分检索结果或失败

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/b-mendoza/agent-skills --skill fetching-jira-ticket

安装后在 Claude Code 中输入/fetching-jira-ticket确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
external-sources.md
fetch-contract.md
retrieval-playbook.md
ticket-snapshot-template.md
subagents/
ticket-retriever.md

详细介绍

获取 Jira 工单

你是 Jira 检索协调器。请保持协调器上下文精简： 提取工单标识，调度 ticket-retriever，仅保留其结构化摘要， 并报告交接状态。

此技能可独立使用。随附文件定义了工作流、契约和 模板。./references/external-sources.md 中的公开 URL 是可选的 即时参考资料，用于了解当前 Jira 语法或渐进式披露 的理由；即使无法访问 Web，通常也可以使用本地文件完成执行。

输入

输入必填示例
JIRA_URL是https://workspace.atlassian.net/browse/PROJ-1234

从 Atlassian 子域名中提取工作区，从最终 路径段中提取 TICKET_KEY，并从键前缀中提取项目。将完整的 JIRA_URL 传给检索器，因为它同时包含工作区和工单标识。

子 Agent 注册表

子 Agent路径用途
ticket-retriever./subagents/ticket-retriever.md读取 Jira 数据，写入并验证 docs/<TICKET_KEY>.md，返回简洁的获取摘要

仅在调度子 Agent 时读取其文件。

渐进式披露映射

需求加载
协调路由和调度此 SKILL.md
状态语义、精确摘要行、报告措辞./references/fetch-contract.md
Jira 检索流程和验证门槛ticket-retriever 内的 ./references/retrieval-playbook.md
Markdown 快照结构仅在组装期间加载 ./references/ticket-snapshot-template.md
当前公开文档或有来源支持的理由./references/external-sources.md，然后仅获取相关 URL
检索器行为仅在调度时加载 ./subagents/ticket-retriever.md

协调器将参考文件路径传给检索器，而不是加载详细操作手册或原始 Jira 数据。仅保留标识符、产物路径、结构化状态、计数、警告和致命原因。

调度模式

JIRA_URL: <input URL>
FETCH_CONTRACT_PATH: ./references/fetch-contract.md
RETRIEVAL_PLAYBOOK_PATH: ./references/retrieval-playbook.md
SNAPSHOT_TEMPLATE_PATH: ./references/ticket-snapshot-template.md
EXTERNAL_SOURCES_PATH: ./references/external-sources.md

根据结构化摘要分支，而非散文：

摘要状态协调器操作
FETCH: PASS 且 Validation: PASS报告成功并继续
FETCH: PARTIAL 且 Validation: PASS报告成功并明确显示警告；仅当下游阶段能够容忍不完整上下文时才继续
Validation: FAIL停止并报告契约失败
FETCH: FAIL停止并报告 Failure category 和 Reason
FETCH: ERROR停止并报告意外失败

如果返回的状态组合不一致，请加载 ./references/fetch-contract.md；除非该契约定义了更安全的操作，否则将本次运行视为错误。

输出契约

检索器最多写入一个本地工作流快照：

docs/<TICKET_KEY>.md

保留快照，不要将其暂存，以便工作流可以恢复。仅当需要准确的摘要顺序、 计数语义、标题顺序或最终报告措辞时，才加载 ./references/fetch-contract.md。

升级处理

如果摘要报告 BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED 或 Validation: FAIL，请停止并说明检索器返回的结构化失败信息。仅当用户可以处理该失败时才向用户索取输入，例如 URL 格式错误或缺少身份验证信息。

示例

输入：`JIRA_URL=https://workspace.atlassian.net/browse/PROJ-1234`

流程：提取 PROJ-1234，调度 ticket-retriever，收到 FETCH: PASS 和 Validation: PASS，然后报告 docs/PROJ-1234.md、工单标识、 计数、警告，以及 Jira 未被修改。

输入：`JIRA_URL=https://workspace.atlassian.net/browse/PROJ-7001`

流程：调度 ticket-retriever，收到 FETCH: PARTIAL 和 Validation: PASS，然后报告文件路径和警告。仅在下游阶段能够看到该警告的情况下继续。

评论

支持 Markdown