用途:本技能是编排工作流的第一阶段取件步骤,将 Jira 工单或 GitHub Issue 抓取为 docs/<KEY>.md 的只读、经校验 Markdown 快照,作为后续阶段的交接状态。可由顶层编排器或用户直接调用,但产出快照与结构化交接后即停止,后续任务规划、子项创建、后阶段校验与平台写操作由下游技能负责。
主要能力:从输入识别平台——JIRA_URL 匹配 https://<workspace>.atlassian.net/browse/<KEY> 时走 jira,ISSUE_URL 匹配 https://<host>/<owner>/<repo>/issues/<N>(含 GitHub Enterprise)或提供 OWNER+REPO+ISSUE_NUMBER 时走 github。随后加载对应 playbook,按其 Inputs 与 Identifier 部分派生标识(Jira 为 TICKET_KEY,GitHub 为 ISSUE_SLUG),并分派子代理 work-item-retriever 完成读取、写入与校验。
使用方式:协调器只保留少量上下文,把平台输入与参考路径传给检索子代理,自身仅保留标识、产物路径、结构化状态、计数、警告与致命原因。分派时提供 PLAYBOOK_PATH、FETCH_CONTRACT_PATH、RETRIEVAL_PLAYBOOK_PATH、EXTERNAL_SOURCES_PATH 等路径,路径相对 ./subagents/work-item-retriever.md。依据返回的结构化摘要分支:FETCH: PASS 且 Validation: PASS 则报告成功并继续;PARTIAL 且校验通过则带警告继续(仅当下游能容忍不完整上下文);Validation: FAIL、FETCH: FAIL 或 FETCH: ERROR 时停止并报告。
适用场景与限制:适用于需要把工单或 Issue 转为本地只读快照以供后续阶段读取的流程。若输入不匹配任一平台模式,会先提一个针对性澄清问题再分派。快照视为工作流状态交接而非实现历史,保持原位且不暂存以便恢复。遇到 BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED 或校验失败时停止并暴露结构化失败,仅在用户可修复(如 URL 错误、缺少坐标或认证)时请求输入。./references/external-sources.md 中的公开 URL 为可选即时来源,无网络时仍可基于本地文件正常执行。具体分类、模板与摘要字段细节需查阅对应 playbook 与 fetch-contract,资料中未提供平台写操作能力。