Skip to content

Commit 9a2b7ce

Browse files
fix: make safe output tool call mandatory in Tutorial Update Monitor prompt
Agent-Logs-Url: https://github.com/instil/github-copilot-tutorial/sessions/70ece2c6-7c9f-4d7e-be4a-2bb116fa965c Co-authored-by: calebwilson706 <71669491+calebwilson706@users.noreply.github.com>
1 parent 7e161cb commit 9a2b7ce

6 files changed

Lines changed: 17 additions & 52 deletions

File tree

.github/workflows/tutorial-update-monitor.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,10 +79,14 @@ Use the GitHub tool to list recent commits (last 14 days) from `github/copilot-c
7979
- Suggested changes or new content to add
8080
- Do **not** create an issue if a similar one already covers this topic in any state
8181

82+
6. **REQUIRED — you must always finish by calling exactly one of these safe output tools:**
83+
- Call `create_issue` for each new finding that passed the duplicate check (up to 5 issues)
84+
- Call `noop` if all findings were duplicates or no meaningful changes were found — include a brief summary of what was checked
85+
8286
## Guidelines
8387

8488
- Only create issues for **meaningful changes** that affect tutorial accuracy or completeness. Skip cosmetic or unrelated changes.
85-
- If no updates are found, call the `noop` tool with a brief summary of what was checked and confirming no updates were needed.
89+
- **You must always call at least one safe output tool** (`create_issue` or `noop`) before finishing. Finishing without calling either is an error.
8690
- Group closely related changes into a single issue when it makes sense.
8791
- Be specific and actionable in issue descriptions so maintainers can address them quickly.
8892
- Limit to **5 issues per run** to avoid noise.

tutorial/lessons/08-planning-mode.md

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -36,12 +36,6 @@ There are two ways:
3636

3737
Look at the bottom of your terminal to see which mode you're in. Just keep pressing Shift+Tab until you see the plan mode indicator.
3838

39-
> **Note on Autopilot Mode:** When using Autopilot Mode, Copilot limits itself to 5 continuation messages by default to prevent unbounded autonomous execution. You can adjust this limit with the `--max-autopilot-continues` flag when launching Copilot:
40-
> ```
41-
> copilot --max-autopilot-continues 10
42-
> ```
43-
> This safety default means Autopilot Mode will pause and wait for your input after 5 steps in a longer task.
44-
4539
**`/plan` command** — You can also type `/plan` followed by your prompt:
4640

4741
```

tutorial/lessons/14-session-management.md

Lines changed: 5 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -29,18 +29,6 @@ Each session has a unique ID. You can resume a specific session by ID:
2929

3030
---
3131

32-
### Session history with `/chronicle`
33-
34-
**`/chronicle`** — Review a structured history of your session, including which files were read or edited and when:
35-
36-
```
37-
/chronicle
38-
```
39-
40-
This shows a timeline of file interactions during your session — useful for understanding what Copilot accessed and in what order. It's especially helpful when you want to audit a long session or hand off context to a colleague.
41-
42-
---
43-
4432
### Context compression
4533

4634
As conversations grow, the context window fills up. Copilot handles this automatically — at 95% token capacity, it auto-compacts the conversation to make room. But you can also manage it manually:
@@ -127,22 +115,20 @@ Sometimes it's better to start over than to correct course:
127115

128116
1. Try `/context` to see your token usage visualisation
129117
2. Try `/usage` to see your session statistics
130-
3. Try `/chronicle` to see a timeline of files accessed in this session
131-
4. Think about when you'd use `--continue` vs `/resume`:
118+
3. Think about when you'd use `--continue` vs `/resume`:
132119
- `--continue`: "I closed my terminal but want to pick up exactly where I left off"
133120
- `/resume`: "I have several ongoing sessions and want to choose which one to revisit"
134-
5. If your context feels long, try `/compact "Focus on the current lesson"`
121+
4. If your context feels long, try `/compact "Focus on the current lesson"`
135122

136123
---
137124

138125
## Hints
139126

140127
1. `/context` shows a visual breakdown — it's the quickest way to understand your token budget
141128
2. `/usage` gives you raw session stats
142-
3. `/chronicle` shows a timeline of files accessed in this session — useful for auditing what Copilot read or wrote
143-
4. `/compact` is your friend for long sessions — it summarises without losing the thread
144-
5. `/restart` reloads the CLI without clearing your conversation — useful when the CLI feels buggy or after changing config
145-
6. This is about building habits: use `/clear` between tasks, `/compact` when sessions get long, `/restart` when the CLI misbehaves, and `/resume` to pick up where you left off
129+
3. `/compact` is your friend for long sessions — it summarises without losing the thread
130+
4. `/restart` reloads the CLI without clearing your conversation — useful when the CLI feels buggy or after changing config
131+
5. This is about building habits: use `/clear` between tasks, `/compact` when sessions get long, `/restart` when the CLI misbehaves, and `/resume` to pick up where you left off
146132

147133
---
148134

tutorial/lessons/15-programmatic-mode.md

Lines changed: 0 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -28,20 +28,6 @@ cat error.log | copilot -p "explain this error and suggest a fix" > summary.txt
2828
git diff main | copilot -p "review these changes for bugs"
2929
```
3030

31-
### Attaching files and images
32-
33-
In non-interactive mode, use `--attachment` to pass images or documents alongside your prompt:
34-
35-
```bash
36-
copilot -p "describe the UI shown in this screenshot" --attachment screenshot.png
37-
```
38-
39-
```bash
40-
copilot -p "review the architecture described in this diagram" --attachment architecture.pdf
41-
```
42-
43-
This enables CI/automation workflows that include visual content — for example, screenshot regression checks or automated design review pipelines. You can include multiple `--attachment` flags in a single command.
44-
4531
### Scoping permissions
4632

4733
When running in automation, lock down what Copilot can do:

tutorial/lessons/16-model-selection.md

Lines changed: 6 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,9 @@ Copilot CLI supports multiple AI models, each with different strengths:
1212

1313
| Model | Best for |
1414
|-------|----------|
15-
| **Claude Opus 4.5** (default) | Complex reasoning, architectural work, thorough analysis |
16-
| **Claude Sonnet 4.5** | Daily coding tasks, good balance of speed and quality |
17-
| **GPT-5.2 Codex** | Code generation, broad knowledge |
18-
19-
In addition to specific models, Copilot CLI offers an **Auto** mode that uses server-side model routing to automatically select the best model for each request in real time. This can give you better results without you having to manually switch models.
15+
| **Claude Sonnet 4.6** (default) | Daily coding tasks, good balance of speed and quality |
16+
| **Claude Opus 4.6** | Complex reasoning, architectural work, thorough analysis |
17+
| **GPT-5** | Code generation, broad knowledge |
2018

2119
### Switching models
2220

@@ -77,10 +75,9 @@ This creates a `.github/copilot-instructions.md` file with sensible defaults bas
7775
1. Try `/model` to see what models are available and how to switch between them
7876
2. Try `/theme` to see available visual themes
7977
3. Think about when you'd switch models:
80-
- Working on a quick bug fix? Stay on Sonnet 4.5
81-
- Designing a complex architecture? Switch to Opus 4.5
82-
- Want a different perspective on an approach? Try GPT-5.2 Codex
83-
- Not sure which model to use? Try **Auto** mode and let Copilot decide
78+
- Working on a quick bug fix? Stay on Sonnet 4.6
79+
- Designing a complex architecture? Switch to Opus 4.6
80+
- Want a different perspective on an approach? Try GPT-5.3 Codex
8481

8582
## Hints
8683

tutorial/lessons/18-working-with-images.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,6 @@ How to use images with Copilot CLI — debugging from screenshots, implementing
1313
| **Drag and drop** | Drag an image file into the terminal | Quick one-off references |
1414
| **Paste** | `Ctrl+V` (or `Cmd+V` on Mac) | Screenshots you just captured |
1515
| **File path** | Reference the image path with `@` in your prompt | Images already in your project |
16-
| **`--attachment` flag** | `copilot -p "..." --attachment image.png` | CI/automation and non-interactive mode |
1716

1817
### Common use cases
1918

@@ -49,8 +48,7 @@ Option C — Just read:
4948

5049
1. The easiest approach: take a screenshot of this terminal right now (`Cmd+Shift+4` on Mac, `Win+Shift+S` on Windows), then paste it into Copilot and ask "what do you see?"
5150
2. Copilot can read most common image formats: PNG, JPG, GIF, WebP
52-
3. For CI/automation scripts, use `--attachment` with the `-p` flag: `copilot -p "describe this" --attachment image.png`
53-
4. This is about knowing the capability exists — you'll use it naturally when you encounter a visual debugging situation
51+
3. This is about knowing the capability exists — you'll use it naturally when you encounter a visual debugging situation
5452

5553
## Completion Criteria
5654

0 commit comments

Comments
 (0)