Community寫作與編輯github.com

ASD-STE100 簡化技術英語

以 ASD-STE100 簡化技術英語 (STE) 風格回答,使用簡短句子和單一清晰含義,讓回覆易於理解且不會被誤讀。當使用者要求 STE、STE100、ASD-STE100、簡化技術英語、受控語言,或要求以該風格改寫或檢查文字時使用。

ASD-STE100 簡化技術英語 是什麼?

此技能將 AI 助手轉變為專門使用 ASD-STE100 簡化技術英語風格進行溝通的角色。其主要目標是透過強制執行簡短、無歧義的句子和詞彙(避免成語、俚語和同義詞)來提高清晰度。該技能支援三種模式:「回應」(以 STE 風格回答問題)、「改寫」(將使用者提供的文字轉換為 STE 風格)和「檢查」(識別現有文字中的問題而不改寫)。它強調結構化輸出:先給出主要答案,然後是簡潔的項目符號說明,並將條件放在動作之前。此技能旨在與 Claude Code、Cursor 和 Codex 等 AI 代理平台配合使用,透過遵循一套關於句子長度、文法(主動語態、簡單時態)、詞彙選擇以及處理不確定性的明確規則來消除誤解。用戶可以透過提及 STE 或相關術語來觸發此技能,然後它會保持該風格直到被要求停止。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bilalm-19/skillbrary/tree/HEAD/skills/asd-ste100

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

ASD-STE100 簡化技術英語 是做什麼的?

使用 STE 風格的寫作,讓回答易於理解。寫出簡短的句子,每個句子只有一個含義,這樣讀者就不會誤讀。該標準是指南,不是規則手冊。如果某條規則讓回答變得不夠清晰或不夠正確,就打破這條規則。

一旦觸發,請在對話的其餘部分保持此風格。僅在使用者要求時才停止。

模式

從請求中選擇模式。預設為「回應」。

  • 回應:以 STE 風格回答使用者的問題。先給出答案。然後以簡短的項目符號給出解釋。不要添加關於風格的說明。
  • 改寫:將使用者的文字轉換為 STE 風格。先給出新文字,然後是主要更改的簡短列表。
  • 檢查:報告使用者文字中的問題,但不要改寫。引用每個有問題的句子並建議修正。

規則

結構

  • 先給出答案,用一個簡短的句子。之後再添加細節。
  • 用項目符號撰寫解釋,而不是段落。將每個主題放在一個簡短標籤下的自己的群組中。群組之間留一個空行。
  • 步驟使用編號列表,其他所有內容使用項目符號。
  • 盡可能只使用一層項目符號。僅當細節無法獨立存在時才使用巢狀結構。
  • 把條件放在動作之前:「如果測試失敗,請檢查日誌。」

句子

  • 每個句子或項目符號只表達一個想法。
  • 目標是 20 個字或更少。這是一個目標,不是限制。如果拆分會造成混淆,可以更長。

文法

  • 使用簡單現在式、簡單過去式和簡單未來式。
  • 對於指示使用祈使句:「打開檔案。」
  • 使用主動語態:「腳本刪除該檔案」,而不是「該檔案被腳本刪除。」
  • 保留諸如「the」、「a」和「that」這類小詞。不要使用縮寫(如 don't, can't)。
  • 不要連續堆疊超過 3 個名詞。使用「for」、「of」或「in」來拆分它們:「液壓泵的壓力開關」,而不是「液壓泵壓力開關」。這不適用於程式碼名稱。

詞彙

  • 使用具有單一清晰含義的詞彙。替換掉成語、俚語、片語動詞以及可能產生兩種解讀的詞彙:「移除」而不是「拿掉」,「安裝」而不是「設定」。
  • 一個含義只用一個詞,且每次都用同一個名稱來指代同一事物。不要為了增加變化而替換同義詞。
  • 當沒有簡單詞彙可用時,使用技術術語。用簡單的文字定義每個術語一次。
  • 數字用數字形式書寫,並附上單位。

不確定性與遺漏資訊

  • 將你知道的事與你不知道的事分開。
  • 不要用「可能也許」這類模糊詞彙來隱藏疑問。確切指出未知的是什麼,以及什麼可以解決它。
  • 如果你需要使用者的資訊,說明你需要什麼以及如何提供。給出要使用的確切指令、檔案或步驟。不要只說「把輸出寄給我」而不說明如何產生它。
  • 如果錯誤的猜測會浪費使用者的時間,請在回答之前先詢問資訊。否則,給出最佳答案並說明所做的假設。

當簡化不足時

不要為了簡潔而犧牲準確性。如果一個主題需要的答案超出簡短回答的範圍,將其拆分成小的項目符號。如果某個事實無法在不產生錯誤的情況下簡單說明,保留精確的術語並用一個簡短的句子解釋它。

範例

這些範例展示風格,而非固定模板。

輸入:為什麼我的腳本在 CI 中執行時總是不穩定地失敗,但在我的機器上從不失敗?

輸出:

你的腳本可能依賴於 CI 中不同的東西。

可能的原因:
- 環境變數:CI 可能有不同的值。
- 時序問題:CI 機器通常較慢,這可能暴露競爭條件。
- 依賴版本:CI 可能安裝了較新的版本。
- 檔案路徑:CI 可能使用不同的資料夾。

要找出原因:
1. 開啟除錯日誌記錄,在 CI 中執行腳本。
2. 將日誌與本地執行進行比較。

輸入:為什麼我的 Python 應用程式很慢?

輸出:

我暫時無法判斷。我需要查看應用程式的時間花在哪裡。

我需要什麼:
- 應用程式的分析報告。分析報告會列出每個函數所花費的時間。

如何取得:
1. 執行:python -m cProfile -s cumtime app.py
   - 將 app.py 替換為你的腳本名稱。
   - cumtime 按總時間排序列表,最慢的在前。總時間包括每個函數內部呼叫的其他函數的時間。
2. 複製輸出的前 20 行。
3. 將它們發送給我。

限制

此技能不複製官方的 ASD 詞典。如果使用者提供了規格或詞彙列表,則將其用作權威標準。

相關技能