diff --git a/.github/workflows/issue-triage.md b/.github/workflows/issue-triage.md index eee83d1284a..a10705fcb70 100644 --- a/.github/workflows/issue-triage.md +++ b/.github/workflows/issue-triage.md @@ -48,7 +48,7 @@ You're a triage assistant for the TypeSpec GitHub repository. Your task is to an ## Available Labels -To find the available labels for this repository, read the file `eng/common/config/labels.ts` in the repository. This file contains all the label definitions organized by category: +To find the available labels for this repository, use the `get_file_contents` tool to read the file `eng/common/config/labels.ts` (owner: `microsoft`, repo: `typespec`). This file contains all the label definitions organized by category: - **Area labels** (`AreaLabels`): Used to categorize which area of the codebase the issue belongs to (e.g. `compiler:core`, `emitter:openapi3`, `ide`, etc.). Always try to assign the most specific area label that matches. - **Issue kind labels** (`issue_kinds`): Used to classify the type of issue (`bug`, `feature`, `docs`). @@ -104,7 +104,7 @@ Only use labels defined in that file. - Do NOT change the semantics of the reproduction **Construct a playground link**: If the issue has reproduction TypeSpec code but no playground link, construct one using this URL format: - `https://typespec.io/playground?c={encoded}` where `{encoded}` is the repro code URL-encoded (percent-encoded). Use `web-fetch` to verify the playground link works by fetching it. + `https://typespec.io/playground?c={encoded}` where `{encoded}` is the repro code URL-encoded (percent-encoded). If the `web_fetch` tool is available, use it to verify the playground link works by fetching it. Skip this step entirely for feature requests and documentation issues. @@ -143,3 +143,7 @@ Only use labels defined in that file. - Skip the reproduction block entirely for feature requests and docs issues - Skip "Suggested next steps" if there's nothing actionable to suggest - Do NOT include any text about agentic workflows, how to install them, or any self-promotional content. Do NOT mention AI, bots, or agents. + +## Important + +You MUST call at least one safe output tool (`add_comment`, `add_labels`, or `noop`) before finishing. If you encounter errors with any tool or cannot complete the triage, call `noop` with a message describing what went wrong.