結論

描述系統行為時，使用「信號」「提醒」「觀測」等中性詞，避免「承認」「暴露」「證明了失敗」等歸因詞。工程上的信號是指向可改善之處的指標，不是對過去決策的道德判定。

案例

版本語句問題
修正前「每一個『寫文件提醒』都是承認『工具沒做到位』的信號」「承認」是歸因詞——暗示設計者做錯了、需要認錯
修正後「每一個『寫文件提醒』都是一個信號——工具的預設行為還有空間改善」「信號」是觀測詞——指向改善方向，不判定對錯

兩句話指向相同的行動（評估能否把提醒轉化為工具預設行為），但讀者的接收姿態不同。「承認」讓讀者進入防禦模式（「我的工具沒做錯，文件有文件的用途」）；「信號」讓讀者進入改善模式（「確實，這個文件提醒可以被工具化」）。

判斷標準

寫完一句帶有歸因意味的描述後，問：這句話在描述事實，還是在分配責任？

  • 事實：「文件提醒的存在表示工具的預設行為有改善空間」
  • 歸因：「文件提醒的存在承認了工具沒做到位」

如果描述的目的是引導讀者改善，用事實語氣。歸因語氣適合事故報告（需要追溯責任），不適合技術分享（目的是傳遞改善思路）。

延伸

同類歸因詞在技術寫作中常見的變體：

歸因詞中性替代差異
承認表示、反映「承認」有認錯語意
暴露了顯示出「暴露」暗示刻意隱藏
證明了失敗顯示有改善空間「失敗」是終結判定
被迫選擇、改為「被迫」暗示無奈而非決策（描述外部強制約束時可保留）