Simplified Technical English

它適合什麼工作，以及為什麼是它

當失效模式是「語意不清」時用它：操作程序、與安全相關的指示、安裝步驟，以及由非母語讀者閱讀的參考文件。它的價值在於規則可以數：句子有明確字數上限、有一張替換字詞表、還有一份要直接刪掉的詞語清單。審閱者可以拿規則來檢查產出，而不是爭論品味。

它還採取了一個多數改寫提示詞會避開的立場：拒絕用刪掉事實來縮短、拒絕更動引文、程式碼、指令與錯誤訊息，遇到缺少的值會標示出來而不是自己編一個。正因為這個立場，把它用在必須維持真實的文件上才合理。

什麼情況不該用它

不要拿它處理行銷文案、到達頁、散文，或任何「語氣本身就是工作一部分」的文字。這個技能自己也這麼說：完整套用時，規則集在設計上就會把個性磨掉；它另提供一套精簡模式，給值得保留語氣的文字使用。如果你對一個以說服為目的的頁面跑完整流程，會得到語句正確、卻推銷不了任何東西的成品。

它也不適合文學、具有法律效力的條文，或任何「措辭本身有約束力、而非描述性」的文字。受控語言存在的目的是移除解讀空間，而合約有時恰恰依賴它會移除的那層解讀。

最後，不要把名稱當成保證。它自己的文字說明，它是受該標準啟發、並非官方規範；front matter 取的是技術名稱，而不是宣稱取得認證。如果交付物必須符合真正的標準，這個技能不構成那件事的證據，跑過再多規則也一樣。

它需要什麼，以及會產出什麼

輸入是文字、檔案路徑，或「audit」加上文字。這就是完整的介面，而依你要求的不同，會產出兩種東西。改寫模式先回傳改寫後的文字，再附上一份簡短的違規清單。稽核模式只回傳違規報告，一項一行，附上違規原文與建議修改。

有兩項行為在規劃時值得注意。指令要求助理在檢視時辨認違規，但最後回覆的順序是先呈現改寫，再附上違規清單。接受修改前，請把兩者都和原文比較。指令也將引文、程式碼、指令與錯誤訊息排除在簡化範圍外。請檢查這些精確字串是否原樣保留：這是給助理的要求，不是強制執行的保護。以這些字串為主的文件，改變可能比你預期的少。

除了文字本身之外沒有前置條件：不需要網路、不需要腳本、不需要專案結構。唯一的前置條件是一位懂這個領域的讀者，因為這個技能保住事實，卻無法告訴你某句話原本描述的就是錯的事實。

工具支援、權限與相依性

已發布的紀錄把這個專案的來源查核標為 verified，而它的進入點檔案在 front matter 中放的是技術名稱，而不是相容清單。它是一份純指示文件，沒有腳本、沒有指令、沒有套件，所以工具問題只剩一個：你的代理是否會讀取技能資料夾。

它的權限需求是本目錄中最小的之一，而這正是值得一提的原因：它只需要讀取你給的文字、寫出替代版本。它不需要執行任何東西、不需要連網，也不需要碰你沒指到的檔案。唯一要留意的地方和任何改寫工作一樣：如果你交給它一個檔案路徑，代理就是在動一個真實檔案，所以動手前先決定改寫要覆蓋原檔，還是另存一份。

和「自己修」相比

一位稱職的編輯做得比這個技能多：他們會發現某一段在回答讀者根本沒問的問題，然後要你刪掉它。這個技能做不到，因為刪掉一段就等於刪掉事實，而它自己的規則禁止這麼做。所以如果你的文件太長，是因為它講了太多東西，受控語言流程只會讓它一句一句變精實，長度卻幾乎不變。

對長文件來說，一份共同規則清單能讓你在不同程序之間核對術語與句型。這是嘗試這個技能的理由，不是它勝過人工編輯或自動維持一致的證據。助理可能漏掉規則，或套用得不一致。結構與刪減由你自己判斷，再跨段落比較建議修改後才接受。

對於你在意的文字，要求稽核而不是改寫也有幫助。稽核會把違規的規則連同你自己的原句一起列出來，那是一份你可以逐行接受或拒絕的審閱。改寫則要求你一次信任一整份新文件。

如何自己驗收成果

受控語言的改寫有一種特定的失敗方式：讀起來很漂亮，卻悄悄少了一個數字、一個條件或一句警告。所以要檢查事實，而不是文筆。

• 比對改寫前後的事實數量。把原文與改寫並排，逐一標出每個數字、單位、條件與否定詞。漏掉一個否定詞是後果最嚴重的失敗。
• 確認引文、程式碼、指令與錯誤訊息逐字元相同。它們本來就應該原封不動，所以任何差異都是缺陷，不是風格選擇。
• 用稽核模式，把它剛產出的文字再跑一次。如果它對自己依同一套規則產出的文字還報出違規，代表那次處理沒有做完。
• 如果警告或指示被重新排序，確認它仍然排在它所保護的動作之前。指令先寫是一條規則；順序顛倒，正是安全指示變成危險的方式。
• 找一位沒寫過原文的人只讀成果，請他用自己的話說一次該做什麼。這裡真正要買到的是「看得懂」，而那是唯一不是替代指標的衡量方式。

來源、版本，以及實際讀過的範圍

上面這些判斷是針對本頁顯示的那個提交寫成。若該紀錄移到另一個提交，這份導讀會停止顯示，而不是繼續描述沒有人重新讀過的版本。

實際讀過的是：該提交下的專案進入點檔案，內容包含規則集、替換字詞表、各種模式、拒絕清單與授權說明。授權檔是在發布審查時讀的，而紀錄中的來源查核標示為 verified。沒有安裝或執行任何東西，沒有把任何文字送進這個技能，也沒有把產出與真實文件比對過。上面關於改寫行為的敘述，是從指示讀出來的，不是跑出來的觀察。