pr summary

Engineering Community

Skill notes

1. Gather branch context

If the user supplied a different base branch as an argument, substitute it for master. Extract the work item number from the branch name (first run of 4+ digits): Branch · Work item feature/12345-add-foo · 12345 feedback/58340/from-luke · 58340

2. Analyse the changes

Group changes into logical themes by reading the commit messages and diff stat. Common themes for this project: New features — new screens, controls, device integrations, service bus consumers Bug fixes — correctness fixes (mention what was wrong and what was corrected) Renames / breaking changes — entity or contract renames, API changes Service bus / messaging — MassTransit consumers, message contracts, RabbitMQ configuration

3. Produce the title and description

Title — one line following the project's PR title format: JTD <work-item> - Brief description Use the work item number extracted from the branch name Brief description: imperative, ≤ 70 characters total Example: JTD 58106 - Handle missing RORO bin weights using tipping records Output the title first in a code block, then the description below it.

<Theme 1 — e.g. "New Feature: Trailer Management Screen">

Bullet describing the change. Mention affected components (InTruck, Console, ServiceBus, Shared, Devices) where relevant.

<Theme 2>

...

Fluxly profile Runtime and permissions are inferred by Fluxly static checks, not author declarations or runtime test results.
Domain
Engineering
Author-declared agents
No explicit declaration found; this is not inferred or tested compatibility
Static check
94 / 100 · heuristic scan, not runtime safety proof
Runtime evidence
Not run; no isolated runtime test evidence is currently recorded
Author / version / license
@LLM-Dev-Studio · Apache-2.0
Token usage
Lean
Setup complexity
Plug-and-play
External API key
Not required
Operating systems
Unspecified (assume cross-platform)
Runtime requirements
No explicit requirements detected
Detected file/system behavior
  • Read-only
  • Write / modify
Network behavior
Local-only
Install commands
None (reference only)

Heads up: Tool permissions are not declared; actual access depends on the runtime.

Author source file SKILL.md

# PR Summary

This skill generates a structured summary of all changes on the current branch relative to a base branch (default: `master`).

## Workflow

### 1. Gather branch context

```bash
git branch --show-current
git log master..HEAD --oneline
git diff master...HEAD --stat
git log master..HEAD --format="%s%n%b"
```

If the user supplied a different base branch as an argument, substitute it for `master`.

Extract the **work item number** from the branch name (first run of 4+ digits):

| Branch | Work item |
|---|---|
| `feature/12345-add-foo` | `12345` |
| `feedback/58340/from-luke` | `58340` |
| `JTD-56566-missing-screen` | `56566` |
| `docs/59478` | `59478` |

### 2. Analyse the changes

Group changes into logical themes by reading the commit messages and diff stat. Common themes for this project:

- **New features** — new screens, controls, device integrations, service bus consumers
- **Bug fixes** — correctness fixes (mention what was wrong and what was corrected)
- **Renames / breaking changes** — entity or contract renames, API changes
- **Service bus / messaging** — MassTransit consumers, message contracts, RabbitMQ configuration
- **Device integration** — RFID, camera, BlackMoth, or other device changes
- **UI changes** — WPF views, XAML resources, InTruck or Console screens
- **Dead code removal** — deleted files, unused services, obsolete utilities
- **Tooling / config** — CLAUDE.md, skills, CI, migrations, feature flags

### 3. Produce the title and description

**Title** — one line following the project's PR title format: `JTD <work-item> - Brief description`
- Use the work item number extracted from the branch name
- Brief description: imperative, ≤ 70 characters total
- Example: `JTD 58106 - Handle missing RORO bin weights using tipping records`

Output the title first in a code block, then the description below it.

**Description** — output the entire description inside a single fenced markdown code block (` ```markdown `) so the user can copy-paste it directly into Azure DevOps. Use this structure inside the block:

````markdown
```markdown
## Description — Work Item #<id>

### <Theme 1 — e.g. "New Feature: Trailer Management Screen">
- Bullet describing the change. Mention affected components (InTruck, Console, ServiceBus, Shared, Devices) where relevant.

### <Theme 2>
- ...

### Bug Fixes
- **<Short label>** — what was wrong and what was changed to fix it.

### Dead Code / Cleanup
- List deleted files or removed abstractions with a one-line rationale.

### Tooling & Config
- Any non-code changes (CLAUDE.md, skills, CI, feature flags).

---
**Files changed:** X  |  **Insertions:** +Y  |  **Deletions:** -Z
```
````

Rules:
- Use `###` headings for each theme; omit sections that have no relevant changes.
- Keep bullets concise — one sentence per item, no padding.
- Always include the `Work Item #<id>` in the description heading.
- Always include the files/insertions/deletions line at the bottom (read from `git diff --stat` summary line).
- If the branch has zero commits ahead of master, say so and exit.
- **The entire description (everything inside the markdown code block) must not exceed 3500 characters.** If the draft exceeds this limit, shorten bullets — summarise groups of related changes into a single bullet, drop minor cleanup items, and abbreviate file lists — until it fits. Never truncate mid-sentence; always produce complete, grammatical bullets.

### 4. Offer next steps

After the summary, ask if the user wants to:
- Create the PR now (`gh pr create`) using the summary as the body
- Review the changes first (`/code-review`)
- Adjust any section of the summary

Discussion

Powered by GitHub Discussions. Sign in with GitHub to comment, react, or subscribe.