no-comments について
コードベースを保守するエージェント向けに、コメントをレビューして整理するスキルです。Comment Sicko に指定範囲を調査させ、結果と例外を検証したうえで根本原因を修正し、未解決事項を報告します。
主な機能
- 01指定されたファイルや差分の調査
- 02Comment Sicko サブエージェントによるレビュー
- 03指摘と例外の検証
- 04コメント削除と根本原因の修正
- 05変更内容と未解決事項の記録
活用シーン
- 01現在のコード差分にあるコメントのレビュー
- 02古いコメントやコード化できる制約の削除
- 03残すコメントの根拠の追跡
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ overextended/ skills --skill no-commentsインストール後、Claude Code で/no-commentsを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
COMMENT-SICKO.mdCREDITS.mdagents/openai.yaml詳細
コメントなし
Comment Sicko を起動します。承認された指摘に対応してください。
Comment Sicko の新鮮な視点を優先してください。
対象範囲
呼び出し元のファイルまたは差分を使用します。それ以外の場合は、デフォルトブランチ(git merge-base HEAD origin/HEAD、なければ main または master)との現在の差分を作業ツリーも含めて使用します。Git がない場合は、このセッションで変更されたファイルを使用します。
手順
- Comment Sicko という名前の
reviewサブエージェントを 1 つ起動します。~/.config/ox/models.mdのreview行を使用し、モデルとエフォートをサブエージェントツールに渡します。その行がinherit、存在しない、またはファイルの# harness行に別のハーネスが記載されている場合は、どちらも省略して、サブエージェントを現在のモデルで実行します。ファイルがない場合は、ユーザーに/setup-ox modelsの実行も提案します。サブエージェントへの指示は COMMENT-SICKO.md をそのまま貼り付けた後、対象範囲を示します。ルールを言い換えてはいけません。ハーネスにサブエージェントツールがない場合は、その旨を伝え、そのファイルを指示として自分でレビューします。 - 報告と差分を確認します。アプリケーションコードの編集、対象範囲外の変更、例外で保護された削除、誤った
MUST KILLの理由、残すべき意図的なコードを問題ありとする指摘は却下します。当プロジェクトの予期しない実装に関する指摘は、対応可能な形に整えます。それらのコメントは復元しません。残す判断は、変更できない対象についての証拠がある場合に限ります。見落とした対象範囲内の抑制指定(---@diagnostic disable、eslint-disable、@ts-ignore、@ts-expect-error)を監査します。正確性または安全性に関する抑制は、引き続き対応必須のMUST KILLとします。正確な例外と対象範囲内の根拠がある場合に限り、削除を復元します。根拠の薄いIMPORTANTやdo not removeの削除・維持を承認する前に、自分でシンボルを追跡し、呼び出し元と、コメントが追加された時期や理由をgit log -Lまたはgit blameで確認します。削除指摘が曖昧な場合は復元しません。維持が反証された場合、または依然として曖昧な場合は削除します。却下した報告は、失敗内容を明示して新しいサブエージェントに再実行させます。2 回目も却下し、未解決として報告し、no-commentsを失敗とします。 - 些細な承認済み指摘は、不要な経路の削除、パラメーターの削除、実際の API の使用によって直接修正します。修正に構造が必要な場合は、承認済み指摘と周辺コードについて一度だけ概要を作成します。データ構造と、それを変更する関数を示します。その概要を作成したら止めます。実装は手順 4 で行います。
- 対象範囲内で、根本原因を解消する最小限の修正を実装します。名前が挙がった回避策はすべて削除します。根本原因が対象範囲外にある場合は、対象範囲内で最小限の修正を適用し、残りを未解決として報告します。「根本原因の修正」と「第一原理からの再設計」の原則(
principlesを指定して Skill ツールを呼び出す)は、方針の参考にのみ使います。対象範囲を広げたり、その範囲外の事例を修正したりする根拠にはなりません。症状だけを抑えるガードを追加してはいけません。 - 制約コメントには
do not remove、do not change wording、またはtalk to X before changingと書かれています。変更できない対象についての維持指示は残します。それ以外は、対象範囲内で最も低コストな型、実行時チェック、テスト、または CI lint で制約を表現し、コメントを削除します。対象範囲内に表現方法がない場合はコメントを削除し、制約を未解決として報告し、対象範囲外で必要な作業の概要を示します。 - 削除数、復元したコメント、再実行、概要、修正、制約の表現方法、未強制の制約、その他の未解決作業を報告します。
コメント
Markdown 対応