Agent Skill 核验档案

写作助手 · Pr Writing Review

PR Writing Review 用于从 GitHub 拉取请求的审查评论中提取并分析写作改进，包括明确的建议块与普通文本反馈，并将原始措辞和审查者建议进行结构化对比。

适用任务

提取拉取请求内联审查评论中的原文到建议文本对，以及审查者备注和 GitHub 永久链接。
将普通文本审查反馈映射到首稿和最终版本中的对应段落，说明改动及其原因。
逐段比较首稿和最终版本，归纳新增、删除、改写与结构调整。
按清晰度、精确性、语气、结构、语法和内容等类别综合写作风格模式。

输入

完整的 GitHub 拉取请求 URL。
`owner/repo PR_NUMBER` 格式的仓库与拉取请求编号。
`owner repo PR_NUMBER` 格式的仓库所有者、仓库名与拉取请求编号。
可选脚本参数：`--diff`、`--max-file-chars N`、`--no-files`、`--json`。

输出

默认输出：按审查者分组的写作建议，包含原文到建议文本、审查者备注及 GitHub 永久链接。
默认输出：不含代码建议的普通审查评论，并附 GitHub 链接。
使用 `--diff` 时：明确建议、编号的审查反馈，以及每个 `.md`、`.txt`、`.rst`、`.mdx` 文件的首稿和最终版本。
使用 `--json` 时：原始 JSON；在 `--diff` 且未使用 `--no-files` 时包含 `file_evolutions`。

限制与检查

只提取内联拉取请求审查评论，不提取议题评论或拉取请求描述。
极长文件仍可能造成较大负担；可降低 `--max-file-chars`，或使用 `--no-files` 以保持输出适合提示词。
确认传入的是完整拉取请求 URL，或来源支持的仓库与拉取请求编号格式。
确认 `gh auth status` 显示已登录，并在访问私有仓库时具备适当令牌权限。
需要首稿与最终版本比较时，确认使用 `--diff`；仅需建议和反馈摘要时可不使用该参数。
输出较长时，确认 `--max-file-chars` 的截断值或 `--no-files` 是否符合分析需要。
确认分析范围仅包含内联拉取请求审查评论，未将议题评论或拉取请求描述视为提取结果。

今日榜单

0