← 返回 Skills 市场
PR Description
作者
Xudong Guo
· GitHub ↗
· v1.1.3
· MIT-0
142
总下载
1
收藏
0
当前安装
5
版本数
在 OpenClaw 中安装
/install pr-description
功能描述
Automatically generate a structured, high-quality Pull Request (PR) description based on the provided git diff or code changes. Trigger when the user asks to...
安全使用建议
This skill appears to do what it says (generate PR descriptions and optionally update PRs), but it has an important metadata/instruction mismatch: SKILL.md expects git and the GitHub CLI ('gh') and will query your gh authentication, yet the package declares no required binaries or credentials. Before installing or running it, consider:
- Confirm you are comfortable with the agent running local 'git' and 'gh' commands and that your 'gh' is authenticated; those commands will use your GitHub credentials if present.
- Prefer to provide diffs inline (paste the git diff) instead of granting the skill permission to fetch or edit remote PRs.
- Ask the maintainer to update the skill metadata to list required binaries (git, gh) and to explicitly state the credential implications.
- Ensure the agent asks you for explicit approval before performing 'gh pr edit' (SKILL.md says it will — verify that behavior).
If you want to proceed but want lower risk, only use the skill in read-only mode (give it diffs or PR content yourself) and do not allow it to run remote-editing commands.
能力评估
Purpose & Capability
The skill claims to fetch diffs and optionally update PRs via the GitHub CLI and local git; that functionality is coherent with a PR-description generator. However, the registry metadata lists no required binaries or environment variables even though the runtime instructions explicitly instruct use of 'gh' and 'git' and to check 'gh' authentication. This mismatch (declared requirements = none vs. instructions requiring CLI tools and authenticated access) is inconsistent and should be clarified.
Instruction Scope
SKILL.md instructs the agent to run commands like 'gh pr diff', 'gh pr view --json viewerCanUpdate', 'gh api user', and (with explicit user approval) 'gh pr edit ... --body-file <temp-file>'. These steps are within the stated purpose but involve accessing local CLI tools, checking auth state, writing temp files, and (if approved) modifying remote PRs. The skill correctly warns about not executing code found in diffs and requires user confirmation before editing, but the instructions give the agent broad ability to run local commands and interact with GitHub credentials — behavior that should be explicitly declared in the metadata and presented to the user beforehand.
Install Mechanism
This is instruction-only (no install spec), which is low-risk in itself because no new code is written to disk. However, the SKILL.md expects existing tools (git, gh) on PATH; that expectation is not declared in the registry metadata. No external downloads or installs are specified.
Credentials
The skill does not declare any required environment variables or primary credential, yet it instructs the agent to call 'gh' and 'gh api user' and to check viewerCanUpdate, which implicitly uses the user's GitHub authentication (oauth token or local gh auth). That means the skill will rely on credentials accessible to the 'gh' CLI. Because these credentials are not declared or scoped in the metadata, it's unclear what secrets the skill will access and why; this mismatch is a notable risk.
Persistence & Privilege
always:false and default autonomous invocation are present; no install-time persistence or forced inclusion. The skill does include logic to update PRs only after explicit user approval, which limits privileged actions. There is no evidence it modifies other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install pr-description - 安装完成后，直接呼叫该 Skill 的名称或使用
/pr-description触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.3
- Expanded the skill’s trigger conditions to always activate when a GitHub PR URL or number is provided, ensuring consistent PR description generation for PR links.
- Clarified instructions for checking user permission to edit PRs, including guidance for unauthenticated GitHub CLI situations.
- Updated process for updating PR descriptions: requires user approval, and mandates the PR title be excluded from the body text file when updating via GitHub CLI.
- Ensured output of the PR description even when the user lacks edit permission, with clearer prompts for the next action.
- No file changes; documentation and behavioral logic only.
v1.1.2
- Clarified the PR update process: now, after generating the PR title/description, the user reviews the content before being asked about updating the PR.
- Added instruction to stop and wait for the user's response after outputting generated content, before asking for update approval.
- Updated permission check and user interaction sequence to improve review workflow and prevent unintended updates.
- No code or file changes; documentation/process update only.
v1.1.1
- Clarified instructions for proposing PR updates to existing pull requests.
- Added explicit permission checking using the GitHub CLI (`gh pr view --json viewerCanUpdate`) before offering to update the PR.
- Improved the update flow to ensure permission checks precede user prompts and actions.
- No file or functionality changes outside of documentation improvements.
v1.1.0
- Added instructions to allow fetching code changes via `gh` CLI or local `git` commands when the user provides a PR number, branch name, or requests the current branch.
- Introduced a step to verify user permissions before offering to update a PR description/title and to only proceed with explicit user approval.
- Described the process for updating PRs using the GitHub CLI, including writing descriptions to a temporary file and extracting the generated title.
- Emphasized not to execute any PR update commands without direct user consent.
- Clarified that the user may provide either a raw `git diff` or a text description of changes.
v1.0.0
Initial release of pr-description skill:
- Automatically generates structured, high-quality Pull Request (PR) descriptions from provided git diffs or change summaries.
- Detects user language (English or Chinese) and formats output accordingly.
- Always uses a professional, detailed Markdown PR description template.
- Does not fetch code from external sources or execute any code for security reasons.
- Includes clear guidelines for analyzing changes and categorizing by type (bug fix, new feature, breaking change, etc.).
- Provides instructions and security warnings to ensure safe, responsible use.
元数据
常见问题
PR Description 是什么？
Automatically generate a structured, high-quality Pull Request (PR) description based on the provided git diff or code changes. Trigger when the user asks to... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 142 次。
如何安装 PR Description？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install pr-description」即可一键安装，无需额外配置。
PR Description 是免费的吗？
是的，PR Description 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
PR Description 支持哪些平台？
PR Description 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 PR Description？
由 Xudong Guo（@sunny0826）开发并维护，当前版本 v1.1.3。
推荐 Skills