pr-title-description
Review one or more pull requests and write plain titles and descriptions from the full diff.
- License 许可
- MIT
- 最近更新
- 2026-11-15
- Stars
- ★ 7
- Forks
- 1
01 前言 Front Matter
- name
- pr-title-description
- description
- Review one or more pull requests and write plain titles and descriptions from the full diff.
- disable-model-invocation
- true
03 SKILL.md 正文
Accept one or more pull request links as arguments. Apply the prompt below to each link.
With no argument, use the current task, browser, worktree, or GitHub context to find the pull request or pull requests. If the context does not show a clear pull request, ask for a pull request link.
Review this pull request: <PR link>
Read the PR and its full diff. Do not use the branch name, commit message, labels, current title, or a shallow summary.
Full-diff behavior standard
Before writing, inventory every independently observable behavior in the full diff. A behavior is independent when a user, caller, operator, automation, output, error, exit status, fallback, or side effect can observe it separately. Lead with the central behavior for readability, then give every other behavior its own short paragraph or bullet.
For each behavior, state the trigger or observer, the Before -> After result, the affected surface/caller when shared, and focused proof. Include important preserved behavior and fallback paths when they help a coder rule a regression in or out. Describe outcomes, not line-by-line implementation, and do not hide multiple behaviors under vague umbrella wording.
Write like the reader is smart but knows nothing about this code. Pretend they asked you to explain it like they are five and feel stupid. If a word needs another sentence to explain it, replace the word — or turn it into a tiny story.
Your job is not a dry API blurb. Your job is an illustrative before/after a person can picture.
Gold voice for titles and “What this adds”:
The theme package has a phone icon somewhere. We need to find it.
Before: yell “anyone know how to find icons?” and wait for a hand.
After: call the finder by its name tag: “icon finder, go.”
That’s all “operation id” is — the finder’s name tag.
Rules for that voice:
Start from a concrete scene (what’s in someone’s hand, what they’re hunting for). Prefer Before / After when the change is “how you ask” or “how you look it up.” Use picture words: hand it, open, find, check, save, skip, stop, call by name, name tag. Prefer spoken results: “found it,” “missing,” “duplicated,” “couldn’t.” When the diff uses an abstract word (operation id, registry, envelope, adapter, digest, schema), do one of two things: Drop it and say what the person does with their hands, or Keep it once, then gloss it in the same breath with a name-tag / mailbox / checklist metaphor — like the “finder’s name tag” line above. Never leave jargon unexplained. Never write as if the reader already knows the jargon. Add a tiny concrete example in parentheses when a name is abstract (like “the phone icon”). Few words. Small words. Clear on first read. Return:
Recommended title
Few words. Small words. Clear on first read. Say what you hand it, what it does, and what you get back — or the Before/After of how you ask. Prefer picture words and spoken results. Good title: “Call the icon finder by its name tag instead of asking around” Good title: “Given a theme STP and an asset name, report whether that asset was found, missing, or duplicated” Bad title: anything that only says operation id / registry / typed envelope / adapter / digest / schema with no picture. Use “Add” only if it helps. Do not force it. No vague words like “improve,” “enhance,” or “update.” Return one title only. Why this title fits
1–2 short sentences in the same voice. If needed, one Before / After beat, then what you get back. If this section is needed to decode the title, rewrite the title. Evidence
Key files or functions that support the title. If you cannot read the PR or full diff, say so and do not propose a title.
Then write a short, paste-ready PR description.
Use this structure:
What this adds
Why One short paragraph. Same plain level. Say who needs this and what goes wrong without it (the “yell and wait for a hand” problem). If this is needed to decode the feature, rewrite “What this adds.”
Verification List only proof from the PR, CI, or your own checks.
Reported in the PR
… Checked by you / CI here
… Rules:
Few words. Small words. Clear on first read. ELI5 I-am-stupid mark.
Do not invent behavior, tests, or benefits.
Strip branch names, hashes, draft notes, agent notes, and merge notes.
No vague words like “improve,” “enhance,” or “update.”
Illustrative first. Abstract labels only if glossed in the same breath.
Use the recommended title and paste-ready description to run gh pr edit <PR link> --title ... --body-file ..., then run gh pr view <PR link> --json title,body to confirm the saved title and body. Report the saved result.
04 同仓库更多 Skills
update
Fast-forwards a local repository's main branch to a remote's main after confirming the repo path and source remote through AskUserQuestion. Use when the user says '/update', 'update main', 'fast-forward main', 'sync main from origin', 'pull latest main into <path>', or 'bring main up to date'.
source-command-sr-loop
Converging cleanup loop: repeat /simplify until clean, then repeat /code-review --fix until clean
skill-builder
Skill lifecycle: classify, scaffold, write via the skill-writer-agent, self-audit, compose sub-skills, polish description triggers, enforce deterministic scripts. Triggers: build a skill, new skill workflow, improve this skill, optimize skill description, skill development lifecycle, skill modularity, skill composition, description trigger catalog, deterministic skill scripts.
session-tidy
Audit, clean, and consolidate session logs in the Obsidian vault. Fixes format drift, resolves orphaned next-steps, updates stale statuses, and generates project rollup summaries. Use when session logs feel cluttered or before starting a new project milestone. Triggers on '/session-tidy', 'tidy sessions', 'clean up session logs', 'session audit'.
session-log
Logs a session report as an HTML page, tracks vault context, extracts decisions, and outputs a /rename command. Use for /session-log, 'journal this session', 'log this work', 'session report', 'summarize/log/record this session', 'save session', 'capture session', or 'document what we did'.
run-claude-dev-env
Build, install, run, and test the claude-dev-env installer. Use when asked to run claude-dev-env, install the Claude Code config into ~/.claude, drive the installer, smoke-test it against a sandbox, or run its test suite.