Skip to content

Add repo-assist.md for automated repository assistant#551

Open
xperiandri wants to merge 1 commit intodevfrom
repo-assistant
Open

Add repo-assist.md for automated repository assistant#551
xperiandri wants to merge 1 commit intodevfrom
repo-assistant

Conversation

@xperiandri
Copy link
Copy Markdown
Collaborator

Introduces repo-assist.md, configuring "Repo Assist" to automate issue triage, PR management, labeling, release prep, and contributor onboarding. Defines structured, quality-focused workflows and project-specific guidelines for F#/.NET, with daily and manual run support.

Fixes #549

@xperiandri xperiandri requested a review from Copilot April 19, 2026 14:39
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Adds a repo-assist.md workflow/instructions document to configure “Repo Assist” automation for issue triage, PR maintenance, labeling, release prep, and onboarding.

Changes:

  • Introduces a new Repo Assist workflow file with scheduled + manual triggers.
  • Defines tool permissions/safe-output limits and .NET SDK setup.
  • Documents task-driven operating guidelines and project-specific F#/.NET conventions.
Comments suppressed due to low confidence (3)

.github/workflows/repo-assist.md:1

  • Several newly added lines contain mojibake/replacement characters () and placeholder emoji markers (??). This will render poorly in GitHub and can confuse contributors; please replace with the intended punctuation (often an em dash) and replace ?? with the intended emoji (or remove emojis entirely if you want plain text). Also ensure the file is saved as UTF-8.
---

.github/workflows/repo-assist.md:1

  • Several newly added lines contain mojibake/replacement characters () and placeholder emoji markers (??). This will render poorly in GitHub and can confuse contributors; please replace with the intended punctuation (often an em dash) and replace ?? with the intended emoji (or remove emojis entirely if you want plain text). Also ensure the file is saved as UTF-8.
---

.github/workflows/repo-assist.md:1

  • Several newly added lines contain mojibake/replacement characters () and placeholder emoji markers (??). This will render poorly in GitHub and can confuse contributors; please replace with the intended punctuation (often an em dash) and replace ?? with the intended emoji (or remove emojis entirely if you want plain text). Also ensure the file is saved as UTF-8.
---

Comment on lines +42 to +43
target: "*"
#title-prefix: "[Repo Assist] "
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The update-issue block is indented inconsistently (target is indented one space too far), which will make the YAML frontmatter invalid for any parser. Re-indent target (and the commented title-prefix, if kept) to match other safe-outputs children (two spaces under update-issue:).

Suggested change
target: "*"
#title-prefix: "[Repo Assist] "
target: "*"
#title-prefix: "[Repo Assist] "

Copilot uses AI. Check for mistakes.
- Restatements of what the issue author already said
- Follow-ups to your own previous comments
g. **AI Disclosure**: Begin every comment with a brief disclosure, e.g.:
> ?? *This is an automated response from RepoAssist, the repository's AI assistant.*
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

Several newly added lines contain mojibake/replacement characters () and placeholder emoji markers (??). This will render poorly in GitHub and can confuse contributors; please replace with the intended punctuation (often an em dash) and replace ?? with the intended emoji (or remove emojis entirely if you want plain text). Also ensure the file is saved as UTF-8.

Suggested change
> ?? *This is an automated response from RepoAssist, the repository's AI assistant.*
> *This is an automated response from RepoAssist, the repository's AI assistant.*

Copilot uses AI. Check for mistakes.

Always do Task 10 (Update Monthly Activity Summary Issue) in addition to any other tasks you perform.

Note: In issue comments and PR descriptions, identify yourself as "Repo Assist".
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The assistant name is inconsistent (Repo Assist vs RepoAssist). To avoid confusing users (and to keep disclosures/searchability consistent), standardize on one spelling everywhere (including the disclosure template).

Copilot uses AI. Check for mistakes.
- Restatements of what the issue author already said
- Follow-ups to your own previous comments
g. **AI Disclosure**: Begin every comment with a brief disclosure, e.g.:
> ?? *This is an automated response from RepoAssist, the repository's AI assistant.*
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The assistant name is inconsistent (Repo Assist vs RepoAssist). To avoid confusing users (and to keep disclosures/searchability consistent), standardize on one spelling everywhere (including the disclosure template).

Copilot uses AI. Check for mistakes.
Comment on lines +30 to +48
create-pull-request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The safe-output keys use kebab-case (e.g., push-to-pull-request-branch, add-labels), but later instructions reference snake_case tool names (e.g., push_to_pull_request_branch, add_labels, remove_labels, update_issue). If the Repo Assist framework maps these names directly, this mismatch can prevent limits/config from applying (or cause tool calls to fail). Align the naming convention with the actual tool identifiers used by the engine (either update the safe-output keys or adjust the referenced tool names in the instructions).

Suggested change
create-pull-request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
create_pull_request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push_to_pull_request_branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create_issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update_issue:
target: "*"
#title-prefix: "[Repo Assist] "
add_labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove_labels:

Copilot uses AI. Check for mistakes.
Comment on lines +34 to +48
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The safe-output keys use kebab-case (e.g., push-to-pull-request-branch, add-labels), but later instructions reference snake_case tool names (e.g., push_to_pull_request_branch, add_labels, remove_labels, update_issue). If the Repo Assist framework maps these names directly, this mismatch can prevent limits/config from applying (or cause tool calls to fail). Align the naming convention with the actual tool identifiers used by the engine (either update the safe-output keys or adjust the referenced tool names in the instructions).

Suggested change
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
push_to_pull_request_branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update_issue:
target: "*"
#title-prefix: "[Repo Assist] "
add_labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove_labels:

Copilot uses AI. Check for mistakes.
Comment on lines +26 to +48
add-comment:
max: 10
target: "*"
hide-older-comments: true
create-pull-request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

The safe-output keys use kebab-case (e.g., push-to-pull-request-branch, add-labels), but later instructions reference snake_case tool names (e.g., push_to_pull_request_branch, add_labels, remove_labels, update_issue). If the Repo Assist framework maps these names directly, this mismatch can prevent limits/config from applying (or cause tool calls to fail). Align the naming convention with the actual tool identifiers used by the engine (either update the safe-output keys or adjust the referenced tool names in the instructions).

Suggested change
add-comment:
max: 10
target: "*"
hide-older-comments: true
create-pull-request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push-to-pull-request-branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create-issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update-issue:
target: "*"
#title-prefix: "[Repo Assist] "
add-labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove-labels:
add_comment:
max: 10
target: "*"
hide-older-comments: true
create_pull_request:
draft: true
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
push_to_pull_request_branch:
target: "*" # "triggering" (default), "*", or number
title-prefix: "[Repo Assist] "
create_issue:
title-prefix: "[Repo Assist] "
labels: [automation, repo-assist]
max: 3
update_issue:
target: "*"
#title-prefix: "[Repo Assist] "
add_labels:
allowed: [bug, enhancement, "help wanted", "good first issue", "spam", "off topic"]
max: 3 # max labels (default: 3)
target: "*" # "triggering" (default), "*", or number
remove_labels:

Copilot uses AI. Check for mistakes.
Comment on lines +15 to +17
on:
schedule: daily
workflow_dispatch:
Copy link

Copilot AI Apr 19, 2026

Choose a reason for hiding this comment

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

This file lives under .github/workflows/ and declares schedule/dispatch triggers, but it’s a .md file with custom frontmatter. GitHub Actions will not execute .md workflows, so the “runs daily” behavior will only happen if an external system specifically reads these markdown workflows. If this is intended to be driven by GitHub Actions, rename/create a .yml workflow that invokes the assistant; otherwise, add a short note in the frontmatter/heading clarifying that this is for Repo Assist (not GitHub Actions) to avoid maintainers assuming it’s active automation.

Copilot uses AI. Check for mistakes.
Introduces repo-assist.md, configuring "Repo Assist" to automate issue triage, PR management, labeling, release prep, and contributor onboarding. Defines structured, quality-focused workflows and project-specific guidelines for F#/.NET, with daily and manual run support.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Repo Assist?

2 participants