Skip to content

docs(instructions): beep when agent needs user input or choice - #16

Merged
oahsiao merged 1 commit into
mainfrom
docs/audible-cue-on-input
Jul 25, 2026
Merged

docs(instructions): beep when agent needs user input or choice#16
oahsiao merged 1 commit into
mainfrom
docs/audible-cue-on-input

Conversation

@oahsiao

@oahsiao oahsiao commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

What

新增互動規則:agent 在需要使用者輸入/選擇/確認、交還控制停下等待前,先用終端機發一聲短 beep,讓使用者不用盯著畫面也會注意到。

Why

按鈕確認、決策點常常使用者沒發現 agent 已在等 → 白等。加一個聽覺提示,配合既有的按鈕式確認,讓「換你了」更明顯。

How

  • copilot-instructions.md §1 新增規則:停下等待前先 beep(PowerShell [console]::beep(880,200); [console]::beep(1320,300);bash/zsh printf '\a')。
  • 屬 best-effort(視系統音效);並指出使用者可另外啟用 VS Code Accessibility Signals(設定 accessibility.signals.*,指令 Help: List Signal Sounds)取得穩定原生提示音。
  • m2_pr §6 早已有 beep,與此中央規則一致,未重複改動其他 prompt。

Impact

  • 影響範圍:僅 §1 互動規範;會同步到下游 repo。
  • Breaking change:無(純新增行為,向後相容)。
  • 版本:minor → v1.6.0(CHANGELOG 已記)。

Verification

  • python scripts/validate.py 全部通過(0 警告)
  • 本機實測 beep 可發聲(PowerShell [console]::beep
  • CI: validate

@oahsiao oahsiao added the documentation Improvements or additions to documentation label Jul 25, 2026
@oahsiao oahsiao self-assigned this Jul 25, 2026
@oahsiao
oahsiao merged commit 6e5b6bc into main Jul 25, 2026
1 check passed
@oahsiao
oahsiao deleted the docs/audible-cue-on-input branch July 25, 2026 05:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant