mcpField
F
fetching-work-item

fetching-work-item

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

关于 fetching-work-item

fetching-work-item 是用于协调 Jira 或 GitHub 工作项检索的工作流技能。它识别平台、调度检索器，并报告经过验证的快照和结构化交接信息；不负责后续规划或平台修改。

主要功能

  1. 01识别 Jira 和 GitHub 输入
  2. 02依据平台操作手册路由
  3. 03调度工作项检索器
  4. 04验证本地快照
  5. 05报告结构化状态与警告

适用场景

  1. 01为下游工作流获取 Jira 问题
  2. 02检索 GitHub 问题快照
  3. 03交接带有警告的部分结果
  4. 04在检索或验证失败时停止

安装

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

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

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

包含的文件

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

flow-diagram.md
references/
external-sources.md
fetch-contract.md
github-playbook.md
github-snapshot-template.md
jira-playbook.md
jira-snapshot-template.md
retrieval-playbook.md
subagents/
work-item-retriever.md

详细介绍

获取工作项

你是工作项检索协调器。请尽量缩小协调器上下文范围：检测平台，根据当前生效的操作手册确定工作项标识，派发 work-item-retriever，仅保留其结构化摘要，并报告交接状态。

此技能可独立运行。随附文件定义了工作流、约定和模板。./references/external-sources.md 中的公开 URL 是可选的即时参考资料，可用于了解当前平台语法或渐进式披露的依据；即使无法访问网络，使用本地文件也能正常执行。

工作流角色：这是编排工作流中的第 1 阶段“获取工作项”步骤。顶层编排器或用户均可直接调用此步骤，但该步骤会在生成经过验证的快照和结构化交接信息后停止。后续任务规划、创建子工作项、后续阶段验证以及平台变更均由下游工作流技能负责。

平台检测

根据输入检测平台，并针对每项平台特定决策加载匹配的操作手册：

信号平台操作手册
JIRA_URL 匹配 https://<workspace>.atlassian.net/browse/<KEY>jira./references/jira-playbook.md
ISSUE_URL 匹配 https://<host>/<owner>/<repo>/issues/<N>（包括 GitHub Enterprise），或提供 OWNER+REPO+ISSUE_NUMBERgithub./references/github-playbook.md

如果输入与两种模式均不匹配，请先提出一个有针对性的澄清问题，再派发检索器。当前生效操作手册中的“输入和标识符”部分会定义主要输入，以及工作项标识符 <KEY> 的推导方式（Jira 使用 TICKET_KEY，GitHub 使用 ISSUE_SLUG）。

输入

主要输入位于各操作手册中。将当前生效操作手册指定的平台输入直接传递给检索器；检索器会推导 <KEY> 并写入 docs/<KEY>.md。

子 Agent 注册表

子 Agent路径用途
work-item-retriever./subagents/work-item-retriever.md通过操作手册指定的传输方式读取平台数据，写入并验证 docs/<KEY>.md，并返回简洁的获取摘要

仅在派发子 Agent 时读取其文件。

渐进式信息披露地图

需求加载
协调路由与分派此 SKILL.md
Jira 平台契约（输入、传输、捕获、章节、摘要字段、速率限制、URL）./references/jira-playbook.md
GitHub 平台契约（输入、传输、捕获、章节、摘要字段、速率限制、URL）./references/github-playbook.md
状态语义、精确摘要行、报告措辞./references/fetch-contract.md
共享检索流程与验证关卡work-item-retriever 中的 ./references/retrieval-playbook.md
Markdown 快照结构活跃操作手册的快照模板文件，仅在组装期间加载
当前公开文档或有来源支持的依据./references/external-sources.md，然后仅获取相关 URL
检索器行为仅在分派时加载 ./subagents/work-item-retriever.md

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

分派模式

PLAYBOOK_PATH: ../references/<platform>-playbook.md
<primary inputs named in the active playbook's Inputs and Identifier section>
FETCH_CONTRACT_PATH: ../references/fetch-contract.md
RETRIEVAL_PLAYBOOK_PATH: ../references/retrieval-playbook.md
EXTERNAL_SOURCES_PATH: ../references/external-sources.md

这些分派路径相对于使用它们的文件 ./subagents/work-item-retriever.md。

检索器会在组装时从活跃操作手册的 Snapshot Sections 部分读取快照模板路径。

根据结构化摘要进行分支判断，而非依据说明文字：

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

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

输出契约

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

docs/<KEY>.md

将快照视为供后续阶段交接工作流状态的产物，而非实现历史。保留该文件且不要将其暂存，以便恢复工作流。仅当需要精确的摘要顺序、计数语义、标题顺序、生命周期规则或最终报告措辞时，才加载 ./references/fetch-contract.md。活跃操作手册的 Snapshot Sections 部分定义了平台专属的标题列表。

升级处理

当摘要报告 BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED 或 Validation: FAIL 时，停止并呈现检索器的结构化失败信息。仅当用户可以采取行动解决失败时，才向用户索取输入，例如 URL 格式错误、缺少坐标或缺少身份验证信息。

示例

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

识别出 jira，加载 ./references/jira-playbook.md，提取 PROJ-1234，分派 work-item-retriever，收到 FETCH: PASS 和 Validation: PASS，然后报告 docs/PROJ-1234.md、工作项标识、数量、警告，以及平台未被修改。如果由编排器调用，此 12 行摘要和文件路径就是 Phase 1 的交接内容。

输入：`ISSUE_URL=https://github.com/acme/app/issues/42`

识别出 github，加载 ./references/github-playbook.md，推导出 ISSUE_SLUG=acme-app-42，分派 work-item-retriever，收到 FETCH: PARTIAL 和 Validation: PASS，然后报告 docs/acme-app-42.md 和警告。仅在下游阶段能看到该警告的情况下继续。

评论

支持 Markdown