Conversation
- daily-safe-output-optimizer.md: change h1 to h3 in issue body template title - dev-hawk.md: change h1→h3, h2→h4 in all PR comment templates; wrap Error Details and Key Errors sections in <details> tags - pr-nitpick-reviewer.md: change h1→h3, h2→h4 in discussion report template; change ## Overall Observations → ### in review body example - Recompile all 183 workflow lock files Agent-Logs-Url: https://github.com/github/gh-aw/sessions/a5b6d314-0919-414b-aae4-35e9f653d72e Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
There was a problem hiding this comment.
Pull request overview
This PR updates generated markdown output templates in several GitHub agentic workflows to comply with the repository’s reporting guidelines by avoiding h1/h2 headers and adding progressive disclosure for verbose sections.
Changes:
- Demotes report/comment headers to start at h3 (
###) or lower across multiple workflow output templates. - Wraps verbose error sections in
dev-hawk.mdinside<details>blocks for progressive disclosure. - Updates example review submission body headers to match the normalized heading levels.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.
| File | Description |
|---|---|
| .github/workflows/daily-safe-output-optimizer.md | Demotes the issue body template’s top header from h1 to h3. |
| .github/workflows/dev-hawk.md | Demotes PR comment template headers and adds <details> wrappers for error-heavy sections. |
| .github/workflows/pr-nitpick-reviewer.md | Demotes discussion report template headers and updates the review submission example header level. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| ### Improve [Tool Name] Description to Prevent Agent Errors | ||
|
|
||
| ### Summary | ||
|
|
There was a problem hiding this comment.
In this issue body template, the first header acts like a report title (h3). To match the repo’s report formatting convention (e.g., .github/workflows/ci-doctor.md:247-252 and .github/workflows/copilot-pr-merged-report.md:149-152), the subsequent sections (like “Summary”) should be one level deeper (####) or the title header should be removed entirely (since the GitHub issue title already serves as the document title).
See below for a potential fix:
#### Summary
Analysis of the last 24 hours of workflow runs identified **[N] errors** where agents incorrectly used the `[tool_name]` safe output tool. The workflow prompts appear correct, indicating the tool description needs improvement.
<details>
<summary><b>🔍 Error Analysis Details</b></summary>
#### Error Analysis
##### Error Pattern 1: [Description]
Four active workflows used h1/h2 headers in generated output (issue bodies, PR comments, discussion reports, review submissions), violating the project's markdown style guidelines.
Changes
daily-safe-output-optimizer.md: Issue body template title#→###dev-hawk.md: All PR comment template headers demoted (#→###,##→####); verbose Error Details and Key Errors sections wrapped in<details>for progressive disclosurepr-nitpick-reviewer.md: Discussion report template headers demoted (#→###,##→####,###→#####);submit_pull_request_reviewbody example## Overall Observations→### Overall ObservationsBefore / After (dev-hawk example)
Reference compliant workflows (
daily-observability-report.md,archie.md) were used as style examples. All 183 workflow lock files recompiled cleanly after edits.Warning
Firewall rules blocked me from connecting to one or more addresses (expand for details)
I tried to connect to the following addresses, but was blocked by firewall rules:
https://api.github.com/graphql/usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw(http block)/usr/bin/gh /usr/bin/gh api graphql -f query=query($owner: String!, $name: String!) { repository(owner: $owner, name: $name) { hasDiscussionsEnabled } } -f owner=github -f name=gh-aw UZj7DRpXR309(http block)https://api.github.com/repos/astral-sh/setup-uv/git/ref/tags/eac588ad8def6316056a12d4907a9d4d84ff7a3b/usr/bin/gh gh api /repos/astral-sh/setup-uv/git/ref/tags/eac588ad8def6316056a12d4907a9d4d84ff7a3b --jq .object.sha(http block)https://api.github.com/repos/github/gh-aw/usr/bin/gh gh api /repos/github/gh-aw --jq .visibility(http block)https://api.github.com/repos/github/gh-aw-actions/git/ref/tags/v0/usr/bin/gh gh api /repos/github/gh-aw-actions/git/ref/tags/v0 --jq .object.sha(http block)https://api.github.com/repos/githubnext/agentics/git/ref/tags//usr/bin/gh gh api /repos/githubnext/agentics/git/ref/tags/# --jq .object.sha(http block)If you need me to access, download, or install something from one of these locations, you can either:
✨ PR Review Safe Output Test - Run 23928948104