Agent skill

Write PR

在 kimi-code 仓库里创建或更新 PR 时使用：如何把 PR 模板的每一节写得简洁、便于 reviewer 理解，包括"行为变化与受影响人群"表。

MITAuto-check passedDevelopment

Install Write PR

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/write-pr .claude/skills/write-pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .claude/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/write-pr .agents/skills/write-pr && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .agents/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/write-pr .cursor/skills/write-pr && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .cursor/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/MoonshotAI/kimi-code.git --path .agents/skills/write-pr

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/write-pr .gemini/skills/write-pr && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .gemini/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/write-pr .github/skills/write-pr && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .github/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add MoonshotAI/kimi-code --skill write-pr -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install MoonshotAI/kimi-code write-pr --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/MoonshotAI/kimi-code.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/write-pr .opencode/skills/write-pr && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "write-pr" agent skill from https://github.com/MoonshotAI/kimi-code/tree/main/.agents/skills/write-pr into .opencode/skills/write-pr/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "write-pr", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: write-pr
GitHub stars: 7.8k
Token cost: ~909 tokens
SKILL.md length: 216 words
Files: 1
Skills in repo: 11
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

在 kimi-code 仓库里创建或更新 PR 时使用：如何把 PR 模板的每一节写得简洁、便于 reviewer 理解，包括"行为变化与受影响人群"表。

Works in 5 steps: 读 PR 模板 → 找到或创建 PR → 收集解释改动所需的上下文 → …
Development work in your project
SKILL.md covers 工作流, 行为变化与受影响人群 and 代码变更的可视化大纲
Calls gh and git

What it does

Write PR is an agent skill from MoonshotAI/kimi-code. 在 kimi-code 仓库里创建或更新 PR 时使用：如何把 PR 模板的每一节写得简洁、便于 reviewer 理解，包括"行为变化与受影响人群"表。

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. It works with Kimi and Git. The repository describes itself as: Kimi Code CLI — The Starting Point for Next-Gen Agents. The licence is MIT.

When your agent uses it

Development work in your project

Example prompts

“行为变化与受影响人群”
“/write-pr”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

读 PR 模板
找到或创建 PR
收集解释改动所需的上下文
按模板各节写描述。描述用用户当前使用的语言，行为变化表也一样；只有三样固定：PR 标题保持英文 Conventional Commit，changeset 保持英文（见 gen-changesets skill），节标题沿用模板原文。
发布描述

What it can do on your machine

Read from SKILL.md and the folder at commit 0f052fe. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- gh
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use gh and git, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Write PR loads about 909 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 216 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~22
When it runs · the whole SKILL.md, loaded when a task matches: ~909

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MoonshotAI/kimi-code at commit 0f052fe, republished under its MIT licence (© MoonshotAI). 216 words, ~909 tokens.

Download SKILL.mdSave it as .claude/skills/write-pr/SKILL.md (or your agent's skills folder).

name: write-pr
description: 在 kimi-code 仓库里创建或更新 PR 时使用：如何把 PR 模板的每一节写得简洁、便于 reviewer 理解，包括"行为变化与受影响人群"表。

写 PR 描述

为当前分支创建或更新 PR，描述要让 reviewer 明白这个改动为什么存在、实现长什么样、现有用户会失去什么。

工作流

读 PR 模板：

Read(.github/pull_request_template.md)
找到或创建 PR：
- 先查当前分支有没有 PR：gh pr view --json url,number,title,state 2>/dev/null。
- 没有的话，看 git status --short --branch 和当前分支上的提交。
- 提交剩余改动，带 upstream 推送分支，用 gh pr create 创建 PR。
- 遵守仓库的 git 安全规范。
收集解释改动所需的上下文：
- 读关联的 issue 和相关任务产物。
- 读完整 diff（git diff main...HEAD）和足够的周边代码，理解行为与归属。
- PR 已存在时，用 gh pr view 拿元数据和改动文件列表。
按模板各节写描述。描述用用户当前使用的语言，行为变化表也一样；只有三样固定：PR 标题保持英文 Conventional Commit，changeset 保持英文（见 gen-changesets skill），节标题沿用模板原文。
- Requirement or Bug：一句话，或 Resolve #<number>。不要多写。
- Bug Reproduction Steps：只有 bug 类 PR 需要；feature 写 N/A。步骤已在 issue 里的写 See linked issue。
- Root Cause：只有 bug 类 PR 需要；feature 写 N/A。说明根因，以及这是根本修复还是绕过。
- Code Changes：能用可视化大纲说清楚的就不要写散文，见"代码变更的可视化大纲"。
- Behavior Changes and Affected Users：先填行为变化表，再列受影响模块与测试覆盖，见"行为变化与受影响人群"。
- Checklist：勾上所有适用的项。
发布描述：
- 先存到临时文件，再 gh pr edit <number> --body-file <path> 或 gh pr create --body-file <path>。
- 确认更新成功。

行为变化与受影响人群

这一节回答一个问题：合入之后，现有用户会失去什么。这个仓库过去的回归大多来自没人回答这个问题，而不是逻辑错误。

判据：改动前能工作的任何输入（配置键、环境变量、命令行参数、provider 响应形态、旧版本写的会话数据、客户端请求、hook 载荷）改动后必须行为不变，除非这里明确声明了变化并给出退路。

写法：

列出 diff 改变的每一个可观测行为，一行一个。包括你认为"不变"但分支条件挪动了的：新增的条件会不会先于旧条件命中既有输入；删除或收窄的分支改动前谁在走。内部包会打进 CLI 发布包，"内部"不等于用户无感。表格用 PR 描述的语言，下面的示例用英文只是示意形状：

Behavior	Before	After	Who relies on the old behavior	Escape hatch
reasoning parsing when `reasoning_details` is an array	string `reasoning` also read	string ignored	OpenAI-compatible gateways that send both (OpenRouter dialect)	none

人群要具名，不要写"部分用户"。从 .agents/skills/review-pr/surfaces.md 里取：客户端（TUI、print 模式、desktop 与 web、VS Code、ACP、SDK）、provider 方言、平台、配置状态、数据年代、外部脚本。
改了 prompt 文本（system prompt、工具描述、提醒）的，每一句单独成行，写清这句改动前约束了什么行为、谁依赖、现在由什么来约束。"没有测试引用这句"不是无影响的证据。
替换或绕过旧路径的（移植、runtime binding、协议替换），额外列出旧路径的功能清单：它认哪些环境变量、有哪些兜底、接受哪些输入，以及每一项在新路径里的位置。
确实没有可观测变化的，写 None，并说明证据：哪些分支、默认值、契约文件没动。
表后面列受影响模块与每一行对应的测试覆盖。默认翻转或删除行为的，必须有一条测试把未被改动的人群的旧行为钉住，并且 changeset 要写明用户失去了什么，见 gen-changesets skill；没有退路的，在 PR 里请维护者显式拍板。

代码变更的可视化大纲

优先用结构化视图，少用散文。用能说清实现的最小组合，没变的类别不要列。

逻辑或算法变化用伪代码 diff：

diff

 on(save)
-  write content
+  if content is unchanged
+    return cached result
+  write new content
+  invalidate cache

运行时控制流用调用树 diff：

diff

 submitForm
   createSession
     persistPrompt
+    expandSkillMention
     launchAgent
-  navigateToSession
+  navigateToSession
+    subscribeToEvents

文件职责变化用浅层文件树 diff：

diff

 src/
 ├── commands/
+│   └── show-me.ts       # expands the slash command
 ├── sessions/
-└── transport.ts
+└── transport/
+    ├── client.ts
+    └── stream.ts

组件或 UI 结构变化用树 diff：

diff

 <SessionPage>
   useSessionEvents()
   <SessionToolbar>
+    <RunSkillButton />
   <SessionTimeline>
+    <SkillResultCard />

组件交互、控制流或数据流用 Mermaid，解释 bug 机制时尤其有用：

mermaid

sequenceDiagram
    participant User
    participant UI
    participant Daemon
    User->>UI: choose command
    UI->>Daemon: send expanded prompt
    Daemon-->>UI: stream result

关键数据结构或类型变化用对应语言的代码块：

interface SessionEvents {
  onTurnStart(cb: (turn: Turn) => void): void;
  onTurnEnd(cb: (turn: Turn) => void): void;
}

可视化大纲的规则：

重点是"变了什么"且周边形状已存在时，用 diff 块。
大部分是新内容，或 diff 记法会掩盖归属和顺序时，用对应语言或 text 块给出完整目标形状。
按最容易理解的顺序讲：先文件还是先数据结构，哪个合适用哪个。
像一个人对另一个人讲话：简单、连贯、简洁。

Files

Just SKILL.md in .agents/skills/write-pr of MoonshotAI/kimi-code.

Open the folder on GitHubat commit 0f052fe

Compare with similar skills

Write PR next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Write PR compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Write PR this skillMoonshotAI/kimi-code	7.8k	—	~909	Automated safety check: Pass	MIT	today
Ccmanager Configkbwo/ccmanager	1.3k	—	~1.5k	Automated safety check: Pass	MIT	today
Pulse Releasequnqin24/Pulse	516	—	~1.3k	Automated safety check: Pass	Apache-2.0	today
Polyphonyalinaqi/maggy	707	—	~980	Automated safety check: Pass	MIT	13 days ago
Finishing a Development Branchobra/superpowers	296k	5 repos	~1.9k	Automated safety check: Pass	MIT	today
Code Review ChecklistshareAI-lab/learn-claude-code	78k	5 repos	~1.1k	Automated safety check: Pass	MIT	9 days ago

Similar skills

Ccmanager Config
kbwo/ccmanager
Set up, review, or repair a CCManager config — .ccmanager.json at a git repository root, or the global ~/.config/ccmanager/config.json.
1.3k GitHub stars~1.5k tokensUpdated today
DevelopmentAuto-check passed
Pulse Release
qunqin24/Pulse
Release a new Pulse version end to end — checks, bilingual CHANGELOG entry, VERSION, tag, the release workflow, syncing main, and the issue replies that go with it.
516 GitHub stars~1.3k tokensUpdated today
DevelopmentAuto-check passed
Polyphony
alinaqi/maggy
Multi-agent orchestration with container-isolated workspaces — each agent session runs in its own Docker container with independent git branches
707 GitHub stars~980 tokensUpdated 13 days ago
DevelopmentAuto-check passed
Finishing a Development Branch
obra/superpowers
Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.
296k GitHub starsUsed in 5 repos~1.9k tokens
DevelopmentAuto-check passed
Code Review Checklist
shareAI-lab/learn-claude-code
Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.
78k GitHub starsUsed in 5 repos~1.1k tokens
DevelopmentAuto-check passed
Codebase Knowledge Graph Q&A
Egonex-AI/Understand-Anything
Answers questions about a codebase by searching a prebuilt knowledge graph of its files, functions, classes and dependencies, not by rereading every source file.
86k GitHub starsUsed in 1 repo~1.2k tokens
DevelopmentAuto-check passed

Questions about Write PR

What does Write PR do?

在 kimi-code 仓库里创建或更新 PR 时使用：如何把 PR 模板的每一节写得简洁、便于 reviewer 理解，包括"行为变化与受影响人群"表。. Write PR is an agent skill from MoonshotAI/kimi-code.

When should I use Write PR?

Write PR fits situations like: development work in your project.

How do I install Write PR in Claude Code?

Run `npx skills add MoonshotAI/kimi-code --skill write-pr -a claude-code`. Or copy the skill folder (.agents/skills/write-pr in MoonshotAI/kimi-code) into .claude/skills/write-pr in your project. Claude Code loads it when a task matches its description.

How do I install Write PR in Codex?

Run `npx skills add MoonshotAI/kimi-code --skill write-pr -a codex`. Or copy the skill folder (.agents/skills/write-pr in MoonshotAI/kimi-code) into .agents/skills/write-pr in your project. Codex loads it when a task matches its description.

Can I use Write PR in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MoonshotAI/kimi-code --skill write-pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/write-pr, .gemini/skills/write-pr, .github/skills/write-pr and .opencode/skills/write-pr in your project.

What does Write PR need to run?

Going by SKILL.md and its folder, Write PR needs the command-line tools its instructions call (gh and git).

Does Write PR access the network?

SKILL.md contains no URLs. Its commands use gh and git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Write PR safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Write PR use?

Write PR is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Write PR use?

About 909 tokens (SKILL.md is roughly 3.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Write PR?

Skills that share tags, products or a category with Write PR: Ccmanager Config (kbwo/ccmanager, 1.3k stars), Pulse Release (qunqin24/Pulse, 516 stars), Polyphony (alinaqi/maggy, 707 stars) and Finishing a Development Branch (obra/superpowers, 296k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Write PR?

MoonshotAI (a GitHub organization) maintains it in MoonshotAI/kimi-code, which has 7,796 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 8, 2026.

Source: MoonshotAI/kimi-code on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Write PR

Install Write PR

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

写 PR 描述

工作流

行为变化与受影响人群

代码变更的可视化大纲

Files

Compare with similar skills

Similar skills

Ccmanager Config

Pulse Release

Polyphony

Finishing a Development Branch

Code Review Checklist

Codebase Knowledge Graph Q&A

More from MoonshotAI/kimi-code

Kimi Webbridge

Gen Changesets

Gen Docs

Kimi Datasource

Pre Changelog

Review PR

Questions about Write PR

Install Write PR

Facts

At a glance

What it does

When your agent uses it

Example prompts

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

写 PR 描述

工作流

行为变化与受影响人群

代码变更的可视化大纲

Files

Compare with similar skills

Similar skills

More from MoonshotAI/kimi-code

Related

Questions about Write PR