check-your-own-work

# check-your-own-work — 交出去之前，先對一次自己寫的東西 **這不是一道閘。** 它不回 PASS／FAIL，也不阻止任何後續動作。它產出一份 finding 清單， 而那份清單的價值完全來自**它在同一輪裡被處置掉**——一份沒有人動的報告，跟沒有報告一樣。 六問不是想出來的。它們是從 829 則真人 review 意見逆推出來的六類反覆缺陷，而其中四類 **完全不需要任何領域知識就避得掉**：它們是「我沒有把自己剛寫的東西跟自己剛寫的宣稱對一次」， 不是「我不知道這個框架怎麼寫」。 ## 先把材料撈出來 ```bash bash .claude/skills/check-your-own-work/scripts/collect-self-check-inputs.sh bash .claude/skills/check-your-own-work/scripts/collect-self-check-inputs.sh --repo <path> --base <ref> --pr <number> ``` 三個參數都可以不給：repo 預設是當下的目錄，base 自己去問 `origin/HEAD`（問不到就依序試 `main`／`master`／`develop`），PR 自己去問 `gh`。**它唯讀，不對外寫入任何東西。** 它逐問印出那一問需要的輸入，**拿不到的那幾問指名說出為什麼拿不到**，最後印 `ANSWERABLE: n/6`。這一行是整支腳本存在的理由：一份只答了兩問的自檢，讀起來跟答滿六問的 一模一樣，所以它要說出自己少了哪幾問。 **答不出不是通過。** 沒有 `gh`、沒有 PR、沒有上一輪意見、這個 repo 一份規範都沒有、diff 是空的——這五種都是常態，不是錯誤，但它們各自代表「這一問沒有答案」，不代表「這一問沒事」。 ## 六問 ### 一、我寫下的每一句宣稱，在 diff 裡都找得到對應的改動嗎 宣稱不只是 PR 描述。commit message、changeset、註解、docstring、型別宣告、變數名——**每一句 描述性的話都是產出的一部分，不是旁白**。它對讀的人承諾了某件事，而承諾與行為是分開演化的： 先寫下承諾，做的過程中改了做法，然後沒有回頭改那句話。 沒有東西會紅。編譯器不看，測試不看，只有下一個依它行事的人會踩到。 標本：四個 PR 各自宣稱有一組 harness 檔案，那些檔案不在 diff 裡；同時各帶一個宣告某個套件 要發版的 changeset，而那個套件一行都沒動。 ### 二、我碰到的這些檔案類型，這個 repo 自己的規範說了什麼 **從 repo 現場讀，不從記憶讀。** 腳本會把它找到的規範檔逐份列出來——去讀它們。 兩件事讓「憑記憶」特別危險： - **規範會翻面。** 同一份檔案上個月說 A，這個月改成 B，而記得舊版本的人不會發現自己記錯了。 - **被違反的正好是已經寫下來的那些。** 量到的第 2 類缺陷裡，reviewer 引用的就是這個 repo 自己的規範檔——引用它的是 reviewer，不是作者。 一份規範都找不到時，那不是「沒有規矩」，是「規矩沒有寫下來」——去讀鄰近的既有程式碼。 ### 三、這個修法是不是一個 pattern 把這次的修法講成一句話，然後 **grep 整棵樹找同型的地方**，說出還有幾處、以及為什麼那幾處 不改。腳本印的「同目錄還有幾個同副檔名」是一...