SuperAPI AI 工具集

fetching-github-issue

通用与其它

查看项目

更新于 10-15 20:05

技能介绍

用途:作为 GitHub 编排工作流的 Phase 1 fetch-work-item 步骤,把指定 GitHub issue 抓取为本地 Markdown 快照,并进行校验,产出结构化交接信息。也可由用户直接调用,但只完成抓取与快照校验,不做任务规划、子 issue 创建或任何 GitHub 写操作。

输入:优先使用 ISSUE_URL(如 https://github.com/acme/app/issues/42);也可用 OWNER、REPO、ISSUE_NUMBER 组合。有 URL 时从中解析三者,owner 与 repo 规范化为小写,生成 ISSUE_SLUG=<owner>-<repo>-<number>。

工作方式:协调者保持上下文精简,仅保存标识、产物路径、结构化状态、计数、警告与致命原因,将详细流程交给子代理 issue-retriever(路径 ./subagents/issue-retriever.md,仅在派发时读取)。派发时传入 ISSUE_URL 或坐标,以及 FETCH_CONTRACT_PATH、RETRIEVAL_PLAYBOOK_PATH、SNAPSHOT_TEMPLATE_PATH、EXTERNAL_SOURCES_PATH 等引用路径。

分支处理依据结构化摘要:FETCH: PASS 且 Validation: PASS 报告成功并继续;FETCH: PARTIAL 且 Validation: PASS 保留可见警告后继续(仅当下游可容忍部分上下文);Validation: FAIL 停止并报告契约失败;FETCH: FAIL 停止并报告失败类别与原因;FETCH: ERROR 停止并报告意外失败。状态配对不一致时视为错误。

输出:最多写入一个本地工作流快照 docs/<ISSUE_SLUG>.md,保留且不暂存以支持恢复,视为阶段状态交接而非实现记录。遇到 BAD_INPUT、NOT_FOUND、AUTH、TOOLS_MISSING、RATE_LIMIT、UNEXPECTED 或 Validation: FAIL 时,停止并上报结构化失败;仅当用户可操作(如缺少坐标或 GitHub 认证)时才向用户询问。

限制:仅做只读检索,不修改 GitHub;后续任务规划、子 issue 创建与写操作由下游技能负责。公开 URL 为可选的即时来源,无网络时仍可依赖本地文件执行。具体计费、支持平台与完整安装步骤资料未提供。