Skip to content

Add "assign to Copilot" as an implementation option in chaining docs#659

Merged
strawgate merged 8 commits intomainfrom
docs/copilot-assign-option
Mar 14, 2026
Merged

Add "assign to Copilot" as an implementation option in chaining docs#659
strawgate merged 8 commits intomainfrom
docs/copilot-assign-option

Conversation

@strawgate
Copy link
Collaborator

@strawgate strawgate commented Mar 10, 2026

Summary

  • Adds a new "Detector creates issue -> assign to Copilot" section in docs/workflows/detector-fixer-chaining.md, including a workflow example that assigns detector-created issues with gh issue edit --add-assignee @copilot``.
  • Documents that the handoff job only needs issues: write; COPILOT_GITHUB_TOKEN remains in the detector job in the example.
  • Updates docs/index.md onboarding with explicit core-workflow install commands, refreshed workflow grouping, and collapsible install tips for maintenance workflow sets.
  • Updates install snippets across workflow docs to use curl -fsSL (replacing curl -sL), plus wording updates in docs/workflows/gh-agent-workflows.md.
  • Enables MkDocs rendering for collapsible tips by adding pymdownx.details and pymdownx.superfences in mkdocs.yml.

Test plan

  • Verify docs render correctly (including collapsible ??? tip blocks)
  • Spot-check copied install commands for core and maintenance workflow sections

The body of this PR is automatically managed by the Trigger Update PR Body workflow.

Document the pattern where a detector creates an issue and the
follow-up job assigns it to GitHub's Copilot coding agent instead
of chaining to a dedicated fixer workflow.

Made-with: Cursor
@coderabbitai
Copy link

coderabbitai bot commented Mar 10, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: c6274520-4acc-4b36-b35e-4fe43bf01799

📥 Commits

Reviewing files that changed from the base of the PR and between 5ff4e1f and 457cf92.

📒 Files selected for processing (10)
  • docs/index.md
  • docs/workflows/detector-fixer-chaining.md
  • docs/workflows/gh-agent-workflows.md
  • docs/workflows/gh-agent-workflows/bugs.md
  • docs/workflows/gh-agent-workflows/code-duplication.md
  • docs/workflows/gh-agent-workflows/docs-patrol-overview.md
  • docs/workflows/gh-agent-workflows/newbie-contributor.md
  • docs/workflows/gh-agent-workflows/stale-issues.md
  • docs/workflows/gh-agent-workflows/test-coverage.md
  • docs/workflows/gh-agent-workflows/text-quality.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/workflows/gh-agent-workflows.md

📝 Walkthrough

Walkthrough

Adds documentation for a new workflow pattern "Detector creates issue → assign to Copilot" by introducing an assign-to-copilot job that runs after detect, requires created_issue_number, and performs an API call to assign the created issue to Copilot. Updates docs/index.md with expanded get-started steps, multiple curl-based installer tips that write example workflow YAML into .github/workflows, expands the Core workflows list and descriptive text, and enables pymdownx.details and pymdownx.superfences in mkdocs.yml. Several installer curl examples were changed from -sL to -fsSL.

Possibly related PRs

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/copilot-assign-option
  • 🛠️ Update Documentation: Commit on current branch
  • 🛠️ Update Documentation: Create PR

Comment @coderabbitai help to get the list of available commands and usage tips.

Each section (Core, Repository Maintenance, Codebase Maintenance) now
has a collapsed "Install" tip with a copy-pasteable curl command that
downloads all the example workflows for that category.

Made-with: Cursor
Replace the quick-setup.sh script reference with direct curl commands
that install the four core workflows. The Get Started section is now
self-contained — create PAT, store secret, curl the workflows, push.

Made-with: Cursor
coderabbitai[bot]

This comment was marked as resolved.

The overview page referenced "the quick setup script" without a link.
Now links to both the script source and the homepage install commands.

Made-with: Cursor
- Explain what Copilot PAT is for before asking the user to create one
- Add pr-actions-detective to core set (matches quick-setup script)
- Move it out of Repository Maintenance to avoid duplication
- Add step 3 with concrete bullet points showing what the agents do
- Tighten tagline to explain what the project is, not just count agents
- Link to full setup docs for customization
- Use consistent "cd into your repo" wording across all install blocks

Made-with: Cursor
Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

♻️ Duplicate comments (1)
docs/index.md (1)

25-34: ⚠️ Potential issue | 🔴 Critical

curl -sL writes error pages into workflow files on HTTP failures.

Lines 25-34, 78-83, and 106-115 use curl -sL, which exits successfully even on 404/500 responses, writing error HTML into .github/workflows/*.yml. Users end up with broken workflows.

Replace all with curl -fsSL to fail fast on HTTP errors.

🔧 Fix for all curl commands
-curl -sL https://raw.githubusercontent.com/elastic/ai-github-actions/v0/gh-agent-workflows/issue-triage/example.yml \
+curl -fsSL https://raw.githubusercontent.com/elastic/ai-github-actions/v0/gh-agent-workflows/issue-triage/example.yml \

Apply the same -sL-fsSL change to all remaining curl commands in lines 27-34, 78-83, and 106-115.

Also applies to: 78-83, 106-115

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/index.md` around lines 25 - 34, Replace the curl flags that allow silent
success on HTTP errors: change every occurrence of "curl -sL" to "curl -fsSL" in
the shown commands so curl fails on 4xx/5xx and does not write error HTML into
workflow files (update the curl invocations that produce
.github/workflows/trigger-issue-triage.yml, trigger-mention-in-issue.yml,
trigger-mention-in-pr.yml, trigger-pr-review.yml,
trigger-pr-actions-detective.yml and the other curl lines referenced in the
comment).
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Duplicate comments:
In `@docs/index.md`:
- Around line 25-34: Replace the curl flags that allow silent success on HTTP
errors: change every occurrence of "curl -sL" to "curl -fsSL" in the shown
commands so curl fails on 4xx/5xx and does not write error HTML into workflow
files (update the curl invocations that produce
.github/workflows/trigger-issue-triage.yml, trigger-mention-in-issue.yml,
trigger-mention-in-pr.yml, trigger-pr-review.yml,
trigger-pr-actions-detective.yml and the other curl lines referenced in the
comment).

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7c9c0fa1-cfc9-4f9a-ac7a-003a28844b08

📥 Commits

Reviewing files that changed from the base of the PR and between 3b582d2 and 5ff4e1f.

📒 Files selected for processing (2)
  • docs/index.md
  • docs/workflows/gh-agent-workflows.md

Fail fast on HTTP errors instead of silently writing error pages
into workflow files.

Made-with: Cursor
@github-actions github-actions bot added the small_boom Small PR blast radius; usually low human-review need label Mar 10, 2026
Replace raw API call with the simpler gh CLI command that the
cli/cli#11279 PR added for assigning issues to Copilot.

Made-with: Cursor
@strawgate strawgate merged commit 55ab587 into main Mar 14, 2026
22 checks passed
@strawgate strawgate deleted the docs/copilot-assign-option branch March 14, 2026 04:41
strawgate added a commit that referenced this pull request Mar 14, 2026
Resolve conflicts with #659 (assign-to-Copilot chaining option).
Keep our fixer-removal changes; incorporate the new "assign to Copilot"
section and Copilot row in the chaining comparison table.

Made-with: Cursor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

small_boom Small PR blast radius; usually low human-review need

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant