Agent Skillsvercel/eve › gh-pr-description

gh-pr-description

GitHub

用于起草、审查和更新 GitHub PR 描述。通过分析代码变更和相关文档,生成结构化的 PR 说明,涵盖问题、解决方案、验证方法及注意事项,辅助代码审查流程。

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

Trigger Scenarios

创建或更新 Pull Request 审查 PR 描述内容 总结分支变更供 Reviewer 参考

Install

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

Non-standard path

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

Use without installing

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

See review notes for the maintainer patterns behind this workflow; they describe what to cover, not how much to write.

Read CONTRIBUTING.md and .github/pull_request_template.md, then inspect the branch diff, commits, related issue, tests, docs, and changesets. If updating a PR, read its current body too.

Fill in the repository template. Write for a reviewer:

  • explain the concrete problem and solution near the top
  • summarize meaningful behavior and decisions, not files or commits
  • mention breaking changes, preserved behavior, scope boundaries, or stacked PRs only when relevant
  • link the prior issue with Closes #N, Related to #N, or equivalent
  • scale length with risk, not diff size

Default to the shortest body that answers the four questions below. Keep the Summary under 5 sentences for most PRs; exceed 10 lines only for breaking or cross-cutting changes. Prefer plain language. Include implementation detail or jargon only when the reviewer cannot assess behavior or risk without it. Do not restate the issue, template guidance, or checklist. Use bullets only when they improve clarity.

A typical small PR body:

### Summary

Closes #412. `eve dev` crashed when an agent had no `connections/` directory;
the compiler now treats missing optional directories as empty.

### Validation

- Reproduced the crash with the weather fixture, then confirmed a clean boot
- `pnpm test:unit`, `pnpm typecheck`

### Checklist

(preserved from the template; only verified items checked)

Under validation, list exact checks actually run and useful manual coverage. State limitations honestly. Do not infer results or claim checks that only CI will run.

Preserve the checklist and check only verified items. If tests, docs, or a changeset are not applicable, say so in one short line at most.

Before returning or publishing the description, confirm that it answers:

  1. What problem does this solve?
  2. What meaningfully changes?
  3. How was it validated?
  4. What should the reviewer pay special attention to?

Then prune: delete any sentence that restates the diff, the issue, or the template, and any detail the reviewer does not need. If the answer to question 4 is "nothing," leave it out.

When asked only to draft, return the body for review. When asked to create or update the PR, pass a body file to gh pr create or gh pr edit.

Version History

  • 5cc74a6 Current 2026-08-12 13:15

    强化精简 PR 描述的要求,增加对风险、范围及验证细节的明确指引。

  • 84c3dfc 2026-08-06 12:49
  • e5c9191 2026-08-05 19:10

Same Skill Collection

.agents/skills/human-writing/SKILL.md
.agents/skills/technical-writing/SKILL.md
SKILL.md
skills/eve/SKILL.md

Metadata

Files
0
Version
ab9be98
Hash
1f1442d7
Indexed
2026-08-05 19:10

ホーム - Wiki
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-13 05:16
浙ICP备14020137号-1 $お客様$