spec-pr-comment-resolver

You implement one PR review fix that the orchestrator has already judged valid and worth doing.

ASCII 调度图

documentation / PR support phase
  |
  v
selector: task stage + risk domain + evidence gap
  |
  v
spec-pr-comment-resolver
  |
  v
structured findings / research notes / specialist advice
  |
  v
orchestrator synthesis + user-visible decision

基本信息

字段	内容
Agent	spec-pr-comment-resolver
类型	Documentation / PR
归属 skill	spec-resolve-pr-feedback
复用次数	1 个 skill
Source	skills/spec-resolve-pr-feedback/references/agents/pr-comment-resolver.md

什么时候会被调用

• README、PR review threads、发布说明或 reviewer feedback 需要专项处理。
• 通常由上层 workflow 选择调用；它不是用户直接执行的 spec-* workflow 入口。
• 当任务证据不足、风险域明确或需要独立专家视角时，才应该引入该 agent。

Source 角色摘要

You implement one PR review fix that the orchestrator has already judged valid and worth doing. Your job is to implement it well and return a structured summary -- not to re-litigate whether it was worth fixing. The legitimacy gate already happened in the context that could see every thread at once; you have a narrower view, so you do not get to overturn the decision on a hunch (see Bail-out for the one exception).

Source 章节

• Security
• What you receive
• Workflow
• Bail-out (rare)
• Principles

输入

• 目标读者、diff、review comments、项目文档风格和已验证事实。
• 上层 workflow 应提供明确 scope、相关文件或文档、当前假设和需要回答的问题。
• 如果依赖 graph、MCP、浏览器或外部资料，需要同时说明 provider readiness 与 degraded 状态。

输出

• 文档草稿、PR 回复、thread 处理结果或面向 reviewer 的说明。
• 输出应返回给 orchestrator 汇总，而不是绕过主 workflow 直接改变最终结论。
• 对 findings、风险和建议应标注证据边界，避免把推测写成确定事实。

使用边界

• 不应为未验证功能写成已完成能力；PR 回复必须匹配实际 diff。
• Agent 是专业判断角色，不是 tool，也不是固定状态机。
• 如果当前问题可以由 deterministic script、测试或 provider status 直接确认，应优先使用确定性证据。

与 workflow 的关系

• Skills 定义入口、步骤和产物；agents 提供局部专家判断。
• 当前 agent 的 runtime copy 由 spec-first init 在目标项目中选择宿主后从 source 生成。
• 不要手改 .claude/agents 或 .codex/agents 作为 source；需要修复 runtime drift 时重新运行 init。

源码校准

• 本页由 website/scripts/generate-agent-detail-pages.js 从 skills/spec-resolve-pr-feedback/references/agents/pr-comment-resolver.md 生成。
• 上游 agent 现为 skill-local prompt 资产（skills/<skill>/references/agents/*.md），无 frontmatter；名称取自文件名，description 由生成器从 prompt 首段启发式提取。
• 分组是官网生成器的用户手册视角，用于解释调度场景；精确角色指令仍以 source agent 文件为准。

阅读下一步

• 归属 skill：spec-resolve-pr-feedback
• Agents 参考：按 skill 归属查看 26 个 agents
• Skills 参考：查看 workflow 入口与 skill 详情页
• Code Review 指南：理解 reviewer personas 如何进入 review gate