branch-pr-workflow

Create a feature or refactor branch from dev and open a PR after passing delivery gates.

5|1|Updated May 9, 2026
One-click install
npx skills add https://github.com/ql-link/LinkRag --skill branch-pr-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: branch-pr-workflow
Source: https://github.com/ql-link/LinkRag/tree/main/.ai/skills/branch-pr-workflow
Command: npx skills add https://github.com/ql-link/LinkRag --skill branch-pr-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

当用户认为当前模块代码实现完毕,且当前分支应为 dev,需要从 dev 基于当前修改创建规范分支、提交并发起合并到 dev 的 GitHub PR 时使用。本 Skill 作为交付链的收口点,在建分支/提 PR 之前执行收口门槛:测试未全绿、契约文档未同步、acceptance 未提升时将拒绝收口。 这个工作流确保变更在合并回开发分支之前经过严格的验证和对齐,以降低回滚风险并提升交付质量。

Core Features & Use Cases

  • Delivery gate enforcement: 从 dev 派生规范分支,并在通过前置条件后创建指向 dev 的合并请求,确保变更可审计和可追踪。
  • Pre-checks before PR: 自动执行测试、契约文档同步与 acceptance 指标对齐等硬性门槛,只有全部通过才允许继续收口。
  • 适用场景: 适用于“从 dev 新建分支、把当前修改提 PR、实现完成后创建 feature/refactor 分支并 PR”等交付收口场景,确保交付链末端的可控性。

Quick Start

在 dev 分支上完成修改后,执行本技能以创建规范分支并向 dev 提交 PR。

Frequently Asked Questions about branch-pr-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a feature branch from dev and open a PR with pre-commit checks?

To create a feature branch from dev and open a PR, the workflow isolates current dev changes into a named branch and enforces CI gate checks before submitting the merge request back to dev.

What happens if my tests fail before opening a pull request?

If tests fail before opening a pull request, the delivery gate enforcement blocks the PR creation, ensuring that only fully validated changes with green tests are merged back into the dev branch.

Can I enforce contract documentation synchronization before merging to dev?

Yes, you can enforce contract documentation synchronization before merging to dev; the workflow runs pre-checks to verify that documentation is aligned before allowing the PR to proceed.

When do I need to use a branch and PR workflow for feature delivery?

You need a branch and PR workflow for feature delivery when you must isolate current changes on dev into a separate branch to enforce quality checks, acceptance improvements, and auditability before merging.

Why does branch naming matter when submitting a PR from a feature branch?

Branch naming matters when submitting a PR because the workflow enforces naming conventions to ensure traceability and standardized delivery tracking within the development cycle.

Does the PR workflow require acceptance improvements before merging?

Yes, the PR workflow requires acceptance improvements before merging; the delivery gate explicitly checks for acceptance metric alignment and rejects the PR if these improvements are not met.