使用唯讀 Agent 任務指令稽核失效的文件連結

開始前需要準備的事項

這是一項由您親自執行與檢查的手動稽核。Cue 負責提供語音輸入，並在您提供材料時提供選用的 Agent 協助。安裝了 Cue 並不代表 Agent 具備讀取您的儲存庫、開啟內部網路、檢索網站或編輯檔案的權限。

在開始之前，請確認具備以下所有條件：

• 已安裝 Cue 且 Dictation 功能正常。確認麥克風存取權限，以及 Cue 在該平台上要求的任何輸入或輔助使用權限。請使用 Cue「設定」中顯示的捷徑，而非在別處看到的按鍵組合。Dictation 教學涵蓋了焦點、錄音狀態與插入檢查，本指南預設您已熟悉這些操作。
• 可編輯的暫存筆記。先在暫存欄位中開始，切勿直接在 shell 提示字元或會自動發佈的文件中操作。在提交至任何地方之前，請務必先檢視任務指令。
• 一個可隨時刪除的資料夾。下方的練習將建立七個小檔案。請將它們放置於可拋棄的位置。切勿在真實儲存庫內部建立測試夾具，以免不慎執行 git add . 將其提交。
• 平時使用的終端機，或能顯示行號的文字編輯器。您可以手動檢查每個檔案；不強制需要執行 shell 指令。
• 已自行連線的 Agent。安裝的 Cue 可能會在 Agent 選取器中顯示 Cue、Claude、Codex 和 Gemini。顯示在清單中並不等於已連線、已登入、已授權或能夠讀取磁碟。在認定報告確實讀取了檔案之前，請在您自己的軟體複本中確認這一點。
• 範圍內不含任何機密資料。無憑證、權杖、私有 URL 或客戶文件。此練習完全是虛構的，因此可以在排除這些內容的情況下進行練習。

有一項決策權屬於您，而非任何 Agent：何謂失效連結。在稽核前，請先確定錨點缺失、無法存取的外部網站、大小寫不符的檔名，或是程式碼範例內的連結，在您的專案中是否算作缺陷。若缺乏這項定義，稽核產出的清單將無人能夠處理。

實作練習：Orchid Notes 文件測試夾具

Orchid Notes 是為本次練習虛構的筆記應用程式。下方的檔案皆為練習教材，非 Cue 官方文件，亦非真實專案。外部位址均使用保留的 .invalid 字尾。這並非網路沙盒：請勿擷取這些位址，並在稽核期間保持網路連線關閉。請將它們回報為未檢查，而非指定未經驗證的狀態。

建立名為 link-audit-fixture 的資料夾，並將這七個檔案放入其中。請完全依照所示的路徑存放——有數個刻意安排的缺陷取決於目錄結構配置。

index.md

# Orchid Notes documentation

Orchid Notes is a fictional note-taking app used only for this exercise.

- [Getting started](./getting-started.md)
- [Install guide](./guides/install.md)
- [Troubleshooting](./guides/troubleshooting.md)
- [API reference](./reference/api.md)
- [Uninstall guide](./guides/uninstall.md)
- [Release notes](./CHANGELOG.md)
- [Support mailbox](mailto:support@example.invalid)

![Architecture diagram](./assets/architecture.png)

getting-started.md — 請注意第 12 到 14 行是展示連結語法的圍欄程式碼區塊，而非讀者可點擊的連結：

# Getting started

Read the [install guide](./guides/Install.md) first, then open the
[API reference](./reference/api.md).

For offline setup, see [offline mode](./guides/install.md#offline-mode).

The legacy handbook lives at https://example.invalid/orchid/legacy-handbook.

Downloads are named like this in our release template:

```markdown
[Download the installer](./dist/orchid-1.2.3.dmg)
```

See [release notes]() for the full history.

CHANGELOG.md

# Release notes

## 1.2.0
Adds the sync panel. See [sync settings](./reference/api.md#sync-settings).

## 1.1.0
Fixes the export bug described in [troubleshooting](./guides/troubleshooting.md).

## 1.0.0
First release. The old notes format is documented in
[the legacy handbook](./guides/uninstall.md).

guides/install.md

# Install

## Requirements

## Desktop install

Return to the [documentation home](../index.md) or continue to the
[API reference](../reference/api.md).

If the installer fails, read [troubleshooting](./troubleshooting.md).

guides/troubleshooting.md

# Troubleshooting

## Export produces an empty file

Check the [install requirements](./install.md#requirements).

## Sync never finishes

See the [sync notes](../reference/api.md#sync-settings) and the
[status page](https://example.invalid/orchid/status).

Still stuck? Open the [support checklist](../support/checklist.md).

reference/api.md

# API reference

## Sync settings

## Export endpoint

Back to [home](../index.md).

assets/diagram.png — 建立一個帶有任意內容的預留位置檔案。檔名才重要，內容無關緊要。一行文字即可。

在執行任何操作前寫下預期的失效連結清單

這是讓這項練習發揮價值的關鍵步驟。先寫下標準解答，再檢視報告內容。若是先看報告，往往會不知不覺順從它的判斷。

預設缺陷——共出現七處，分屬六個不同的目標：

誘餌項目——絕不能出現在失效清單中的六個項目：

D-2 與 K-6 能暴露出兩種回報缺陷。若報告合併了 D-1 與 D-2 卻未保留兩處來源位置，便遺漏了需要檢視的檔案。若報告將 K-6 列為失效，則代表其為憑空猜測，或是發出了未經核准的網路請求。

口述任務指令並選擇操作途徑

1. 建立測試夾具資料夾，並將預期清單另存於別處。切勿將標準解答貼入 Agent 的情境中；這是一項測試，包含答案的任務指令將失去驗證意義。
2. 開啟空白的暫存筆記並聚焦其文字欄位。使用 Cue「設定」中的捷徑啟動 Dictation，並在說話前確認錄音狀態。
3. 口述稽核目標及其界限。內容類似：「稽核此資料夾中的 Markdown 檔案，找出指向不存在檔案或標題的連結。回報每個項目的檔案、行號及確切目標。切勿擷取任何外部位址。切勿編輯任何檔案。將任何未檢查的項目單獨列出。」使用設定好的控制項停止，等待處理完成，然後閱讀插入的文字。
4. 在文字傳送至任何地方前完成校對。路徑、副檔名、大寫字母與否定詞值得進行明確的校對檢查：變更其中一個詞彙就可能改變整項任務。請直接從來源複製 link-audit-fixture、./guides/install.md 和類似字串，而非透過口述輸入。若識別碼屢屢出錯，請參閱口述精確技術術語指南。
5. 從三種途徑中選擇一種，並清楚了解當前所用的途徑。它們無法互相替代。 直接口述至現有的 Agent。將焦點移至終端機或編輯器中編碼 Agent 的輸入框，口述或貼上校對後的任務指令。Cue 僅提供文字；該 Agent 本身的權限決定其能讀取的範圍。 在 Cue 內選取外部 Agent。若安裝的 Cue 提供 Claude、Codex 或 Gemini 作為 Agent，請先確認該途徑的連線、登入、專案及權限。切勿預設它會繼承終端機的工作目錄或先前的對話。 使用 Cue 內建的 Agent 與自選模型。Cue 的模型選取器僅用於選擇模型。它不會授予檔案存取、shell 存取或網路存取權限，也不會連線至外部 Agent。若無法確定該 Agent 是否能讀取資料夾，請改採下方的第四種途徑。
6. 手動備用方案：自行開啟六個 Markdown 檔案，並將不具敏感性的內容（連同檔名和行號）貼入 Agent。它可以審查所提供的文字，但無法僅憑貼上的內容驗證磁碟。請將產出的任何報告標註為文字檢閱，而非檔案系統稽核。
7. 比照預期清單逐一檢視報告，而非憑記憶對照測試夾具。標記各個預設缺陷為已找到或遺漏，並確認額外的聲明屬實還是捏造。
8. 完成後刪除測試夾具，或刻意將其保留，作為下次評估其他 Agent 或模型時的回歸測試教材。

複製唯讀稽核任務指令

替換括號內的欄位。在真實任務中切勿遺留預留位置文字，也不要為了讓執行成功而擴大範圍。

任務：稽核文件連結。唯讀。切勿編輯、建立、移動或刪除任何檔案。
範圍：[link-audit-fixture 的絕對路徑]，僅限 Markdown 檔案，不含其外部子目錄。
本稽核對失效的定義：
- 目標檔案不存在的相對連結或圖片
- 指向目標檔案中不存在之標題錨點的連結
- 目標為空白的連結
- 拼寫與磁碟上檔案不符的目標，包含大小寫差異
超出範圍項目，請另行條列且勿標為失效：
- 外部 http 與 https 位址。切勿發出請求。核准清單：[無]
- mailto 與 tel 連結
- 出現在圍欄程式碼區塊內的連結，該內容為範例而非真實連結
針對每項發現回報：檔案路徑、行號、原文所寫的確切連結目標、
符合上述四種分類中的哪一項，以及所採用的佐證依據。
若未開啟檔案，請註明。若屬推斷而非實質檢查，請註明。
將所有無法分類的連結列於「未檢查」區塊並說明原因。
暫時切勿提出修改建議。切勿執行任何具寫入性質的指令。切勿擷取任何外部內容。
僅需產出報告。等待我的下一步指示。

「核准清單：無」這一行是刻意為之的。本次練習沒有理由去擷取虛構的外部位址。日後針對真實外部連結進行稽核時，需要一份獨立核准的清單，以及網路存取權限受限於該清單的工具。唯讀請求仍可能洩漏位址，或連線至私有、需驗證或設有速率限制的系統；唯讀並不等同於離線。絕不可僅為了讓本次練習通過就將憑證交給 Agent。

對報告進行評分，而非僅僅閱讀

操作範例——此為模擬數據，非實際 Agent 執行紀錄：假設一份報告列出了 D-1、D-2、D-3、D-6 和 D-7，同時標記了 K-5，並將 K-6 歸於未檢查項目。這代表它找到了五個預設缺陷，遺漏了 D-4 和 D-5，並產生了一個假陽性 K-5。將 K-6 保持未檢查完全符合本次離線範圍的設定。在您自己的審查中，請將這三種分類記錄下來，而非直接接受一句簡單的「稽核完成」。

拿著 Agent 的報告與標準解答，一併進行審閱。由您填寫以下三欄：

接著比對檔案本身與稽核前儲存在 Agent 可寫範圍之外的基準版本。比較檔案清單與內容雜湊值。若在儲存庫中，請檢查 git status 和 git diff，適用時包含未追蹤與被忽略的檔案。乾淨的 Git 狀態或未改變的修改時間，皆不能證明沒有發生暫時性寫入，亦無法證明沒有讀取或傳送資料。這些檢查僅能確認最終檔案狀態；強制執行唯讀與離線界限需要工具層級的權限控制，並以調用紀錄作為輔佐證明。Agent 自稱沒有進行修改，不能作為未做修改的證據。

將發現的結果以數量進行統計：七個項目中指名了幾個，額外捏造了幾項聲明。切勿將其換算為分數、百分比或準確率數據。單一虛構資料夾中的七個預設缺陷無法支撐此類統計，而且這樣的數據容易被斷章取義地過度傳播。

遺漏 D-4 和 D-5 的報告並非毫無用處——這讓您清楚掌握了該報告的檢驗邊界。評分的意義在於了解特定 Agent 在特定途徑下實際上會檢查哪些類別，以便知道自己還需要手動檢查哪些項目。

限制條件

• 此方法僅稽核 Markdown 檔案組成的資料夾。它無法確定渲染後網站、重新導向、範本產生的連結、HTML 屬性內的連結，或是建置階段組裝之連結的狀態。這些狀況需要檢索工具以及不同層級的權限。
• 此方式完全不檢查外部連結。這是刻意設計的。虛構的 .invalid 位址始終保持未檢查；其保留字尾不能證明工具有沒有發出網路請求。另外進行真實連結稽核時需要另定核准範圍。
• 稽核結果乾淨並不代表文件內容無誤。連結可能指向錯誤的頁面，而頁面雖然存在卻可能早已過期。連結是否存在是最容易測試的屬性，但絕非最關鍵的屬性。
• 文字搜尋不等於 Markdown 剖析器。單純的搜尋可能會將圍欄內的範例誤報為失效連結，並遺漏純文字 URL 或參照樣式的連結。在將符合項目視為缺陷前，請先查核文件渲染器的規則。
• 檔案系統行為各有不同。D-4 的檔案存在檢查取決於本機檔案系統是否區分大小寫。同一項稽核在 Mac 與 Linux CI 執行器上的結果可能存在合理的差異。
• 此處並未驗證任何內建的連結檢查器。這套方法著重於透過語音擷取稽核任務指令並界定 Agent 的作業範圍，而非盤點 Cue 的功能。特定 Agent 究竟能否讀取您的資料夾，必須在安裝的版本中親自確認。
• 單一測試夾具僅為單一樣本。在此處評分優異，並不代表在大型真實儲存庫、不同模型或不同操作途徑下具備相同的行為表現。

步驟出錯時的復原方式

若 Cue 本身發生問題，請使用聯絡 Cue 技術支援，並附上您的平台、Cue 版本、模式以及去除敏感資訊的範例。切勿傳送私有文件、儲存庫內容或權杖。

在擴大規模前值得思考的問題

為何要先埋入缺陷，而不直接在真實文件上執行？ 在不熟悉的文件上，「未發現任何問題」可能掩蓋了「根本未進行檢查」的事實。測試夾具能在執行前提供已知答案；而真實儲存庫仍需自行進行涵蓋範圍檢查。

評分一次後是否該保留測試夾具？ 保留夾具成本低廉，且每當更換模型、Agent 或操作途徑時皆能派上用場。請將其保留在任何會公開的儲存庫之外，並將標準解答存放在同一處，避免兩者內容脫節。

可以直接要求 Agent 修復失效連結嗎？ 修復屬於獨立且需額外授權的任務，具備自身的審查流程，而且這些缺陷大多不只一種正確修法。uninstall.md 的處理方式可能是補寫遺失頁面、移除連結，或是將其導向別處——這屬於編輯決策。應先對稽核結果評分，其次提出修復建議，最後由您親自套用修復。

應該使用哪種模型？ 請從該途徑實際上能讀取什麼開始評估，而非僅看模型名稱。沒有檔案存取權限的模型應主動揭露該限制。然而，它可能會針對從未開啟的檔案產出看似合理的報告；此練習有助於揭露這類問題。如實回報「未檢查」的模型雖未完成稽核，但至少沒有捏造結果。

資料來源與相關工作流程

上述測試夾具、其缺陷以及示範的 Agent 行為均為練習材料。本指南的任何部分皆未宣稱 Cue 或任何 Agent 的實測效能數據。此發布版本採用手動檢查練習，而非可執行的連結檢查指令碼。所安裝的 Cue 版本、其可見控制項以及 Agent 的權限，優先於此處記述的任何內容。

• Cue Dictation 教學：焦點、錄音狀態與插入檢查。
• Cue Voice Agent 教學：明確情境與行動前的審查作業。
• 搭配編碼 Agent 使用 Cue：口述至工具、選取外部 Agent，以及使用 Cue 的 Agent 搭配自選模型之間的差異。
• 使用 Codex 審查程式碼變更：將相同的佐證嚴謹度套用於 diff 比較，而非文件目錄樹。
• 口述精確技術術語：保持路徑、版本與識別碼完整無誤。
• 將選定情境轉化為完成的任務：當稽核產出您打算落實的後續工作時該如何處理。