potiuk opened a new pull request, #73660:
URL: https://github.com/apache/airflow/pull/73660
## Human Summary
Expect the agents to ask the human submitting the PR to add "Human Summary"
by hand. Following @shahar1 idea and PRs he opened (I found it really good and
easier to review.
This PR has been dog-fed. I asked the agent to follow the rule when I was
opening the PR.
The way how it works with `--web` is cool - it leaves a comment to fill-in
the summary, asks the agent to never do it on their own - and we will see
"empty summary" if this is not followed.
With `--web` it's also cool, because author can add the summary in a
convenient place - UI of GitHub while self-reviewing the PR in their browser.
This is a really good workflow.
## AI Summary
<details><summary>Click here</summary>
Several recent agent-assisted PRs open with a short `## Human Summary`
written by the author,
followed by the agent-written description collapsed under `## AI Summary`.
That gives
reviewers a quick signal that a person understood and owns the change — but
only if the
agent never writes the Human Summary itself.
This makes the convention part of the guidance agents follow when creating
PRs:
* `airflow-pr-draft-summary` skill — new "PR descriptions: Human Summary and
AI Summary"
section: the agent asks the user to type the summary, pastes the reply
verbatim, and must
never write, suggest, paraphrase, or pre-fill it. If the user prefers to
type it in the
browser, only a placeholder comment is left.
* `airflow-publish-changes` skill — the `gh pr create` body template gains
the two
sections, plus a step to ask the user for the Human Summary before
creating the PR.
* `AGENTS.md` — a two-line pointer to the rule in "Commits and PRs".
* `contributing-docs/05_pull_requests.rst` — one bullet in the Gen-AI
section, scoped to
agent-drafted PR descriptions.
`.github/PULL_REQUEST_TEMPLATE.md` is intentionally unchanged, so PRs
written by humans with
the regular template are unaffected.
Verification: `prek` pre-commit hooks pass on the changed files; the
skill-eval
(`run-skill-eval`) passed 12/12 and `dev/skill-evals/last-eval-hash.txt` is
updated.
</details>
---
##### Was generative AI tooling used to co-author this PR?
- [X] Yes — Claude Code (Opus 5.5)
Generated-by: Claude Code (Opus 5.5) following [the
guidelines](https://github.com/apache/airflow/blob/main/contributing-docs/05_pull_requests.rst#gen-ai-assisted-contributions)
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
