OpenParable
Skip to content
← Back to skills

PR Submission

Development
pr-submission

PR Submission is an Agent Skill for development published in the iflytek/skillhub repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

PR title format, commit conventions, and pre-PR checklist for SkillHub. Use when preparing or reviewing pull requests.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/iflytek/skillhub/blob/HEAD/.agents/skills/pr-submission/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pr-submission, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

PR Submission Skill

Workflow

  1. Identify the scope of your change (feature, bug fix, docs, test, refactor, chore)
  2. Format PR title and commits using the conventions below
  3. Run the pre-PR checklist commands
  4. Open the PR with a descriptive body

PR Title Format

Use conventional commit style:

<type>(<scope>): <description>

Types:

TypeWhen to Use
featNew feature or capability
fixBug fix
docsDocumentation changes only
testAdding or updating tests
refactorCode restructuring with no behavior change
choreBuild, CI, tooling, or maintenance tasks

Scopes: Use module or domain names: auth, search, publish, review, namespace, governance, deploy, ci, frontend, scanner

Examples:

feat(auth): add local account login with password reset
fix(publish): resolve null pointer when skill metadata is missing name
docs(deploy): clarify runtime image usage
test(namespace): add membership service edge case tests
refactor(review): extract query repository for governance list
chore(ci): add parallel workflow scripts for multi-agent development

Commit Message Format

Same convention as PR titles. One logical change per commit.

Types:

  • feat: A new feature for the user
  • fix: A bug fix for the user
  • docs: Documentation changes only
  • test: Adding or updating tests
  • refactor: Code change that neither fixes a bug nor adds a feature
  • chore: Changes to build process, CI, or maintenance tasks

Examples:

fix(auth): resolve session cookie conflict in device flow
feat(publish): support security scan before review submission
docs(skill-protocol): add nested SKILL.md discovery rules
test(search): verify jieba analysis with Chinese skill descriptions
refactor(storage): simplify LocalFile path normalization

Pre-PR Checklist

  • Backend tests pass: make test-backend-app
  • Frontend typecheck passes: make typecheck-web
  • If API changed: make generate-api was run and web/src/api/generated/schema.d.ts is committed
  • Smoke test passes: make staging
  • Follow existing module boundaries and dependency direction
  • Add/update tests for new behavior
  • Update design docs when APIs, auth flows, deployment, or operator workflows change

PR Body Structure

When creating a PR, include:

  1. What — Summary of the change
  2. Why — Motivation (link to issue if applicable)
  3. How — Key implementation details (especially for non-obvious decisions)
  4. Testing — How to verify the change works
  5. Impact — Breaking changes, migration notes, or rollout considerations

Review Conventions

  • When reviewing, cite the specific AGENTS.md rule that applies if suggesting a convention change
  • For backend code, check dependency direction does not violate clean architecture rules
  • For frontend code, check OpenAPI types are regenerated if API changed