Agent Skills › vercel/eve › gh-pr-description

gh-pr-description

GitHub

用于撰写和审查 GitHub PR 描述，引导以变更原因为核心，提供结构化模板与发布命令指导。

.agents/skills/gh-pr-description/SKILL.md vercel/eve

触发场景

打开或更新 Pull Request 为 Reviewer 总结分支变更

安装

npx skills add vercel/eve --skill gh-pr-description -g -y

更多选项

非标准路径

npx skills add https://github.com/vercel/eve/tree/main/.agents/skills/gh-pr-description -g -y

不安装直接使用

npx skills use vercel/eve@gh-pr-description

指定 Agent (Claude Code)

npx skills add vercel/eve --skill gh-pr-description -a claude-code -g -y

安装 repo 全部 skill

npx skills add vercel/eve --all -g -y

预览 repo 内 skill

npx skills add vercel/eve --list

SKILL.md

Frontmatter

{
    "name": "gh-pr-description",
    "description": "Drafts and reviews GitHub pull request descriptions for the eve repository. Use when opening, updating, or reviewing a PR, or when summarizing a branch for reviewers."
}

GitHub PR description

Inspect the branch diff, commits, related issue or discussion, tests, docs, and changesets. When updating a PR, read its current body first.

Write

Fill in .github/pull_request_template.md. Write for a reviewer, not a changelog:

Keep the Summary to one short paragraph: usually 2–4 sentences and about 100 words or fewer.
Lead with the concrete problem, user need, or decision behind the change; follow with the solution and meaningful behavior. Prefer short sentences; split independent points rather than combining them into a long sentence.
Do not list files or narrate commits. Include implementation detail only when it is necessary to assess behavior or risk.
Mention breaking changes, preserved behavior, tradeoffs, scope boundaries, follow-ups, or stacked PRs only when they matter to review.
Link an existing issue or discussion with Closes #N, Related to #N, or an equivalent when one exists. Do not create an issue solely for a PR.
State only validation that actually ran, including limitations or failures.

Preserve the checklist and check only verified items.

Publish

Before publishing, confirm the Summary leads with why the change is needed. Write the body to a file, then pass it to gh pr create or gh pr edit with --body-file.