mcpField
E
explain-pr

explain-pr

github.com/carlitose开发042 次安装2 周前更新
代码仓库

关于 explain-pr

根据已验证的验证包生成 PR 正文的 Skill，适用于需要关联证据描述变更并验证正文的工作流；代码审查、合并决策和提供方操作不在其职责范围内。

主要功能

  1. 01生成规定的 PR 正文部分
  2. 02加入变更前后的 Mermaid 图
  3. 03使用证据中的原始 ID 和判定
  4. 04验证生成的正文
  5. 05按请求更新并回读 PR 正文

适用场景

  1. 01根据已验证证据准备 PR 描述
  2. 02检查 PR 正文是否符合契约
  3. 03发布并重新验证所请求的 PR 正文更新

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/carlitose/agent-skills --skill explain-pr

安装后在 Claude Code 中输入/explain-pr确认已加载。

附带文件agents/openai.yaml

详细介绍

解释 PR

职责：根据已验证的证据包渲染 PR 正文。不负责审查代码、重新解读证据、提高声明上限、授权合并或决定集成。

必需章节、可见性规则和措辞上限均来自规范的 Verification Record 及其 验证器。

输入

要求提供：

  • PR 标识符，或已准备好的分支／base／head 上下文；
  • 规范化的工单摘要；
  • 已冻结的 CandidateRef 和观察到的提供方 PR head SHA；
  • 已验证的验证证据包；
  • 简明的代码映射或差异事实。

拒绝缺失或过时的证据包。绝不将模拟、跳过或受门控的证据描述得更有力。

由 ticket-autopilot 调用时，还要求提供运行器完整的 render-required 请求。原样保留其 render_request_hash 和 expected_head_sha；不要重新计算或替换任一标识。

渲染

生成契约要求的标题，包括：

  • 改了什么以及原因；
  • 修改前后的行为；
  • 代码映射；
  • 测试和分类后的证据；
  • 尚未通过或失败的门控及剩余限制；
  • 审阅者检查清单；
  • 恰好一张修改前／后的 Mermaid 图。

使用证据包中的原样 ID 和处置结果，确保机器和审阅者能够追溯每项陈述。不要添加禁止使用的措辞，也不要推断提供方能力。

使用以下内容验证渲染后的正文：

VERIFICATION_AUDIT_ROOT 是从技能目录解析出的 verification-audit 技能根目录的绝对路径，绝不能从仓库 cwd 获取。

python3 -B "$VERIFICATION_AUDIT_ROOT/scripts/verification_contract.py" \
  validate-pr <bundle.json> <body.md> --pr-head-sha <observed-sha>

如果验证失败，只修正渲染内容。语义上的证据包问题应退回 verification-audit；head 发生变化则需要重新获取上游证据。

用户或调度器要求发布时，只能通过所选提供方适配器更新 PR 正文，读取更新后的正文，并重新验证观察到的正文／head。返回正文、验证结果、提供方观察结果以及任何发布错误。绝不合并。

向运行器交接时，返回 render_request_hash、expected_head_sha、 rendered_body、同一份已验证的 verification_bundle，以及绝对路径 verification_audit_root。内容寻址工件的持久化、提供方变更与回读，以及决定是否可进入 pr-open，均由运行器负责，而非此技能负责。

评论

支持 Markdown