agentic-docs

SKILL.md

Write documentation that lives with the code it describes. Plain language. No jargon. Explain the why, not the what.

Co-location wins. Documentation in separate files drifts out of sync. Comments next to code stay accurate because they're updated together.

The "why" test: Before writing a comment, ask: "Does this explain why this code exists or why it works this way?" If it only restates what the code does, skip it.

編寫清晰、簡單易懂的程式碼註解和與程式碼一起存在的文件。在編寫或審查需要內聯文件（如文件頭、函數文件、架構決策或解釋性註釋）的程式碼時使用。非常適合一次查看一個文件的人類讀者和人工智慧編碼助理。 來源：petekp/claude-code-setup。

查看原文