SuperAPI AI 工具集

fusion-issue-authoring

办公与效率

查看项目

更新于 10-16 05:07

技能介绍

用途:把想法、缺陷、功能请求或用户需求转化为清晰、可执行的 GitHub Issue,并作为创建和更新 Issue 的顶层路由。典型触发包括“create an issue”“draft a ticket”“turn this into a GitHub issue”“help me structure this work item”,以及更新、维护、清理 Issue 或添加子 Issue、设置父 Issue、建立子级链接。不适用于实现代码改动、编写或审查 PR、不产出 Issue 草稿的一般研究,以及未经用户明确确认就改动 GitHub 状态。

主要能力:按 Bug、Feature、User Story、Task 分类,并激活对应内部智能体模式(agents/bug.agent.md、agents/feature.agent.md、agents/user-story.agent.md、agents/task.agent.md)。devils-advocate.agent.md 始终以 moderate 模式运行,在分类后提出 2–3 个关键关注点;当用户要求“grilled”“stress-test this”、范围或验收标准缺口显著,或从 fusion-issue-task-planning 调用且存在两个及以上架构歧义信号时,升级为 interrogator 模式进行结构化访谈。用户不直接引用智能体文件。共享门(标签、指派人确认、草稿评审、发布确认、变更顺序)保留在本技能中。

使用方式:先收集目标仓库、Issue 意图与类型、更新时的现有 Issue 编号或 URL、仓库标签集、父子或依赖关系、指派人偏好等必要输入。步骤为:分类并路由;解析仓库与模板(优先 .github/ISSUE_TEMPLATE/,其次回退模板);用 mcp_github::search_issues 做一次聚焦的重复检查;先写草稿(默认 .tmp/{TYPE}-{CONTEXT}.md,使用 GitHub Flavored Markdown);评审并确认;应用共享门;按顺序通过 MCP 变更(mcp_github::issue_write、mcp_github::sub_issue_write、mcp_github::add_issue_comment);校验关系。

限制与安全:任何 GitHub 变更前必须获得用户明确确认,不得在用户确认草稿内容正确前发布或更新,不得假设用户想发布到 GitHub,不得请求或暴露密钥凭据,不得未经确认执行破坏性命令。标签只使用目标仓库中存在的标签;type 仅在仓库配置了 Issue 类型时使用。遇到速率限制应停止非必要查询并给出安全重试计划,而非循环重试。MCP 服务器或认证缺失时需说明失败并引导用户按 references/mcp-server.md 完成设置。详细行为与载荷示例见 references/instructions.md 和 references/mcp-server.md。