archestra-pr-hygiene
GitHub指导在打开或更新 Archestra PR 时撰写符合规范的标题和描述,确保元数据准确反映最终代码变更。
Trigger Scenarios
Install
npx skills add archestra-ai/archestra --skill archestra-pr-hygiene -g -y
SKILL.md
Frontmatter
{
"name": "archestra-pr-hygiene",
"description": "Use when opening or updating an Archestra pull request to write an accurate conventional title and a practical, evidence-based description."
}
Archestra pull request hygiene
Review the final diff and commit history before writing PR metadata. Describe the change that is actually present, not the work session that produced it.
For a request to add a PR to the merge queue, monitor its merge, or repair queue CI, load archestra-merge-queue. That skill owns queue execution and follow-through; this skill owns PR metadata.
Title
Follow .github/commitlint.config.js: use a conventional-commit title such as feat(scope): add runtime credentials, choose one of its allowed types, omit a trailing period, and stay within its 100-character limit. Keep the title focused on the PR's primary outcome.
Description
Keep the body concise and concrete. Cover:
- the problem or user need being addressed;
- the implementation approach and important behavior changes;
- meaningful alternatives or tradeoffs, when they affected the design;
- how the change was exercised as a real workflow, including the scenario and observed result.
Do not pad the description with a list of routine commands, lint/type-check status, test counts, generic claims of quality, or a file-by-file changelog. Mention an automated check only when it validates a behavior that is otherwise difficult to explain or when its result is material to the reviewer.
Before opening or updating the PR, verify that the title and body still match the final diff and do not expose secrets, private data, or customer identifiers.
Version History
-
8d2351a
Current 2026-10-18 18:00
新增 archestra-merge-queue 技能以接管队列监控与修复职责,本技能专注于 PR 元数据撰写,实现职责分离。
- 6290aab 2026-09-11 16:19


