SuperAPI AI 工具集

azure-functions-feedback

编程与开发

查看项目

更新于 11-13 16:37

技能介绍

用途

azure-functions-feedback 是一个反馈整理技能,用于在 Azure Functions 相关工作流结束后,把会话中暴露的改进机会转化为可追踪的 GitHub Issue。反馈对象限定为 azure-functions-* 系列技能、其参考文档或插件 README,而不是普通应用缺陷。

适用时机

  • 用户主动要求为 Azure Functions Skills 提交反馈或创建 Issue。
  • 工作流中发现指引混乱、缺少验证步骤、命令过时、MCP 工具用法错误、重复恢复步骤或缺少诊断证据。
  • 智能体因 azure-functions-* 技能问题需要用户纠正。
  • 手动测试或端到端测试产生了可复用的发现。

若发现的问题与技能套件本身无关,则不应使用该技能。

工作方式

  1. 回顾会话:查看对话历史、变更文件、测试输出和命令结果,提炼受影响技能或文件、观察到的行为、预期行为、会话证据、复现步骤或场景、建议修复或文档修改,以及风险与影响。同时对密钥、租户敏感数据、函数密钥、发布配置文件、令牌、连接字符串和客户数据进行脱敏,仅保留用户明确允许分享的资源名或 URL。
  2. 征询用户:若反馈可能有用,简洁询问用户是否希望将其预览为 Issue,选项为“Issue”或“暂时不用”。未经明确确认不得创建外部 GitHub 产物。
  3. 生成预览:在创建任何内容前,展示包含 Title、Summary、Affected area、Evidence、Repro / scenario、Expected behavior、Proposed change、Validation plan、Redactions applied 的结构化预览,并请用户批准或编辑。
  4. 处理 Issue:批准后先在 microsoft/azure-dev-tools 中检索已有 Issue,同时覆盖开放与近期关闭的 Issue。若存在相同或明显相似的话题,不创建重复 Issue,而是补充简短评论并说明新证据,向用户报告已有 Issue URL。若不存在相似 Issue,则按预览内容新建,标题以 [azure-functions] 开头。优先使用 GitHub CLI;不可用时提供准备好的 Issue 或评论正文,请用户手动创建或发布。完成后报告 URL 与后续动作。
  5. 关于建议修改:公开仓库包含的是已发布插件包而非其维护源码,因此不应针对已发布包提交 PR。若用户希望提出具体修改,可将建议文本或统一 diff 放入 Issue 正文的 Proposed change 部分。避免包含无关本地文档、PLAN 文件、密钥、生成的临时文件或用户特定日志。
  6. 输出:结束时给出已创建或更新的 Issue URL,以及有意跳过的反馈项。

质量要求

反馈应具体、可操作并有观察证据支撑;每个内聚主题对应一个 Issue;不要仅凭一次失败过度概括,除非技能指引本身导致该失败或未能从中恢复;保持用户的语言与语气。

限制

该技能只处理技能套件层面的反馈,不适用于普通应用缺陷;不会在未获用户明确确认时创建外部 GitHub 产物;不针对已发布插件包提交拉取请求;未提供时不得编造功能、收费或平台信息。