mirror of
https://github.com/PX4/PX4-Autopilot.git
synced 2026-10-06 09:02:52 +08:00
Jacob Dahl
9e9871d403
* docs(agents): let a user's own instructions set the worktree location A fixed ../PX4-Autopilot-worktrees/ path overrode contributors who keep worktrees elsewhere. Their own agent instructions now win, with the sibling directory as the default. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Jacob Dahl <dahl.jakejacob@gmail.com> * docs(agents): italicize the PR body's Assisted-by line Set apart in italics, the disclosure reads as a footnote rather than part of the Solution section above it. Assisted-by: Claude:claude-opus-5-5 Signed-off-by: Jacob Dahl <dahl.jakejacob@gmail.com> --------- Signed-off-by: Jacob Dahl <dahl.jakejacob@gmail.com>
Agent instructions
AGENTS.md files hold repository and directory guidance; .agents/skills/ holds the shared skills. Keep skills client-agnostic: no argument variables or client-specific attribution.
Claude Code reads neither location directly. Each CLAUDE.md is a one-line @AGENTS.md import, and each .claude/skills/<name> is a symlink to .agents/skills/<name>; add both when adding a nested AGENTS.md or a skill.
| Skill | Use |
|---|---|
commit |
Conventional commit with Assisted-by: trailer |
pr |
Pull request with Summary/Problem/Solution body |
review-pr |
PR review debrief and draft comment |
rebase-onto-main |
Rebase, including onto a squash-merged parent |
build-px4-linux |
Board or SITL build on a Linux host |
build-px4-macos |
Board build on macOS, in the px4-dev container |
Create worktrees where the user's own agent instructions put them. Without such a rule, put them next to the repository in ../PX4-Autopilot-worktrees/<name>/, never inside it.