用途:这是 microsoft/agent-framework 仓库的 Pull Request 工作流技能,覆盖两件事:编写高质量 PR 描述,以及处理已有 PR 上的评审意见。
编写 PR 描述:必须遵循仓库模板 .github/pull_request_template.md,保持其结构与标题不变,并填写每一节。动机与背景要说明问题与场景;描述与评审指南要说明主要变更、影响,以及希望评审者关注的重点(该项仅面向人类评审者,自动化/AI 评审应忽略它并评审全部变更)。相关议题需用 Fixes #123 或 Closes #123 关联,合并时自动关闭;重大变更需确认维护者已加 ready-for-implementation 标签或明确同意方向;无关议题的 PR 可能被直接关闭;开 PR 前应确认同一议题没有其他开启中的 PR。显然无需议题的琐碎修改填“N/A - trivial change”并简要说明;仓库维护的定时自动化填“N/A - repository automation”并指明生成工作流。AI 辅助一节须二选一:未使用材料性 AI 辅助,或选择“This is an AI-assisted contribution.”并说明辅助范围;用 Copilot 生成或大幅编辑 PR 描述也算材料性 AI 辅助,且不得披露提示词或敏感信息。贡献清单需逐项勾选,破坏性变更需添加 breaking change 标签或在标题加 [BREAKING] 前缀(可与 Python:、.NET: 等语言前缀并列,工作流会自动同步)。不要添加“Validation”“Tests run”等临时章节,不要删除或重排模板标题。Python 函数调用循环相关变更需参照 docs/specs/004-python-function-calling-loop.md 校验,默认不修改该规格。community-projects.md 变更或涉及外部项目收录时需先加载 community-projects 技能。新 PR 以草稿形式创建,示例:gh pr create --repo microsoft/agent-framework --base main --head <your-fork-owner>:<branch> --draft --title "<concise title>" --body "<body following the template>"。
处理评审意见:依次读完全部评论与线程(含行内评论与总体评审摘要);产出具体处理计划(含不采纳的理由);先让用户审阅并等待确认,再实现;对每条评论都回复,最好引用对应提交;回复并完成讨论后自行解决评审线程,不等待评审者或维护者,仅在仍有未答复问题或进行中讨论时保留线程。
常用命令:gh api repos/{owner}/{repo}/pulls/{pr}/comments 列出/行内评论;GraphQL reviewThreads 查询线程及解决状态;gh api repos/{owner}/{repo}/pulls/{pr}/comments/{comment_id}/replies 回复行内评论;GraphQL resolveReviewThread 解决线程(需要线程节点 id)。
限制:技能仅针对该仓库流程与模板,其他仓库未提供;价格、平台等信息暂未提供。